LibreOffice Module accessibility (master) 1
vclxaccessiblelist.hxx
Go to the documentation of this file.
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#pragma once
21
22#include <memory>
23#include <vector>
24#include <com/sun/star/accessibility/XAccessibleSelection.hpp>
27
28typedef std::vector< css::uno::WeakReference< css::accessibility::XAccessible > >
30
31namespace accessibility
32{
33 class IComboListBoxHelper;
34}
35
36
43 : public cppu::ImplInheritanceHelper<
44 VCLXAccessibleComponent,
45 css::accessibility::XAccessible,
46 css::accessibility::XAccessibleSelection>
47{
48public:
50
51 VCLXAccessibleList (VCLXWindow* pVCLXindow, BoxType aBoxType,
52 const css::uno::Reference<
53 css::accessibility::XAccessible >& _xParent);
54
58 void SetIndexInParent (sal_Int32 nIndex);
59
62 virtual void ProcessWindowEvent (const VclWindowEvent& rVclWindowEvent) override;
63 virtual void FillAccessibleRelationSet( utl::AccessibleRelationSetHelper& rRelationSet ) override;
64
74 void UpdateSelection (std::u16string_view sTextOfSelectedItem);
75
76 // XAccessible
77 virtual css::uno::Reference< css::accessibility::XAccessibleContext> SAL_CALL
78 getAccessibleContext() override;
79
80 // XAccessibleContext
81 virtual sal_Int64 SAL_CALL getAccessibleChildCount() override final;
82 css::uno::Reference< css::accessibility::XAccessible> SAL_CALL
83 getAccessibleChild (sal_Int64 i) override;
84 virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL
85 getAccessibleParent( ) override;
86
90 virtual sal_Int64 SAL_CALL getAccessibleIndexInParent() override;
91 virtual sal_Int16 SAL_CALL getAccessibleRole() override;
92
93 // XServiceInfo
94 virtual OUString SAL_CALL getImplementationName() override;
95 // Return list specific services.
96 virtual css::uno::Sequence< OUString > SAL_CALL
97 getSupportedServiceNames() override;
98
99 // XAccessibleSelection
100 virtual void SAL_CALL selectAccessibleChild( sal_Int64 nChildIndex ) override;
101 virtual sal_Bool SAL_CALL isAccessibleChildSelected( sal_Int64 nChildIndex ) override;
102 virtual void SAL_CALL clearAccessibleSelection( ) override;
103 virtual void SAL_CALL selectAllAccessibleChildren( ) override;
104 virtual sal_Int64 SAL_CALL getSelectedAccessibleChildCount( ) override;
105 virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getSelectedAccessibleChild( sal_Int64 nSelectedChildIndex ) override;
106 virtual void SAL_CALL deselectAccessibleChild( sal_Int64 nSelectedChildIndex ) override;
107
108 virtual css::awt::Point SAL_CALL getLocationOnScreen( ) override;
109 bool IsInDropDown() const;
110 void HandleDropOpen();
111 void ProcessWindowEvent (const VclWindowEvent& rVclWindowEvent, bool b_IsDropDownList);
112 void UpdateSelection_Acc (std::u16string_view sTextOfSelectedItem, bool b_IsDropDownList);
113 void UpdateSelection_Impl_Acc (bool b_IsDropDownList);
114
115 static void NotifyListItem(css::uno::Any const & val);
116 ::accessibility::IComboListBoxHelper* getListBoxHelper() { return m_pListBoxHelper.get(); }
117private:
119 std::unique_ptr<::accessibility::IComboListBoxHelper> m_pListBoxHelper;
129
130
131 virtual ~VCLXAccessibleList() override = default;
132
133 sal_Int64 implGetAccessibleChildCount();
134
138 virtual void SAL_CALL disposing() override;
139
145 virtual void FillAccessibleStateSet (sal_Int64& rStateSet) override;
146
150 css::uno::Reference< css::accessibility::XAccessible >
151 CreateChild (sal_Int32 i);
152
157
158 // VCLXAccessibleComponent
159 virtual css::awt::Rectangle implGetBounds( ) override;
160
164 css::uno::Reference< css::accessibility::XAccessible > m_xParent;
165
167 void UpdateSelection_Impl(sal_Int32 nPos = 0);
168 bool checkEntrySelected(sal_Int32 _nPos,
169 css::uno::Any& _rNewValue,
170 css::uno::Reference< css::accessibility::XAccessible >& _rxNewAcc);
171 void notifyVisibleStates(bool _bSetNew );
173};
174
175
176/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
Base class for the list contained in list- and combo boxes.
virtual void FillAccessibleStateSet(sal_Int64 &rStateSet) override
This method adds the states AccessibleStateType::FOCUSABLE and possibly AccessibleStateType::MULTI_SE...
virtual void SAL_CALL selectAccessibleChild(sal_Int64 nChildIndex) override
virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getSelectedAccessibleChild(sal_Int64 nSelectedChildIndex) override
::accessibility::IComboListBoxHelper * getListBoxHelper()
virtual sal_Int16 SAL_CALL getAccessibleRole() override
static void NotifyListItem(css::uno::Any const &val)
void notifyVisibleStates(bool _bSetNew)
virtual void FillAccessibleRelationSet(utl::AccessibleRelationSetHelper &rRelationSet) override
void UpdateSelection(std::u16string_view sTextOfSelectedItem)
Called on reception of selection events this method checks all known list items for a possible change...
css::uno::Reference< css::accessibility::XAccessible > m_xParent
We need to save the accessible parent to return it in getAccessibleParent(), because this method of t...
virtual void SAL_CALL deselectAccessibleChild(sal_Int64 nSelectedChildIndex) override
virtual void SAL_CALL disposing() override
This function is called from the implementation helper during a XComponent::dispose call.
sal_Int32 m_nIndexInParent
Index in parent. This is settable from the outside.
void UpdateSelection_Impl_Acc(bool b_IsDropDownList)
void HandleChangedItemList()
Call this method when the item list has been changed, i.e.
void UpdateSelection_Impl(sal_Int32 nPos=0)
virtual ~VCLXAccessibleList() override=default
virtual sal_Int64 SAL_CALL getSelectedAccessibleChildCount() override
bool checkEntrySelected(sal_Int32 _nPos, css::uno::Any &_rNewValue, css::uno::Reference< css::accessibility::XAccessible > &_rxNewAcc)
virtual sal_Bool SAL_CALL isAccessibleChildSelected(sal_Int64 nChildIndex) override
virtual css::awt::Rectangle implGetBounds() override
void SetIndexInParent(sal_Int32 nIndex)
The index that is passed to this method is returned on following calls to getAccessibleIndexInParent.
virtual sal_Int64 SAL_CALL getAccessibleChildCount() override final
virtual void SAL_CALL selectAllAccessibleChildren() override
std::unique_ptr<::accessibility::IComboListBoxHelper > m_pListBoxHelper
css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleChild(sal_Int64 i) override
virtual OUString SAL_CALL getImplementationName() override
css::uno::Reference< css::accessibility::XAccessible > CreateChild(sal_Int32 i)
Create the specified child and insert it into the list of children.
virtual sal_Int64 SAL_CALL getAccessibleIndexInParent() override
The index returned as index in parent is always the one set with the SetIndexInParent() method.
void UpdateSelection_Acc(std::u16string_view sTextOfSelectedItem, bool b_IsDropDownList)
virtual css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleParent() override
virtual void SAL_CALL clearAccessibleSelection() override
VCLXAccessibleList(VCLXWindow *pVCLXindow, BoxType aBoxType, const css::uno::Reference< css::accessibility::XAccessible > &_xParent)
virtual css::uno::Reference< css::accessibility::XAccessibleContext > SAL_CALL getAccessibleContext() override
virtual css::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames() override
virtual css::awt::Point SAL_CALL getLocationOnScreen() override
sal_Int64 implGetAccessibleChildCount()
virtual void ProcessWindowEvent(const VclWindowEvent &rVclWindowEvent) override
Process some of the events and delegate the rest to the base classes.
unsigned char sal_Bool
std::vector< css::uno::WeakReference< css::accessibility::XAccessible > > ListItems
std::vector< css::uno::WeakReference< css::accessibility::XAccessible > > ListItems