starmath/source/accessibility.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_STARMATH_SOURCE_ACCESSIBILITY_HXX
  21 #define INCLUDED_STARMATH_SOURCE_ACCESSIBILITY_HXX
  22
  23 #include <com/sun/star/accessibility/XAccessible.hpp>
  24 #include <com/sun/star/accessibility/XAccessibleComponent.hpp>
  25 #include <com/sun/star/accessibility/XAccessibleContext.hpp>
  26 #include <com/sun/star/accessibility/XAccessibleText.hpp>
  27 #include <com/sun/star/accessibility/XAccessibleEventBroadcaster.hpp>
  28 #include <com/sun/star/lang/XServiceInfo.hpp>
  29 #include <com/sun/star/uno/Reference.h>
  30 #include <cppuhelper/implbase.hxx>
  31 #include <svl/SfxBroadcaster.hxx>
  32
  33 #include <editeng/editeng.hxx>
  34 #include <editeng/unoedsrc.hxx>
  35 #include <edit.hxx>
  36 #include <view.hxx>
  37 #include <memory>
  38
  39 class SmDocShell;
  40
  41 namespace accessibility { class AccessibleTextHelper; }
  42
  43 // classes and helper-classes used for accessibility in the graphic-window
  44
  45
  46 typedef
  47 cppu::WeakImplHelper
  48     <
  49         css::lang::XServiceInfo,
  50         css::accessibility::XAccessible,
  51         css::accessibility::XAccessibleComponent,
  52         css::accessibility::XAccessibleContext,
  53         css::accessibility::XAccessibleText,
  54         css::accessibility::XAccessibleEventBroadcaster
  55     >
  56 SmGraphicAccessibleBaseClass;
  57
  58 class SmGraphicAccessible final :
  59     public SmGraphicAccessibleBaseClass
  60 {
  61     OUString const                      aAccName;
  62     /// client id in the AccessibleEventNotifier queue
  63     sal_uInt32                          nClientId;
  64
  65     VclPtr<SmGraphicWindow>             pWin;
  66
  67     SmGraphicAccessible( const SmGraphicAccessible & ) = delete;
  68     SmGraphicAccessible & operator = ( const SmGraphicAccessible & ) = delete;
  69
  70     SmDocShell *    GetDoc_Impl();
  71     OUString        GetAccessibleText_Impl();
  72
  73 public:
  74     explicit SmGraphicAccessible( SmGraphicWindow *pGraphicWin );
  75     virtual ~SmGraphicAccessible() override;
  76
  77     void                ClearWin();     // to be called when view is destroyed
  78     void                LaunchEvent(
  79                             const sal_Int16 nAccessibleEventId,
  80                             const css::uno::Any &rOldVal,
  81                             const css::uno::Any &rNewVal);
  82
  83     // XAccessible
  84     virtual css::uno::Reference< css::accessibility::XAccessibleContext > SAL_CALL getAccessibleContext(  ) override;
  85
  86     // XAccessibleComponent
  87     virtual sal_Bool SAL_CALL containsPoint( const css::awt::Point& aPoint ) override;
  88     virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleAtPoint( const css::awt::Point& aPoint ) override;
  89     virtual css::awt::Rectangle SAL_CALL getBounds(  ) override;
  90     virtual css::awt::Point SAL_CALL getLocation(  ) override;
  91     virtual css::awt::Point SAL_CALL getLocationOnScreen(  ) override;
  92     virtual css::awt::Size SAL_CALL getSize(  ) override;
  93     virtual void SAL_CALL grabFocus(  ) override;
  94     virtual sal_Int32 SAL_CALL getForeground(  ) override;
  95     virtual sal_Int32 SAL_CALL getBackground(  ) override;
  96
  97     // XAccessibleContext
  98     virtual sal_Int32 SAL_CALL getAccessibleChildCount(  ) override;
  99     virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleChild( sal_Int32 i ) override;
 100     virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleParent(  ) override;
 101     virtual sal_Int32 SAL_CALL getAccessibleIndexInParent(  ) override;
 102     virtual sal_Int16 SAL_CALL getAccessibleRole(  ) override;
 103     virtual OUString SAL_CALL getAccessibleDescription(  ) override;
 104     virtual OUString SAL_CALL getAccessibleName(  ) override;
 105     virtual css::uno::Reference< css::accessibility::XAccessibleRelationSet > SAL_CALL getAccessibleRelationSet(  ) override;
 106     virtual css::uno::Reference< css::accessibility::XAccessibleStateSet > SAL_CALL getAccessibleStateSet(  ) override;
 107     virtual css::lang::Locale SAL_CALL getLocale(  ) override;
 108
 109     // XAccessibleEventBroadcaster
 110     virtual void SAL_CALL addAccessibleEventListener( const css::uno::Reference< css::accessibility::XAccessibleEventListener >& xListener ) override;
 111     virtual void SAL_CALL removeAccessibleEventListener( const css::uno::Reference< css::accessibility::XAccessibleEventListener >& xListener ) override;
 112
 113     // XAccessibleText
 114     virtual sal_Int32 SAL_CALL getCaretPosition(  ) override;
 115     virtual sal_Bool SAL_CALL setCaretPosition ( sal_Int32 nIndex ) override;
 116     virtual sal_Unicode SAL_CALL getCharacter( sal_Int32 nIndex ) override;
 117     virtual css::uno::Sequence< css::beans::PropertyValue > SAL_CALL getCharacterAttributes( sal_Int32 nIndex, const css::uno::Sequence< OUString >& aRequestedAttributes ) override;
 118     virtual css::awt::Rectangle SAL_CALL getCharacterBounds( sal_Int32 nIndex ) override;
 119     virtual sal_Int32 SAL_CALL getCharacterCount(  ) override;
 120     virtual sal_Int32 SAL_CALL getIndexAtPoint( const css::awt::Point& aPoint ) override;
 121     virtual OUString SAL_CALL getSelectedText(  ) override;
 122     virtual sal_Int32 SAL_CALL getSelectionStart(  ) override;
 123     virtual sal_Int32 SAL_CALL getSelectionEnd(  ) override;
 124     virtual sal_Bool SAL_CALL setSelection( sal_Int32 nStartIndex, sal_Int32 nEndIndex ) override;
 125     virtual OUString SAL_CALL getText(  ) override;
 126     virtual OUString SAL_CALL getTextRange( sal_Int32 nStartIndex, sal_Int32 nEndIndex ) override;
 127     virtual css::accessibility::TextSegment SAL_CALL getTextAtIndex( sal_Int32 nIndex, sal_Int16 aTextType ) override;
 128     virtual css::accessibility::TextSegment SAL_CALL getTextBeforeIndex( sal_Int32 nIndex, sal_Int16 aTextType ) override;
 129     virtual css::accessibility::TextSegment SAL_CALL getTextBehindIndex( sal_Int32 nIndex, sal_Int16 aTextType ) override;
 130     virtual sal_Bool SAL_CALL copyText( sal_Int32 nStartIndex, sal_Int32 nEndIndex ) override;
 131
 132     // XServiceInfo
 133     virtual OUString SAL_CALL getImplementationName(  ) override;
 134     virtual sal_Bool SAL_CALL supportsService( const OUString& ServiceName ) override;
 135     virtual css::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames(  ) override;
 136 };
 137
 138
 139 // classes and helper-classes used for accessibility in the command-window
 140
 141
 142 class SmEditAccessible;
 143 class SmEditSource;
 144 class EditView;
 145 class SvxFieldItem;
 146
 147
 148 class SmViewForwarder :
 149     public SvxViewForwarder
 150 {
 151     SmEditAccessible &          rEditAcc;
 152
 153     SmViewForwarder( const SmViewForwarder & ) = delete;
 154     SmViewForwarder & operator = ( const SmViewForwarder & ) = delete;
 155
 156 public:
 157     explicit SmViewForwarder( SmEditAccessible &rAcc );
 158     virtual             ~SmViewForwarder() override;
 159
 160     virtual bool        IsValid() const override;
 161     virtual Point       LogicToPixel( const Point& rPoint, const MapMode& rMapMode ) const override;
 162     virtual Point       PixelToLogic( const Point& rPoint, const MapMode& rMapMode ) const override;
 163 };
 164
 165
 166 class SmTextForwarder :     /* analog to SvxEditEngineForwarder */
 167     public SvxTextForwarder
 168 {
 169     SmEditAccessible &  rEditAcc;
 170     SmEditSource &      rEditSource;
 171
 172     DECL_LINK( NotifyHdl, EENotify&, void );
 173
 174     SmTextForwarder( const SmTextForwarder & ) = delete;
 175     SmTextForwarder & operator = ( const SmTextForwarder & ) = delete;
 176
 177 public:
 178     SmTextForwarder( SmEditAccessible& rAcc, SmEditSource & rSource );
 179     virtual ~SmTextForwarder() override;
 180
 181     virtual sal_Int32   GetParagraphCount() const override;
 182     virtual sal_Int32   GetTextLen( sal_Int32 nParagraph ) const override;
 183     virtual OUString    GetText( const ESelection& rSel ) const override;
 184     virtual SfxItemSet  GetAttribs( const ESelection& rSel, EditEngineAttribs nOnlyHardAttrib = EditEngineAttribs::All ) const override;
 185     virtual SfxItemSet  GetParaAttribs( sal_Int32 nPara ) const override;
 186     virtual void        SetParaAttribs( sal_Int32 nPara, const SfxItemSet& rSet ) override;
 187     virtual void        RemoveAttribs( const ESelection& rSelection ) override;
 188     virtual void        GetPortions( sal_Int32 nPara, std::vector<sal_Int32>& rList ) const override;
 189
 190     virtual SfxItemState  GetItemState( const ESelection& rSel, sal_uInt16 nWhich ) const override;
 191     virtual SfxItemState  GetItemState( sal_Int32 nPara, sal_uInt16 nWhich ) const override;
 192
 193     virtual void        QuickInsertText( const OUString& rText, const ESelection& rSel ) override;
 194     virtual void        QuickInsertField( const SvxFieldItem& rFld, const ESelection& rSel ) override;
 195     virtual void        QuickSetAttribs( const SfxItemSet& rSet, const ESelection& rSel ) override;
 196     virtual void        QuickInsertLineBreak( const ESelection& rSel ) override;
 197
 198     virtual SfxItemPool* GetPool() const override;
 199
 200     virtual OUString        CalcFieldValue( const SvxFieldItem& rField, sal_Int32 nPara, sal_Int32 nPos, boost::optional<Color>& rpTxtColor, boost::optional<Color>& rpFldColor ) override;
 201     virtual void            FieldClicked(const SvxFieldItem&) override;
 202     virtual bool            IsValid() const override;
 203
 204     virtual LanguageType    GetLanguage( sal_Int32, sal_Int32 ) const override;
 205     virtual sal_Int32       GetFieldCount( sal_Int32 nPara ) const override;
 206     virtual EFieldInfo      GetFieldInfo( sal_Int32 nPara, sal_uInt16 nField ) const override;
 207     virtual EBulletInfo     GetBulletInfo( sal_Int32 nPara ) const override;
 208     virtual tools::Rectangle       GetCharBounds( sal_Int32 nPara, sal_Int32 nIndex ) const override;
 209     virtual tools::Rectangle       GetParaBounds( sal_Int32 nPara ) const override;
 210     virtual MapMode         GetMapMode() const override;
 211     virtual OutputDevice*   GetRefDevice() const override;
 212     virtual bool            GetIndexAtPoint( const Point&, sal_Int32& nPara, sal_Int32& nIndex ) const override;
 213     virtual bool            GetWordIndices( sal_Int32 nPara, sal_Int32 nIndex, sal_Int32& nStart, sal_Int32& nEnd ) const override;
 214     virtual bool            GetAttributeRun( sal_Int32& nStartIndex, sal_Int32& nEndIndex, sal_Int32 nPara, sal_Int32 nIndex, bool bInCell = false ) const override;
 215     virtual sal_Int32       GetLineCount( sal_Int32 nPara ) const override;
 216     virtual sal_Int32       GetLineLen( sal_Int32 nPara, sal_Int32 nLine ) const override;
 217     virtual void            GetLineBoundaries( /*out*/sal_Int32 &rStart, /*out*/sal_Int32 &rEnd, sal_Int32 nParagraph, sal_Int32 nLine ) const override;
 218     virtual sal_Int32       GetLineNumberAtIndex( sal_Int32 nPara, sal_Int32 nLine ) const override;
 219     virtual bool            Delete( const ESelection& ) override;
 220     virtual bool            InsertText( const OUString&, const ESelection& ) override;
 221     virtual bool            QuickFormatDoc( bool bFull = false ) override;
 222
 223     virtual sal_Int16       GetDepth( sal_Int32 nPara ) const override;
 224     virtual bool            SetDepth( sal_Int32 nPara, sal_Int16 nNewDepth ) override;
 225
 226     virtual const SfxItemSet*   GetEmptyItemSetPtr() override;
 227     // implementation functions for XParagraphAppend and XTextPortionAppend
 228     virtual void        AppendParagraph() override;
 229     virtual sal_Int32   AppendTextPortion( sal_Int32 nPara, const OUString &rText, const SfxItemSet &rSet ) override;
 230
 231     virtual void        CopyText(const SvxTextForwarder& rSource) override;
 232 };
 233
 234
 235 class SmEditViewForwarder :     /* analog to SvxEditEngineViewForwarder */
 236     public SvxEditViewForwarder
 237 {
 238     SmEditAccessible&       rEditAcc;
 239
 240     SmEditViewForwarder( const SmEditViewForwarder & ) = delete;
 241     SmEditViewForwarder & operator = ( const SmEditViewForwarder & ) = delete;
 242
 243 public:
 244     explicit SmEditViewForwarder( SmEditAccessible& rAcc );
 245     virtual             ~SmEditViewForwarder() override;
 246
 247     virtual bool        IsValid() const override;
 248
 249     virtual Point       LogicToPixel( const Point& rPoint, const MapMode& rMapMode ) const override;
 250     virtual Point       PixelToLogic( const Point& rPoint, const MapMode& rMapMode ) const override;
 251
 252     virtual bool        GetSelection( ESelection& rSelection ) const override;
 253     virtual bool        SetSelection( const ESelection& rSelection ) override;
 254     virtual bool        Copy() override;
 255     virtual bool        Cut() override;
 256     virtual bool        Paste() override;
 257 };
 258
 259
 260 class SmEditSource :
 261     public SvxEditSource
 262 {
 263     SfxBroadcaster          aBroadCaster;
 264     SmViewForwarder         aViewFwd;
 265     SmTextForwarder         aTextFwd;
 266     SmEditViewForwarder     aEditViewFwd;
 267
 268     SmEditAccessible&       rEditAcc;
 269
 270     SmEditSource( const SmEditSource &rSrc );
 271     SmEditSource & operator = ( const SmEditSource & ) = delete;
 272
 273 public:
 274             SmEditSource( SmEditAccessible &rAcc );
 275     virtual ~SmEditSource() override;
 276
 277     virtual std::unique_ptr<SvxEditSource> Clone() const override;
 278     virtual SvxTextForwarder*   GetTextForwarder() override;
 279     virtual SvxViewForwarder*  GetViewForwarder() override;
 280     virtual SvxEditViewForwarder*  GetEditViewForwarder( bool bCreate = false ) override;
 281     virtual void                UpdateData() override;
 282     virtual SfxBroadcaster&     GetBroadcaster() const override;
 283 };
 284
 285
 286 typedef
 287 cppu::WeakImplHelper
 288     <
 289         css::lang::XServiceInfo,
 290         css::accessibility::XAccessible,
 291         css::accessibility::XAccessibleComponent,
 292         css::accessibility::XAccessibleContext,
 293         css::accessibility::XAccessibleEventBroadcaster
 294     >
 295 SmEditAccessibleBaseClass;
 296
 297 class SmEditAccessible :
 298     public SmEditAccessibleBaseClass
 299 {
 300     OUString const                          aAccName;
 301     std::unique_ptr<::accessibility::AccessibleTextHelper> pTextHelper;
 302     VclPtr<SmEditWindow>                    pWin;
 303
 304     SmEditAccessible( const SmEditAccessible & ) = delete;
 305     SmEditAccessible & operator = ( const SmEditAccessible & ) = delete;
 306
 307 public:
 308     explicit SmEditAccessible( SmEditWindow *pEditWin );
 309     virtual ~SmEditAccessible() override;
 310
 311     ::accessibility::AccessibleTextHelper *   GetTextHelper();
 312
 313     void                Init();
 314     void                ClearWin();     // to be called when view is destroyed
 315
 316     //! access EditEngine and EditView via the functions in the respective window
 317     //! pointers may be 0 (e.g. during reload)
 318     EditEngine * GetEditEngine()    { return pWin ? pWin->GetEditEngine() : nullptr; }
 319     EditView   * GetEditView()      { return pWin ? pWin->GetEditView() : nullptr; }
 320
 321     // XAccessible
 322     virtual css::uno::Reference< css::accessibility::XAccessibleContext > SAL_CALL getAccessibleContext(  ) override;
 323
 324     // XAccessibleComponent
 325     virtual sal_Bool SAL_CALL containsPoint( const css::awt::Point& aPoint ) override;
 326     virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleAtPoint( const css::awt::Point& aPoint ) override;
 327     virtual css::awt::Rectangle SAL_CALL getBounds(  ) override;
 328     virtual css::awt::Point SAL_CALL getLocation(  ) override;
 329     virtual css::awt::Point SAL_CALL getLocationOnScreen(  ) override;
 330     virtual css::awt::Size SAL_CALL getSize(  ) override;
 331     virtual void SAL_CALL grabFocus(  ) override;
 332     virtual sal_Int32 SAL_CALL getForeground(  ) override;
 333     virtual sal_Int32 SAL_CALL getBackground(  ) override;
 334
 335     // XAccessibleContext
 336     virtual sal_Int32 SAL_CALL getAccessibleChildCount(  ) override;
 337     virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleChild( sal_Int32 i ) override;
 338     virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleParent(  ) override;
 339     virtual sal_Int32 SAL_CALL getAccessibleIndexInParent(  ) override;
 340     virtual sal_Int16 SAL_CALL getAccessibleRole(  ) override;
 341     virtual OUString SAL_CALL getAccessibleDescription(  ) override;
 342     virtual OUString SAL_CALL getAccessibleName(  ) override;
 343     virtual css::uno::Reference< css::accessibility::XAccessibleRelationSet > SAL_CALL getAccessibleRelationSet(  ) override;
 344     virtual css::uno::Reference< css::accessibility::XAccessibleStateSet > SAL_CALL getAccessibleStateSet(  ) override;
 345     virtual css::lang::Locale SAL_CALL getLocale(  ) override;
 346
 347     // XAccessibleEventBroadcaster
 348     virtual void SAL_CALL addAccessibleEventListener( const css::uno::Reference< css::accessibility::XAccessibleEventListener >& xListener ) override;
 349     virtual void SAL_CALL removeAccessibleEventListener( const css::uno::Reference< css::accessibility::XAccessibleEventListener >& xListener ) override;
 350
 351     // XServiceInfo
 352     virtual OUString SAL_CALL getImplementationName(  ) override;
 353     virtual sal_Bool SAL_CALL supportsService( const OUString& ServiceName ) override;
 354     virtual css::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames(  ) override;
 355 };
 356
 357
 358 #endif
 359
 360 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */