Adding upstream version 4:7.4.7.upstream/4%7.4.7upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 135 insertions, 0 deletions

diff --git a/offapi/com/sun/star/table/AccessibleTableView.idl b/offapi/com/sun/star/table/AccessibleTableView.idl
new file mode 100644
index 000000000..834436882
--- /dev/null
+++ b/offapi/com/sun/star/table/AccessibleTableView.idl
@@ -0,0 +1,135 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This file incorporates work covered by the following license notice:
+ *
+ *   Licensed to the Apache Software Foundation (ASF) under one or more
+ *   contributor license agreements. See the NOTICE file distributed
+ *   with this work for additional information regarding copyright
+ *   ownership. The ASF licenses this file to you under the Apache
+ *   License, Version 2.0 (the "License"); you may not use this file
+ *   except in compliance with the License. You may obtain a copy of
+ *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
+ */
+#ifndef __com_sun_star_table_AccessibleTableView_idl__
+#define __com_sun_star_table_AccessibleTableView_idl__
+
+#include <com/sun/star/accessibility/XAccessibleContext.idl>
+#include <com/sun/star/accessibility/XAccessibleComponent.idl>
+#include <com/sun/star/accessibility/XAccessibleTable.idl>
+#include <com/sun/star/accessibility/XAccessibleSelection.idl>
+#include <com/sun/star/accessibility/XAccessibleEventBroadcaster.idl>
+
+
+
+module com {  module sun {  module star {  module table {
+
+
+/** The accessible view of a table in a text document or in the page preview
+      of a spreadsheet document. See
+    ::com::sun::star::sheet::AccessibleSpreadsheet for
+    tables in the edit view of a spreadsheet.
+    @since OOo 1.1.2
+*/
+service AccessibleTableView
+{
+    /** This interface gives access to any table cell that is contained in
+          a table fragment that is at least partially visible. A table fragment
+        is the part of a table that is displayed at a single page.
+
+    <ul>
+        <li>The parent returned by
+            ::com::sun::star::accessibility::XAccessibleContext::getAccessibleParent()
+            is the accessible text document view, a page of the accessible
+            text document page preview, or the accessible spreadsheet
+            page preview.</li>
+        <li>The children returned by
+            ::com::sun::star::accessibility::XAccessibleContext::getAccessibleChild()
+            all support the interface XAccessible. Calling
+            ::com::sun::star::accessibility::XAccessible::getAccessibleContext()
+            for these children
+            returns an object that supports the service.
+            ::com::sun::star::table::AccessibleCellView:
+            A child where calling
+            ::com::sun::star::accessibility::XAccessibleContext::getAccessibleChild()
+            an object that supports this service is returned for
+            every partially visible cell in this table.
+        <p>The following rules apply to the children order.</p>
+        <ul>
+            <li>All the children are cells. The order of this cells is to
+            the order on the screen. This means that the first cell is the
+            cell in the left top edge of the table and the last one is the
+            cell in the right bottom edge of the table. The second is the
+            cell in the first row and second column and so on.</li>
+        </ul>
+        <li>The description is ???.</li>
+        <li>The name is the given table name and a number to make it non-ambiguous.</li>
+        <li>The role is
+            ::com::sun::star::accessibility::AccessibleRole::TABLE</li>
+        <li>In a spreadsheet page preview there are relations between the
+            table and the shapes with an anchor
+            on this table (not with an anchor on a cell in this table).</li>
+        <li>The following states are supported:
+            <ul>
+                <li>::com::sun::star::accessibility::AccessibleStateType::DEFUNC
+                    is always false if the
+                    table is not deleted, the document is open. Also it is
+                    false if the table was showed in a page preview and the
+                    page preview is already opened, otherwise it is true.</li>
+                <li>::com::sun::star::accessibility::AccessibleStateType::EDITABLE
+                    is false if the
+                    table is showed in a page preview or the table is
+                    protected, otherwise it is true.</li>
+                <li>::com::sun::star::accessibility::AccessibleStateType::ENABLED
+                    is always true.</li>
+                <li>::com::sun::star::accessibility::AccessibleStateType::MULTI_SELECTABLE
+                    is false
+                    if the table is showed in a page preview, otherwise it is
+                    true.</li>
+                <li>::com::sun::star::accessibility::AccessibleStateType::OPAQUE
+                    is false, if the table
+                    has no background color or graphic, otherwise it is
+                    false.</li>
+                <li>::com::sun::star::accessibility::AccessibleStateType::SHOWING
+                    is true if the
+                    Bounding Box lies in the Bounding Box of the parent.
+                    Otherwise it is false.</li>
+                <li>::com::sun::star::accessibility::AccessibleStateType::VISIBLE
+                    is always true.</li>
+            </ul>
+        </li>
+    </ul>
+
+     */
+    interface ::com::sun::star::accessibility::XAccessibleContext;
+
+    /** This interface gives access to the visibility of the document.
+    */
+    interface ::com::sun::star::accessibility::XAccessibleComponent;
+
+    /** This interface gives access to any cell that is at least partially
+        visible on the screen. So this interface gives access to the same
+        things like the XAccessibleContext interface. Therefore it use more
+        usable methods. Also it gives access to some table specific data.
+     */
+    interface ::com::sun::star::accessibility::XAccessibleTable;
+
+    /** This interface is for selecting the cells. This interface is optional.
+     */
+    [optional] interface ::com::sun::star::accessibility::XAccessibleSelection;
+
+    /** This is the interface for listeners */
+    interface ::com::sun::star::accessibility::XAccessibleEventBroadcaster;
+};
+
+
+}; }; }; };
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */