AccessibleCsvControl.hxx

Go to the documentation of this file.

/* -*- 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 .
 */
 
#pragma once
 
#include <memory>
#include <com/sun/star/accessibility/AccessibleRole.hpp>
#include <com/sun/star/accessibility/AccessibleScrollType.hpp>
#include <com/sun/star/accessibility/XAccessibleText.hpp>
#include <com/sun/star/accessibility/XAccessibleTable.hpp>
#include <com/sun/star/accessibility/XAccessibleSelection.hpp>
#include <tools/gen.hxx>
#include <rtl/ref.hxx>
#include <rtl/ustrbuf.hxx>
#include <comphelper/accessiblecomponenthelper.hxx>
#include <cppuhelper/implbase1.hxx>
#include <cppuhelper/implbase2.hxx>
#include <cppuhelper/implbase3.hxx>
#include <editeng/AccessibleStaticTextBase.hxx>
#include <comphelper/uno3.hxx>
#include <map>
 
class ScCsvControl;
 
class ScAccessibleCsvControl : public comphelper::OAccessibleComponentHelper
{
private:
    ScCsvControl*               mpControl;          
 
public:
    explicit ScAccessibleCsvControl(ScCsvControl& rControl);
    virtual ~ScAccessibleCsvControl() override;
 
    virtual void SAL_CALL disposing() override;
 
    virtual void SAL_CALL grabFocus(  ) override;
    virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleAtPoint( const css::awt::Point& aPoint ) override;
 
    // events -----------------------------------------------------------------
public:
    virtual void SendFocusEvent( bool bFocused );
    virtual void SendCaretEvent();
    void SendVisibleEvent();
    void SendSelectionEvent();
    virtual void SendTableUpdateEvent( sal_uInt32 nFirstColumn, sal_uInt32 nLastColumn, bool bAllRows );
    virtual void SendInsertColumnEvent( sal_uInt32 nFirstColumn, sal_uInt32 nLastColumn );
    virtual void SendRemoveColumnEvent( sal_uInt32 nFirstColumn, sal_uInt32 nLastColumn );
 
    // helpers ----------------------------------------------------------------
protected:
    virtual css::awt::Rectangle implGetBounds() override;
 
    ScCsvControl& implGetControl() const;
 
    sal_Int64 implCreateStateSet();
};
 
class ScCsvRuler;
 
typedef ::cppu::ImplHelper2<css::accessibility::XAccessible,
                            css::accessibility::XAccessibleText> ScAccessibleCsvRulerImpl;
 
class ScAccessibleCsvRuler : public ScAccessibleCsvControl, public ScAccessibleCsvRulerImpl
{
private:
    OUStringBuffer       maBuffer;   
 
public:
    explicit                    ScAccessibleCsvRuler( ScCsvRuler& rRuler );
    virtual                     ~ScAccessibleCsvRuler() override;
 
    // XAccessibleComponent -----------------------------------------------------
    virtual css::uno::Reference< css::accessibility::XAccessibleContext > SAL_CALL getAccessibleContext(  ) override { return this; }
 
    virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleParent(  ) override;
 
    virtual OUString SAL_CALL getAccessibleDescription(  ) override;
    virtual OUString SAL_CALL getAccessibleName(  ) override;
 
    virtual sal_Int32 SAL_CALL getForeground(  ) override;
 
    virtual sal_Int32 SAL_CALL getBackground(  ) override;
 
    // XAccessibleContext -----------------------------------------------------
 
    virtual sal_Int32 SAL_CALL getAccessibleChildCount() override;
 
    virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleChild( sal_Int32 nIndex ) override;
 
    virtual sal_Int16 SAL_CALL getAccessibleRole(  ) override { return css::accessibility::AccessibleRole::TEXT; }
 
    virtual css::uno::Reference< css::accessibility::XAccessibleRelationSet > SAL_CALL getAccessibleRelationSet() override;
 
    virtual sal_Int64  SAL_CALL getAccessibleStateSet() override;
 
    // XAccessibleText --------------------------------------------------------
 
    virtual sal_Int32 SAL_CALL getCaretPosition() override;
 
    virtual sal_Bool SAL_CALL setCaretPosition( sal_Int32 nIndex ) override;
 
    virtual sal_Unicode SAL_CALL getCharacter( sal_Int32 nIndex ) override;
 
    virtual css::uno::Sequence< css::beans::PropertyValue > SAL_CALL getCharacterAttributes( sal_Int32 nIndex, const css::uno::Sequence< OUString >& aRequestedAttributes ) override;
 
    virtual css::awt::Rectangle SAL_CALL getCharacterBounds( sal_Int32 nIndex ) override;
 
    virtual sal_Int32 SAL_CALL getCharacterCount() override;
 
    virtual sal_Int32 SAL_CALL getIndexAtPoint( const css::awt::Point& rPoint ) override;
 
    virtual OUString SAL_CALL getSelectedText() override;
 
    virtual sal_Int32 SAL_CALL getSelectionStart() override;
 
    virtual sal_Int32 SAL_CALL getSelectionEnd() override;
 
    virtual sal_Bool SAL_CALL setSelection( sal_Int32 nStartIndex, sal_Int32 nEndIndex ) override;
 
    virtual OUString SAL_CALL getText() override;
 
    virtual OUString SAL_CALL getTextRange( sal_Int32 nStartIndex, sal_Int32 nEndIndex ) override;
 
    virtual css::accessibility::TextSegment SAL_CALL getTextAtIndex( sal_Int32 nIndex, sal_Int16 aTextType ) override;
    virtual css::accessibility::TextSegment SAL_CALL getTextBeforeIndex( sal_Int32 nIndex, sal_Int16 aTextType ) override;
    virtual css::accessibility::TextSegment SAL_CALL getTextBehindIndex( sal_Int32 nIndex, sal_Int16 aTextType ) override;
 
    virtual sal_Bool SAL_CALL copyText( sal_Int32 nStartIndex, sal_Int32 nEndIndex ) override;
 
    virtual sal_Bool SAL_CALL scrollSubstringTo( sal_Int32 nStartIndex, sal_Int32 nEndIndex, css::accessibility::AccessibleScrollType aScrollType) override;
 
    // XInterface -------------------------------------------------------------
 
    DECLARE_XINTERFACE()
 
    // XTypeProvider ----------------------------------------------------------
 
    DECLARE_XTYPEPROVIDER()
 
    // events -----------------------------------------------------------------
public:
    virtual void SendCaretEvent() override;
 
    // helpers ----------------------------------------------------------------
private:
 
    void ensureValidIndex( sal_Int32 nIndex ) const;
    void ensureValidIndexWithEnd( sal_Int32 nIndex ) const;
    void ensureValidRange( sal_Int32& rnStartIndex, sal_Int32& rnEndIndex ) const;
 
    ScCsvRuler& implGetRuler() const;
 
    void constructStringBuffer();
    sal_Int32 implGetTextLength() const;
 
    bool implHasSplit( sal_Int32 nApiPos );
 
    sal_Int32 implGetFirstEqualFormatted( sal_Int32 nApiPos );
    sal_Int32 implGetLastEqualFormatted( sal_Int32 nApiPos );
};
 
class ScCsvGrid;
class ScAccessibleCsvCell;
 
typedef ::cppu::ImplHelper3<
        css::accessibility::XAccessible,
        css::accessibility::XAccessibleTable,
        css::accessibility::XAccessibleSelection >
    ScAccessibleCsvGridImpl;
 
class ScAccessibleCsvGrid : public ScAccessibleCsvControl, public ScAccessibleCsvGridImpl
{
protected:
    typedef std::map< sal_Int32, rtl::Reference<ScAccessibleCsvCell> > XAccessibleSet;
 
private:
    XAccessibleSet maAccessibleChildren;
 
public:
    explicit                    ScAccessibleCsvGrid( ScCsvGrid& rGrid );
    virtual                     ~ScAccessibleCsvGrid() override;
    virtual void SAL_CALL       disposing() override;
 
    // XAccessibleComponent ---------------------------------------------------
    virtual css::uno::Reference< css::accessibility::XAccessibleContext > SAL_CALL getAccessibleContext(  ) override { return this; }
 
    virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleParent(  ) override;
 
    virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleAtPoint( const css::awt::Point& rPoint ) override;
 
    virtual OUString SAL_CALL getAccessibleDescription(  ) override;
    virtual OUString SAL_CALL getAccessibleName(  ) override;
 
    virtual sal_Int32 SAL_CALL getForeground(  ) override;
 
    virtual sal_Int32 SAL_CALL getBackground(  ) override;
 
    virtual sal_Int16 SAL_CALL getAccessibleRole(  ) override { return css::accessibility::AccessibleRole::TABLE; }
 
    // XAccessibleContext -----------------------------------------------------
 
    virtual sal_Int32 SAL_CALL getAccessibleChildCount() override;
 
    virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleChild( sal_Int32 nIndex ) override;
 
    virtual css::uno::Reference< css::accessibility::XAccessibleRelationSet > SAL_CALL getAccessibleRelationSet() override;
 
    virtual sal_Int64 SAL_CALL getAccessibleStateSet() override;
 
    // XAccessibleTable -------------------------------------------------------
 
    virtual sal_Int32 SAL_CALL getAccessibleRowCount() override;
 
    virtual sal_Int32 SAL_CALL getAccessibleColumnCount() override;
 
    virtual OUString SAL_CALL getAccessibleRowDescription( sal_Int32 nRow ) override;
 
    virtual OUString SAL_CALL getAccessibleColumnDescription( sal_Int32 nColumn ) override;
 
    virtual sal_Int32 SAL_CALL getAccessibleRowExtentAt( sal_Int32 nRow, sal_Int32 nColumn ) override;
 
    virtual sal_Int32 SAL_CALL getAccessibleColumnExtentAt( sal_Int32 nRow, sal_Int32 nColumn ) override;
 
    virtual css::uno::Reference< css::accessibility::XAccessibleTable > SAL_CALL getAccessibleRowHeaders() override;
 
    virtual css::uno::Reference< css::accessibility::XAccessibleTable > SAL_CALL getAccessibleColumnHeaders() override;
 
    virtual css::uno::Sequence< sal_Int32 > SAL_CALL getSelectedAccessibleRows() override;
 
    virtual css::uno::Sequence< sal_Int32 > SAL_CALL getSelectedAccessibleColumns() override;
 
    virtual sal_Bool SAL_CALL isAccessibleRowSelected( sal_Int32 nRow ) override;
 
    virtual sal_Bool SAL_CALL isAccessibleColumnSelected( sal_Int32 nColumn ) override;
 
    virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleCellAt( sal_Int32 nRow, sal_Int32 nColumn ) override;
 
    virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleCaption() override;
 
    virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleSummary() override;
 
    virtual sal_Bool SAL_CALL isAccessibleSelected( sal_Int32 nRow, sal_Int32 nColumn ) override;
 
    virtual sal_Int32 SAL_CALL getAccessibleIndex( sal_Int32 nRow, sal_Int32 nColumn ) override;
 
    virtual sal_Int32 SAL_CALL getAccessibleRow( sal_Int32 nChildIndex ) override;
 
    virtual sal_Int32 SAL_CALL getAccessibleColumn( sal_Int32 nChildIndex ) override;
 
    // XAccessibleSelection ---------------------------------------------------
 
    virtual void SAL_CALL selectAccessibleChild( sal_Int32 nChildIndex ) override;
 
    virtual sal_Bool SAL_CALL isAccessibleChildSelected( sal_Int32 nChildIndex ) override;
 
    virtual void SAL_CALL clearAccessibleSelection() override;
 
    virtual void SAL_CALL selectAllAccessibleChildren() override;
 
    virtual sal_Int32 SAL_CALL getSelectedAccessibleChildCount() override;
 
    virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getSelectedAccessibleChild( sal_Int32 nSelectedChildIndex ) override;
 
    virtual void SAL_CALL deselectAccessibleChild( sal_Int32 nSelectedChildIndex ) override;
 
    // XInterface -------------------------------------------------------------
 
    virtual css::uno::Any SAL_CALL queryInterface( const css::uno::Type& rType ) override;
 
    virtual void SAL_CALL acquire() noexcept override;
 
    virtual void SAL_CALL release() noexcept override;
 
    // XTypeProvider ----------------------------------------------------------
 
    virtual css::uno::Sequence< css::uno::Type > SAL_CALL getTypes() override;
 
    virtual css::uno::Sequence< sal_Int8 > SAL_CALL getImplementationId() override;
 
    // events -----------------------------------------------------------------
public:
    virtual void SendFocusEvent( bool bFocused ) override;
    virtual void SendTableUpdateEvent( sal_uInt32 nFirstColumn, sal_uInt32 nLastColumn, bool bAllRows ) override;
    virtual void SendInsertColumnEvent( sal_uInt32 nFirstColumn, sal_uInt32 nLastColumn ) override;
    virtual void SendRemoveColumnEvent( sal_uInt32 nFirstColumn, sal_uInt32 nLastColumn ) override;
 
    // helpers ----------------------------------------------------------------
private:
 
    void ensureValidIndex( sal_Int32 nIndex ) const;
    void ensureValidPosition( sal_Int32 nRow, sal_Int32 nColumn ) const;
 
    ScCsvGrid& implGetGrid() const;
 
    bool implIsColumnSelected( sal_Int32 nColumn ) const;
    void implSelectColumn( sal_Int32 nColumn, bool bSelect );
 
    sal_Int32 implGetRowCount() const;
    sal_Int32 implGetColumnCount() const;
    sal_Int32 implGetSelColumnCount() const;
    sal_Int32 implGetCellCount() const { return implGetRowCount() * implGetColumnCount(); }
 
    sal_Int32 implGetRow( sal_Int32 nIndex ) const { return nIndex / implGetColumnCount(); }
    sal_Int32 implGetColumn( sal_Int32 nIndex ) const { return nIndex % implGetColumnCount(); }
    sal_Int32 implGetSelColumn( sal_Int32 nSelColumn ) const;
    sal_Int32 implGetIndex( sal_Int32 nRow, sal_Int32 nColumn ) const { return nRow * implGetColumnCount() + nColumn; }
 
    OUString implGetCellText( sal_Int32 nRow, sal_Int32 nColumn ) const;
    rtl::Reference<ScAccessibleCsvCell> implCreateCellObj(sal_Int32 nRow, sal_Int32 nColumn);
 
    css::uno::Reference<css::accessibility::XAccessible> getAccessibleCell(sal_Int32 nRow, sal_Int32 nColumn);
};
 
class ScAccessibleCsvCell : public ScAccessibleCsvControl
                          , public cppu::ImplHelper1<css::accessibility::XAccessible>
                          , public ::accessibility::AccessibleStaticTextBase
{
protected:
    typedef ::std::unique_ptr< SvxEditSource >      SvxEditSourcePtr;
 
private:
    OUString                    maCellText; 
    sal_Int32                   mnLine;     
    sal_uInt32                  mnColumn;   
    sal_Int32                   mnIndex;    
 
public:
    explicit                    ScAccessibleCsvCell(
                                    ScCsvGrid& rGrid,
                                    OUString aCellText,
                                    sal_Int32 nRow, sal_Int32 nColumn);
    virtual                     ~ScAccessibleCsvCell() override;
 
    virtual void SAL_CALL       disposing() override;
 
    // XAccessibleComponent ---------------------------------------------------
 
    virtual void SAL_CALL grabFocus() override;
 
    virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleParent(  ) override;
 
    virtual css::uno::Reference< css::accessibility::XAccessibleContext > SAL_CALL getAccessibleContext(  ) override { return this; }
 
    virtual OUString SAL_CALL getAccessibleDescription(  ) override;
    virtual OUString SAL_CALL getAccessibleName(  ) override;
    virtual sal_Int16 SAL_CALL getAccessibleRole(  ) override { return css::accessibility::AccessibleRole::TEXT; }
 
    virtual sal_Int32 SAL_CALL getForeground(  ) override;
 
    virtual sal_Int32 SAL_CALL getBackground(  ) override;
 
    // XAccessibleContext -----------------------------------------------------
 
    virtual sal_Int32 SAL_CALL getAccessibleChildCount() override;
 
    virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleChild( sal_Int32 nIndex ) override;
 
    virtual sal_Int32 SAL_CALL getAccessibleIndexInParent() override;
 
    virtual css::uno::Reference< css::accessibility::XAccessibleRelationSet > SAL_CALL getAccessibleRelationSet() override;
 
    virtual sal_Int64 SAL_CALL getAccessibleStateSet() override;
 
    // XInterface -------------------------------------------------------------
 
    DECLARE_XINTERFACE()
 
    // XTypeProvider ----------------------------------------------------------
 
    DECLARE_XTYPEPROVIDER()
 
private:
    ScCsvGrid& implGetGrid() const;
    Point implGetRealPos() const;
    sal_uInt32 implCalcPixelWidth(sal_uInt32 nChars) const;
    Size implGetRealSize() const;
    virtual css::awt::Rectangle implGetBounds() override;
 
    ::std::unique_ptr< SvxEditSource > implCreateEditSource();
};
 
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */