| /************************************************************** |
| * |
| * 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 |
| * |
| * Unless required by applicable law or agreed to in writing, |
| * software distributed under the License is distributed on an |
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| * KIND, either express or implied. See the License for the |
| * specific language governing permissions and limitations |
| * under the License. |
| * |
| *************************************************************/ |
| |
| |
| |
| |
| #ifndef ACCESSIBILITY_EXT_ACCESSIBLEGRIDCONTROLBASE_HXX |
| #define ACCESSIBILITY_EXT_ACCESSIBLEGRIDCONTROLBASE_HXX |
| |
| #include <svtools/accessibletable.hxx> |
| #include <tools/debug.hxx> |
| #include <rtl/ustring.hxx> |
| #include <tools/gen.hxx> |
| #include <vcl/svapp.hxx> |
| #include <cppuhelper/compbase4.hxx> |
| #include <comphelper/broadcasthelper.hxx> |
| #include <unotools/accessiblestatesethelper.hxx> |
| #include <toolkit/helper/convert.hxx> |
| #include <com/sun/star/lang/XServiceInfo.hpp> |
| #include <com/sun/star/lang/DisposedException.hpp> |
| #include <com/sun/star/awt/XWindow.hpp> |
| #include <com/sun/star/accessibility/XAccessible.hpp> |
| #include <com/sun/star/accessibility/XAccessibleContext.hpp> |
| #include <com/sun/star/accessibility/XAccessibleComponent.hpp> |
| #include <com/sun/star/accessibility/XAccessibleEventBroadcaster.hpp> |
| #include <com/sun/star/accessibility/AccessibleRole.hpp> |
| #include <com/sun/star/accessibility/AccessibleStateType.hpp> |
| #include <comphelper/accessibleeventnotifier.hxx> |
| #include <comphelper/uno3.hxx> |
| |
| // ============================================================================ |
| |
| class Window; |
| |
| namespace utl { |
| class AccessibleStateSetHelper; |
| } |
| |
| // ============================================================================ |
| |
| namespace accessibility { |
| |
| // ============================================================================ |
| |
| /** Aquire the solar mutex. */ |
| class TCSolarGuard : public ::vos::OGuard |
| { |
| public: |
| inline TCSolarGuard() : ::vos::OGuard( Application::GetSolarMutex() ) {} |
| }; |
| |
| // ============================================================================ |
| |
| typedef ::cppu::WeakAggComponentImplHelper4< |
| ::com::sun::star::accessibility::XAccessibleContext, |
| ::com::sun::star::accessibility::XAccessibleComponent, |
| ::com::sun::star::accessibility::XAccessibleEventBroadcaster, |
| ::com::sun::star::lang::XServiceInfo > |
| AccessibleGridControlImplHelper; |
| |
| /** The GridControl accessible objects inherit from this base class. It |
| implements basic functionality for various Accessibility interfaces and |
| the event broadcaster and contains the ::osl::Mutex. */ |
| class AccessibleGridControlBase : |
| public ::comphelper::OBaseMutex, |
| public AccessibleGridControlImplHelper |
| { |
| public: |
| /** Constructor sets specified name and description. |
| @param rxParent XAccessible interface of the parent object. |
| @param rTable The Table control. |
| @param eNameText The constant for the name text. |
| @param eDescrText The constant for the description text. */ |
| AccessibleGridControlBase( |
| const ::com::sun::star::uno::Reference< |
| ::com::sun::star::accessibility::XAccessible >& rxParent, |
| ::svt::table::IAccessibleTable& rTable, |
| ::svt::table::AccessibleTableControlObjType eObjType ); |
| |
| protected: |
| virtual ~AccessibleGridControlBase(); |
| |
| /** Commits DeFunc event to listeners and cleans up members. */ |
| virtual void SAL_CALL disposing(); |
| |
| public: |
| // XAccessibleContext ----------------------------------------------------- |
| |
| /** @return A reference to the parent accessible object. */ |
| virtual ::com::sun::star::uno::Reference< |
| ::com::sun::star::accessibility::XAccessible > SAL_CALL |
| getAccessibleParent() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /** @return The index of this object among the parent's children. */ |
| virtual sal_Int32 SAL_CALL getAccessibleIndexInParent() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /** @return |
| The description of this object. |
| */ |
| virtual ::rtl::OUString SAL_CALL getAccessibleDescription() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /** @return |
| The name of this object. |
| */ |
| virtual ::rtl::OUString SAL_CALL getAccessibleName() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /** @return |
| The relation set (the GridControl does not have one). |
| */ |
| virtual ::com::sun::star::uno::Reference< |
| ::com::sun::star::accessibility::XAccessibleRelationSet > SAL_CALL |
| getAccessibleRelationSet() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /** @return The set of current states. */ |
| virtual ::com::sun::star::uno::Reference< |
| ::com::sun::star::accessibility::XAccessibleStateSet > SAL_CALL |
| getAccessibleStateSet() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /** @return The parent's locale. */ |
| virtual ::com::sun::star::lang::Locale SAL_CALL getLocale() |
| throw ( ::com::sun::star::accessibility::IllegalAccessibleComponentStateException, |
| ::com::sun::star::uno::RuntimeException ); |
| |
| /** @return |
| The role of this object. Panel, ROWHEADER, COLUMNHEADER, TABLE, TABLE_CELL are supported. |
| */ |
| virtual sal_Int16 SAL_CALL getAccessibleRole() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /* Derived classes have to implement: |
| - getAccessibleChildCount, |
| - getAccessibleChild, |
| - getAccessibleRole. |
| Derived classes may overwrite getAccessibleIndexInParent to increase |
| performance. */ |
| |
| // XAccessibleComponent --------------------------------------------------- |
| |
| /** @return |
| <TRUE/>, if the point lies within the bounding box of this object. */ |
| virtual sal_Bool SAL_CALL containsPoint( const ::com::sun::star::awt::Point& rPoint ) |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /** @return The bounding box of this object. */ |
| virtual ::com::sun::star::awt::Rectangle SAL_CALL getBounds() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /** @return |
| The upper left corner of the bounding box relative to the parent. */ |
| virtual ::com::sun::star::awt::Point SAL_CALL getLocation() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /** @return |
| The upper left corner of the bounding box in screen coordinates. */ |
| virtual ::com::sun::star::awt::Point SAL_CALL getLocationOnScreen() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /** @return The size of the bounding box. */ |
| virtual ::com::sun::star::awt::Size SAL_CALL getSize() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /** @return <TRUE/>, if the object is showing. */ |
| virtual sal_Bool SAL_CALL isShowing() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /** @return <TRUE/>, if the object is visible. */ |
| virtual sal_Bool SAL_CALL isVisible() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /** @return <TRUE/>, if the object can accept the focus. */ |
| virtual sal_Bool SAL_CALL isFocusTraversable() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| virtual sal_Int32 SAL_CALL getForeground( ) throw (::com::sun::star::uno::RuntimeException); |
| virtual sal_Int32 SAL_CALL getBackground( ) throw (::com::sun::star::uno::RuntimeException); |
| |
| |
| /* Derived classes have to implement: |
| - getAccessibleAt, |
| - grabFocus, |
| - getAccessibleKeyBinding. */ |
| |
| /** @return |
| No key bindings supported by default. |
| */ |
| virtual ::com::sun::star::uno::Any SAL_CALL getAccessibleKeyBinding() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| /** @return |
| The accessible child rendered under the given point. |
| */ |
| virtual ::com::sun::star::uno::Reference< |
| ::com::sun::star::accessibility::XAccessible > SAL_CALL |
| getAccessibleAtPoint( const ::com::sun::star::awt::Point& rPoint ) |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| // XAccessibleEventBroadcaster -------------------------------------------- |
| |
| /** Adds a new event listener */ |
| using cppu::WeakAggComponentImplHelperBase::addEventListener; |
| virtual void SAL_CALL addEventListener( |
| const ::com::sun::star::uno::Reference< |
| ::com::sun::star::accessibility::XAccessibleEventListener>& rxListener ) |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /** Removes an event listener. */ |
| using cppu::WeakAggComponentImplHelperBase::removeEventListener; |
| virtual void SAL_CALL removeEventListener( |
| const ::com::sun::star::uno::Reference< |
| ::com::sun::star::accessibility::XAccessibleEventListener>& rxListener ) |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| // XTypeProvider ---------------------------------------------------------- |
| |
| /** @return An unique implementation ID. */ |
| virtual ::com::sun::star::uno::Sequence< sal_Int8 > SAL_CALL getImplementationId() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| // XServiceInfo ----------------------------------------------------------- |
| |
| /** @return Whether the specified service is supported by this class. */ |
| virtual sal_Bool SAL_CALL supportsService( const ::rtl::OUString& rServiceName ) |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /** @return A list of all supported services. */ |
| virtual ::com::sun::star::uno::Sequence< ::rtl::OUString > SAL_CALL |
| getSupportedServiceNames() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| /* Derived classes have to implement: |
| - getImplementationName. */ |
| |
| // helper methods --------------------------------------------------------- |
| |
| /** @return The GridControl object type. */ |
| inline ::svt::table::AccessibleTableControlObjType getType() const; |
| |
| /** Commits an event to all listeners. */ |
| void commitEvent( |
| sal_Int16 nEventId, |
| const ::com::sun::star::uno::Any& rNewValue, |
| |
| const ::com::sun::star::uno::Any& rOldValue ); |
| /** @return <TRUE/>, if the object is not disposed or disposing. */ |
| sal_Bool isAlive() const; |
| |
| protected: |
| // internal virtual methods ----------------------------------------------- |
| |
| /** Determines whether the Grid control is really showing inside of |
| its parent accessible window. Derived classes may implement different |
| behaviour. |
| @attention This method requires locked mutex's and a living object. |
| @return <TRUE/>, if the object is really showing. */ |
| virtual sal_Bool implIsShowing(); |
| |
| /** Derived classes return the bounding box relative to the parent window. |
| @attention This method requires locked mutex's and a living object. |
| @return The bounding box (VCL rect.) relative to the parent window. */ |
| virtual Rectangle implGetBoundingBox() = 0; |
| ///** Derived classes return the bounding box in screen coordinates. |
| // @attention This method requires locked mutex's and a living object. |
| // @return The bounding box (VCL rect.) in screen coordinates. */ |
| virtual Rectangle implGetBoundingBoxOnScreen() = 0; |
| |
| /** Creates a new AccessibleStateSetHelper and fills it with states of the |
| current object. This method calls FillStateSet at the GridControl which |
| fills it with more states depending on the object type. Derived classes |
| may overwrite this method and add more states. |
| @attention This method requires locked mutex's. |
| @return A filled AccessibleStateSetHelper. */ |
| virtual ::utl::AccessibleStateSetHelper* implCreateStateSetHelper(); |
| |
| // internal helper methods ------------------------------------------------ |
| |
| /** @throws <type>DisposedException</type> If the object is not alive. */ |
| void ensureIsAlive() const |
| throw ( ::com::sun::star::lang::DisposedException ); |
| |
| /** @return The ::osl::Mutex member provided by the class OBaseMutex. */ |
| inline ::osl::Mutex& getOslMutex(); |
| /** @return Pointer to the global ::osl::Mutex. */ |
| static inline ::osl::Mutex* getOslGlobalMutex(); |
| |
| /** Changes the name of the object (flat assignment, no notify). |
| @attention This method requires a locked mutex. */ |
| inline void implSetName( const ::rtl::OUString& rName ); |
| /** Changes the description of the object (flat assignment, no notify). |
| @attention This method requires a locked mutex. */ |
| inline void implSetDescription( const ::rtl::OUString& rDescription ); |
| |
| /** Locks all mutex's and calculates the bounding box relative to the |
| parent window. |
| @return The bounding box (VCL rect.) relative to the parent object. */ |
| Rectangle getBoundingBox() |
| throw ( ::com::sun::star::lang::DisposedException ); |
| ///** Locks all mutex's and calculates the bounding box in screen |
| // coordinates. |
| // @return The bounding box (VCL rect.) in screen coordinates. */ |
| Rectangle getBoundingBoxOnScreen() |
| throw ( ::com::sun::star::lang::DisposedException ); |
| |
| /** Creates a new UUID, if rId is empty. |
| @attention This method requires locked global mutex to prevent double |
| creation of an UUID. */ |
| static void implCreateUuid( ::com::sun::star::uno::Sequence< sal_Int8 >& rId ); |
| |
| ::comphelper::AccessibleEventNotifier::TClientId getClientId() const { return m_aClientId; } |
| void setClientId(::comphelper::AccessibleEventNotifier::TClientId _aNewClientId) { m_aClientId = _aNewClientId; } |
| |
| public: |
| // public versions of internal helper methods, with access control |
| struct TC_AccessControl { friend class TC_SolarMethodGuard; private: TC_AccessControl() { } }; |
| |
| inline ::osl::Mutex& getMutex( const TC_AccessControl& ) { return getOslMutex(); } |
| inline void ensureIsAlive( const TC_AccessControl& ) { ensureIsAlive(); } |
| |
| protected: |
| // members ---------------------------------------------------------------- |
| |
| /** The parent accessible object. */ |
| ::com::sun::star::uno::Reference< |
| ::com::sun::star::accessibility::XAccessible > m_xParent; |
| /** The SVT Table control. */ |
| ::svt::table::IAccessibleTable& m_aTable; |
| /** The type of this object (for names, descriptions, state sets, ...). */ |
| ::svt::table::AccessibleTableControlObjType m_eObjType; |
| |
| private: |
| /** Localized name. */ |
| ::rtl::OUString m_aName; |
| /** Localized description text. */ |
| ::rtl::OUString m_aDescription; |
| ::comphelper::AccessibleEventNotifier::TClientId m_aClientId; |
| }; |
| |
| // ============================================================================ |
| // a version of AccessibleGridControlBase which implements not only the XAccessibleContext, |
| // but also the XAccessible |
| |
| typedef ::cppu::ImplHelper1 < ::com::sun::star::accessibility::XAccessible |
| > GridControlAccessibleElement_Base; |
| |
| class GridControlAccessibleElement |
| :public AccessibleGridControlBase |
| ,public GridControlAccessibleElement_Base |
| { |
| protected: |
| /** Constructor sets specified name and description. |
| |
| @param rxParent XAccessible interface of the parent object. |
| @param rTable The Table control. |
| @param eNameText The constant for the name text. |
| @param eDescrText The constant for the description text. |
| */ |
| GridControlAccessibleElement( |
| const ::com::sun::star::uno::Reference< |
| ::com::sun::star::accessibility::XAccessible >& rxParent, |
| ::svt::table::IAccessibleTable& rTable, |
| ::svt::table::AccessibleTableControlObjType eObjType ); |
| |
| public: |
| // XInterface |
| DECLARE_XINTERFACE( ) |
| // XTypeProvider |
| DECLARE_XTYPEPROVIDER( ) |
| |
| protected: |
| virtual ~GridControlAccessibleElement(); |
| |
| protected: |
| // XAccessible ------------------------------------------------------------ |
| |
| /** @return The XAccessibleContext interface of this object. */ |
| virtual ::com::sun::star::uno::Reference< |
| ::com::sun::star::accessibility::XAccessibleContext > SAL_CALL |
| getAccessibleContext() |
| throw ( ::com::sun::star::uno::RuntimeException ); |
| |
| private: |
| GridControlAccessibleElement(); // never implemented |
| GridControlAccessibleElement( const GridControlAccessibleElement& ); // never implemented |
| GridControlAccessibleElement& operator=( const GridControlAccessibleElement& ); // never implemented |
| }; |
| |
| // ============================================================================ |
| // a helper class for protecting methods which need to lock the solar mutex in addition to the own mutex |
| |
| typedef ::osl::MutexGuard OslMutexGuard; |
| |
| class TC_SolarMethodGuard : public TCSolarGuard, public OslMutexGuard |
| { |
| public: |
| inline TC_SolarMethodGuard( AccessibleGridControlBase& _rOwner, bool _bEnsureAlive = true ) |
| :TCSolarGuard( ) |
| ,OslMutexGuard( _rOwner.getMutex( AccessibleGridControlBase::TC_AccessControl() ) ) |
| { |
| if ( _bEnsureAlive ) |
| _rOwner.ensureIsAlive( AccessibleGridControlBase::TC_AccessControl() ); |
| } |
| }; |
| |
| // inlines -------------------------------------------------------------------- |
| |
| inline ::svt::table::AccessibleTableControlObjType AccessibleGridControlBase::getType() const |
| { |
| return m_eObjType; |
| } |
| |
| inline ::osl::Mutex& AccessibleGridControlBase::getOslMutex() |
| { |
| return m_aMutex; |
| } |
| |
| inline ::osl::Mutex* AccessibleGridControlBase::getOslGlobalMutex() |
| { |
| return ::osl::Mutex::getGlobalMutex(); |
| } |
| |
| inline void AccessibleGridControlBase::implSetName( |
| const ::rtl::OUString& rName ) |
| { |
| m_aName = rName; |
| } |
| |
| inline void AccessibleGridControlBase::implSetDescription( |
| const ::rtl::OUString& rDescription ) |
| { |
| m_aDescription = rDescription; |
| } |
| |
| // ============================================================================ |
| |
| } // namespace accessibility |
| |
| // ============================================================================ |
| |
| #endif // ACCESSIBILITY_EXT_ACCESSIBILEGRIDCONTROLBASE_HXX |
| |
