include/vcl/accessibletableprovider.hxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19
  20 #ifndef INCLUDED_VCL_ACCESSIBLETABLEPROVIDER_HXX
  21 #define INCLUDED_VCL_ACCESSIBLETABLEPROVIDER_HXX
  22
  23 #include <vcl/AccessibleBrowseBoxObjType.hxx>
  24 #include <vcl/window.hxx>
  25 #include <cppuhelper/implbase.hxx>
  26 #include <com/sun/star/accessibility/XAccessible.hpp>
  27
  28 namespace vcl
  29 {
  30
  31 #define OFFSET_DEFAULT  (sal_Int32(-1))
  32 #define OFFSET_NONE     (sal_Int32(0))
  33
  34 enum AccessibleTableChildIndex
  35 {
  36     /** Child index of the column header bar (first row). Exists always. */
  37     BBINDEX_COLUMNHEADERBAR = 0,
  38     /** Child index of the row header bar ("handle column"). Exists always. */
  39     BBINDEX_ROWHEADERBAR    = 1,
  40     /** Child index of the data table. */
  41     BBINDEX_TABLE           = 2,
  42     /** Child index of the first additional control. */
  43     BBINDEX_FIRSTCONTROL    = 3
  44 };
  45
  46
  47 /** This abstract class provides methods to implement an accessible table object.
  48 */
  49 class IAccessibleTableProvider
  50 {
  51 public:
  52     /** @return  The count of the rows. */
  53     virtual sal_Int32               GetRowCount() const = 0;
  54     /** @return  The count of the columns. */
  55     virtual sal_uInt16              GetColumnCount() const = 0;
  56
  57     /** @return  The position of the current row. */
  58     virtual sal_Int32               GetCurrRow() const = 0;
  59     /** @return  The position of the current column. */
  60     virtual sal_uInt16              GetCurrColumn() const = 0;
  61
  62     /** @return  The description of a row.
  63         @param _nRow The row which description is in demand. */
  64     virtual OUString         GetRowDescription( sal_Int32 _nRow ) const = 0;
  65     /** @return  The description of a column.
  66         @param _nColumn The column which description is in demand. */
  67     virtual OUString         GetColumnDescription( sal_uInt16 _nColumnPos ) const = 0;
  68
  69     /** @return  <TRUE/>, if the object has a row header. */
  70     virtual bool                    HasRowHeader() const = 0; //GetColumnId
  71     virtual bool                    GoToCell( sal_Int32 _nRow, sal_uInt16 _nColumnPos ) = 0;
  72
  73     virtual void                    SetNoSelection() = 0;
  74     virtual void                    SelectAll() = 0;
  75     virtual void                    SelectRow( sal_Int32 _nRow, bool _bSelect = true, bool bExpand = true ) = 0;
  76     virtual void                    SelectColumn( sal_uInt16 _nColumnPos, bool _bSelect = true ) = 0;
  77     virtual sal_Int32               GetSelectedRowCount() const = 0;
  78     virtual sal_Int32               GetSelectedColumnCount() const = 0;
  79     /** @return  <TRUE/>, if the row is selected. */
  80     virtual bool                    IsRowSelected( sal_Int32 _nRow ) const = 0;
  81     virtual bool                    IsColumnSelected( sal_Int32 _nColumnPos ) const = 0;
  82     virtual void                    GetAllSelectedRows( css::uno::Sequence< sal_Int32 >& _rRows ) const = 0;
  83     virtual void                    GetAllSelectedColumns( css::uno::Sequence< sal_Int32 >& _rColumns ) const = 0;
  84
  85     /** @return  <TRUE/>, if the cell is visible. */
  86     virtual bool                    IsCellVisible( sal_Int32 _nRow, sal_uInt16 _nColumnPos ) const = 0;
  87     virtual OUString                GetAccessibleCellText( sal_Int32 _nRow, sal_uInt16 _nColumnPos ) const = 0;
  88
  89     virtual tools::Rectangle               calcHeaderRect( bool _bIsColumnBar, bool _bOnScreen = true ) = 0;
  90     virtual tools::Rectangle               calcTableRect( bool _bOnScreen = true ) = 0;
  91     virtual tools::Rectangle               GetFieldRectPixel( sal_Int32 _nRow, sal_uInt16 _nColumnPos, bool _bIsHeader, bool _bOnScreen ) = 0;
  92
  93     virtual css::uno::Reference< css::accessibility::XAccessible > CreateAccessibleCell( sal_Int32 _nRow, sal_uInt16 _nColumnPos ) = 0;
  94     virtual css::uno::Reference< css::accessibility::XAccessible > CreateAccessibleRowHeader( sal_Int32 _nRow ) = 0;
  95     virtual css::uno::Reference< css::accessibility::XAccessible > CreateAccessibleColumnHeader( sal_uInt16 _nColumnPos ) = 0;
  96
  97     virtual sal_Int32               GetAccessibleControlCount() const = 0;
  98     virtual css::uno::Reference< css::accessibility::XAccessible >                    CreateAccessibleControl( sal_Int32 _nIndex ) = 0;
  99     virtual bool                    ConvertPointToControlIndex( sal_Int32& _rnIndex, const Point& _rPoint ) = 0;
 100
 101     virtual bool                    ConvertPointToCellAddress( sal_Int32& _rnRow, sal_uInt16& _rnColPos, const Point& _rPoint ) = 0;
 102     virtual bool                    ConvertPointToRowHeader( sal_Int32& _rnRow, const Point& _rPoint ) = 0;
 103     virtual bool                    ConvertPointToColumnHeader( sal_uInt16& _rnColPos, const Point& _rPoint ) = 0;
 104
 105     virtual OUString                GetAccessibleObjectName( AccessibleBrowseBoxObjType _eType, sal_Int32 _nPos = -1 ) const = 0;
 106     virtual OUString                GetAccessibleObjectDescription( AccessibleBrowseBoxObjType _eType, sal_Int32 _nPos = -1 ) const = 0;
 107
 108     virtual void                    FillAccessibleStateSet( sal_Int64& _rStateSet, AccessibleBrowseBoxObjType _eType ) const = 0;
 109     virtual void                    FillAccessibleStateSetForCell( sal_Int64& _rStateSet, sal_Int32 _nRow, sal_uInt16 _nColumnPos ) const = 0;
 110     virtual void                    GrabTableFocus() = 0;
 111
 112     // OutputDevice
 113     virtual bool                    GetGlyphBoundRects( const Point& rOrigin, const OUString& rStr, int nIndex, int nLen, std::vector< tools::Rectangle >& rVector ) = 0;
 114
 115     // Window
 116     virtual AbsoluteScreenPixelRectangle GetWindowExtentsAbsolute() const = 0;
 117     virtual tools::Rectangle        GetWindowExtentsRelative(const vcl::Window& rRelativeWindow) const = 0;
 118     virtual void                    GrabFocus() = 0;
 119     virtual css::uno::Reference< css::accessibility::XAccessible > GetAccessible() = 0;
 120     virtual vcl::Window*                 GetAccessibleParentWindow() const = 0;
 121     virtual vcl::Window*                 GetWindowInstance() = 0;
 122
 123     virtual tools::Rectangle               GetFieldCharacterBounds(sal_Int32 _nRow,sal_Int32 _nColumnPos,sal_Int32 nIndex) = 0;
 124     virtual sal_Int32               GetFieldIndexAtPoint(sal_Int32 _nRow,sal_Int32 _nColumnPos,const Point& _rPoint) = 0;
 125
 126 protected:
 127     ~IAccessibleTableProvider() {}
 128 };
 129
 130
 131 /** interface for an implementation of a table control's Accessible component
 132 */
 133 class IAccessibleTabListBox
 134 {
 135 public:
 136     /** returns the XAccessible object itself
 137
 138         The reference returned here can be used to control the life time of the
 139         IAccessibleTableImplementation object.
 140
 141         The returned reference is guaranteed to not be <NULL/>.
 142     */
 143     virtual css::uno::Reference< css::accessibility::XAccessible >
 144         getMyself() = 0;
 145
 146     /** returns the accessible object for the column header bar
 147     */
 148     virtual css::uno::Reference< css::accessibility::XAccessible >
 149         getHeaderBar() = 0;
 150
 151     /** Returns the accessible object for the table.
 152      */
 153     virtual css::uno::Reference< css::accessibility::XAccessible> getTable() = 0;
 154
 155 protected:
 156     ~IAccessibleTabListBox() {}
 157 };
 158
 159 /** interface for an implementation of a browse box's Accessible component
 160 */
 161 class IAccessibleBrowseBox : public cppu::WeakImplHelper<css::accessibility::XAccessible>
 162 {
 163 public:
 164     /** disposes the accessible implementation, so that it becomes defunc
 165     */
 166     virtual void dispose() = 0;
 167
 168     /** checks whether the accessible implementation, and its context, are still alive
 169         @return  <TRUE/>, if the object is not disposed or disposing.
 170     */
 171     virtual bool isAlive() const = 0;
 172
 173     /** returns the accessible object for the row or the column header bar
 174     */
 175     virtual css::uno::Reference< css::accessibility::XAccessible >
 176         getHeaderBar( AccessibleBrowseBoxObjType _eObjType ) = 0;
 177
 178     /** returns the accessible object for the table representation
 179     */
 180     virtual css::uno::Reference< css::accessibility::XAccessible >
 181         getTable() = 0;
 182
 183     /** commits the event at all listeners of the column/row header bar
 184         @param nEventId
 185             the event id
 186         @param rNewValue
 187             the new value
 188         @param rOldValue
 189             the old value
 190     */
 191     virtual void commitHeaderBarEvent(
 192         sal_Int16 nEventId,
 193         const css::uno::Any& rNewValue,
 194         const css::uno::Any& rOldValue,
 195         bool _bColumnHeaderBar
 196     ) = 0;
 197
 198     /** commits the event at all listeners of the table
 199         @param nEventId
 200             the event id
 201         @param rNewValue
 202             the new value
 203         @param rOldValue
 204             the old value
 205     */
 206     virtual void commitTableEvent(
 207         sal_Int16 nEventId,
 208         const css::uno::Any& rNewValue,
 209         const css::uno::Any& rOldValue
 210     ) = 0;
 211
 212     /** Commits an event to all listeners. */
 213     virtual void commitEvent(
 214         sal_Int16 nEventId,
 215         const css::uno::Any& rNewValue,
 216         const css::uno::Any& rOldValue
 217     ) = 0;
 218
 219 protected:
 220     ~IAccessibleBrowseBox() {}
 221 };
 222
 223 } // namespace vcl
 224
 225 #endif // INCLUDED_VCL_ACCESSIBLETABLEPROVIDER_HXX
 226
 227 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */