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