xref: /AOO41X/main/accessibility/source/standard/accessiblemenucomponent.cxx (revision c82f28778d59b20a7e6c0f9982d1bc73807a432a)
1 /**************************************************************
2  *
3  * Licensed to the Apache Software Foundation (ASF) under one
4  * or more contributor license agreements.  See the NOTICE file
5  * distributed with this work for additional information
6  * regarding copyright ownership.  The ASF licenses this file
7  * to you under the Apache License, Version 2.0 (the
8  * "License"); you may not use this file except in compliance
9  * with the License.  You may obtain a copy of the License at
10  *
11  *   http://www.apache.org/licenses/LICENSE-2.0
12  *
13  * Unless required by applicable law or agreed to in writing,
14  * software distributed under the License is distributed on an
15  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16  * KIND, either express or implied.  See the License for the
17  * specific language governing permissions and limitations
18  * under the License.
19  *
20  *************************************************************/
21 
22 
23 
24 // MARKER(update_precomp.py): autogen include statement, do not remove
25 #include "precompiled_accessibility.hxx"
26 #include <accessibility/standard/accessiblemenucomponent.hxx>
27 
28 #include <toolkit/awt/vclxfont.hxx>
29 #include <toolkit/helper/convert.hxx>
30 
31 #include <com/sun/star/accessibility/AccessibleEventId.hpp>
32 #include <com/sun/star/accessibility/AccessibleRole.hpp>
33 #include <com/sun/star/accessibility/AccessibleStateType.hpp>
34 
35 #include <unotools/accessiblestatesethelper.hxx>
36 #include <unotools/accessiblerelationsethelper.hxx>
37 #include <cppuhelper/typeprovider.hxx>
38 #include <comphelper/sequence.hxx>
39 #include <vcl/svapp.hxx>
40 #include <vcl/window.hxx>
41 #include <vcl/menu.hxx>
42 #include <vcl/unohelp2.hxx>
43 
44 
45 using namespace ::com::sun::star::accessibility;
46 using namespace ::com::sun::star::uno;
47 using namespace ::com::sun::star::lang;
48 using namespace ::com::sun::star;
49 using namespace ::comphelper;
50 
51 
52 // -----------------------------------------------------------------------------
53 // class OAccessibleMenuComponent
54 // -----------------------------------------------------------------------------
55 
OAccessibleMenuComponent(Menu * pMenu)56 OAccessibleMenuComponent::OAccessibleMenuComponent( Menu* pMenu )
57     :OAccessibleMenuBaseComponent( pMenu )
58 {
59 }
60 
61 // -----------------------------------------------------------------------------
62 
~OAccessibleMenuComponent()63 OAccessibleMenuComponent::~OAccessibleMenuComponent()
64 {
65 }
66 
67 // -----------------------------------------------------------------------------
68 
IsEnabled()69 sal_Bool OAccessibleMenuComponent::IsEnabled()
70 {
71     return sal_True;
72 }
73 
74 // -----------------------------------------------------------------------------
75 
IsVisible()76 sal_Bool OAccessibleMenuComponent::IsVisible()
77 {
78     sal_Bool bVisible = sal_False;
79 
80     if ( m_pMenu )
81         bVisible = m_pMenu->IsMenuVisible();
82 
83     return bVisible;
84 }
85 
86 // -----------------------------------------------------------------------------
87 
FillAccessibleStateSet(utl::AccessibleStateSetHelper & rStateSet)88 void OAccessibleMenuComponent::FillAccessibleStateSet( utl::AccessibleStateSetHelper& rStateSet )
89 {
90     if ( IsEnabled() )
91     {
92         rStateSet.AddState( AccessibleStateType::ENABLED );
93         rStateSet.AddState( AccessibleStateType::SENSITIVE );
94     }
95 
96     rStateSet.AddState( AccessibleStateType::FOCUSABLE );
97 
98     if ( IsFocused() )
99         rStateSet.AddState( AccessibleStateType::FOCUSED );
100 
101     if ( IsVisible() )
102     {
103         rStateSet.AddState( AccessibleStateType::VISIBLE );
104         rStateSet.AddState( AccessibleStateType::SHOWING );
105     }
106 
107     rStateSet.AddState( AccessibleStateType::OPAQUE );
108 }
109 
110 // -----------------------------------------------------------------------------
111 // OCommonAccessibleComponent
112 // -----------------------------------------------------------------------------
113 
implGetBounds()114 awt::Rectangle OAccessibleMenuComponent::implGetBounds() throw (RuntimeException)
115 {
116     awt::Rectangle aBounds( 0, 0, 0, 0 );
117 
118     if ( m_pMenu )
119     {
120         Window* pWindow = m_pMenu->GetWindow();
121         if ( pWindow )
122         {
123             // get bounding rectangle of the window in screen coordinates
124             Rectangle aRect = pWindow->GetWindowExtentsRelative( NULL );
125             aBounds = AWTRectangle( aRect );
126 
127             // get position of the accessible parent in screen coordinates
128             Reference< XAccessible > xParent = getAccessibleParent();
129             if ( xParent.is() )
130             {
131                 Reference< XAccessibleComponent > xParentComponent( xParent->getAccessibleContext(), UNO_QUERY );
132                 if ( xParentComponent.is() )
133                 {
134                     awt::Point aParentScreenLoc = xParentComponent->getLocationOnScreen();
135 
136                     // calculate position of the window relative to the accessible parent
137                     aBounds.X -= aParentScreenLoc.X;
138                     aBounds.Y -= aParentScreenLoc.Y;
139                 }
140             }
141         }
142     }
143 
144     return aBounds;
145 }
146 
147 // -----------------------------------------------------------------------------
148 // XInterface
149 // -----------------------------------------------------------------------------
150 
IMPLEMENT_FORWARD_XINTERFACE2(OAccessibleMenuComponent,OAccessibleMenuBaseComponent,OAccessibleMenuComponent_BASE)151 IMPLEMENT_FORWARD_XINTERFACE2( OAccessibleMenuComponent, OAccessibleMenuBaseComponent, OAccessibleMenuComponent_BASE )
152 
153 // -----------------------------------------------------------------------------
154 // XTypeProvider
155 // -----------------------------------------------------------------------------
156 
157 IMPLEMENT_FORWARD_XTYPEPROVIDER2( OAccessibleMenuComponent, OAccessibleMenuBaseComponent, OAccessibleMenuComponent_BASE )
158 
159 // -----------------------------------------------------------------------------
160 // XAccessibleContext
161 // -----------------------------------------------------------------------------
162 
163 sal_Int32 OAccessibleMenuComponent::getAccessibleChildCount() throw (RuntimeException)
164 {
165     OExternalLockGuard aGuard( this );
166 
167     return GetChildCount();
168 }
169 
170 // -----------------------------------------------------------------------------
171 
getAccessibleChild(sal_Int32 i)172 Reference< XAccessible > OAccessibleMenuComponent::getAccessibleChild( sal_Int32 i ) throw (IndexOutOfBoundsException, RuntimeException)
173 {
174     OExternalLockGuard aGuard( this );
175 
176     if ( i < 0 || i >= GetChildCount() )
177         throw IndexOutOfBoundsException();
178 
179     return GetChild( i );
180 }
181 
182 // -----------------------------------------------------------------------------
183 
getAccessibleParent()184 Reference< XAccessible > OAccessibleMenuComponent::getAccessibleParent(  ) throw (RuntimeException)
185 {
186     OExternalLockGuard aGuard( this );
187 
188     Reference< XAccessible > xParent;
189 
190     if ( m_pMenu )
191     {
192         Window* pWindow = m_pMenu->GetWindow();
193         if ( pWindow )
194         {
195             Window* pParent = pWindow->GetAccessibleParentWindow();
196             if ( pParent )
197                 xParent = pParent->GetAccessible();
198         }
199     }
200 
201     return xParent;
202 }
203 
204 // -----------------------------------------------------------------------------
205 
getAccessibleRole()206 sal_Int16 OAccessibleMenuComponent::getAccessibleRole(  ) throw (RuntimeException)
207 {
208     OExternalLockGuard aGuard( this );
209 
210     return AccessibleRole::UNKNOWN;
211 }
212 
213 // -----------------------------------------------------------------------------
214 
getAccessibleDescription()215 ::rtl::OUString OAccessibleMenuComponent::getAccessibleDescription( ) throw (RuntimeException)
216 {
217     OExternalLockGuard aGuard( this );
218 
219     ::rtl::OUString sDescription;
220     if ( m_pMenu )
221     {
222         Window* pWindow = m_pMenu->GetWindow();
223         if ( pWindow )
224             sDescription = pWindow->GetAccessibleDescription();
225     }
226 
227     return sDescription;
228 }
229 
230 // -----------------------------------------------------------------------------
231 
getAccessibleName()232 ::rtl::OUString OAccessibleMenuComponent::getAccessibleName(  ) throw (RuntimeException)
233 {
234     OExternalLockGuard aGuard( this );
235 
236     return ::rtl::OUString();
237 }
238 
239 // -----------------------------------------------------------------------------
240 
getAccessibleRelationSet()241 Reference< XAccessibleRelationSet > OAccessibleMenuComponent::getAccessibleRelationSet(  ) throw (RuntimeException)
242 {
243     OExternalLockGuard aGuard( this );
244 
245     utl::AccessibleRelationSetHelper* pRelationSetHelper = new utl::AccessibleRelationSetHelper;
246     Reference< XAccessibleRelationSet > xSet = pRelationSetHelper;
247     return xSet;
248 }
249 
250 // -----------------------------------------------------------------------------
251 
getLocale()252 Locale OAccessibleMenuComponent::getLocale(  ) throw (IllegalAccessibleComponentStateException, RuntimeException)
253 {
254     OExternalLockGuard aGuard( this );
255 
256     return Application::GetSettings().GetLocale();
257 }
258 
259 // -----------------------------------------------------------------------------
260 // XAccessibleComponent
261 // -----------------------------------------------------------------------------
262 
getAccessibleAtPoint(const awt::Point & rPoint)263 Reference< XAccessible > OAccessibleMenuComponent::getAccessibleAtPoint( const awt::Point& rPoint ) throw (RuntimeException)
264 {
265     OExternalLockGuard aGuard( this );
266 
267     return GetChildAt( rPoint );
268 }
269 
270 // -----------------------------------------------------------------------------
271 
getLocationOnScreen()272 awt::Point OAccessibleMenuComponent::getLocationOnScreen(  ) throw (RuntimeException)
273 {
274     OExternalLockGuard aGuard( this );
275 
276     awt::Point aPos;
277 
278     if ( m_pMenu )
279     {
280         Window* pWindow = m_pMenu->GetWindow();
281         if ( pWindow )
282         {
283             Rectangle aRect = pWindow->GetWindowExtentsRelative( NULL );
284             aPos = AWTPoint( aRect.TopLeft() );
285         }
286     }
287 
288     return aPos;
289 }
290 
291 // -----------------------------------------------------------------------------
292 
grabFocus()293 void OAccessibleMenuComponent::grabFocus(  ) throw (RuntimeException)
294 {
295     OExternalLockGuard aGuard( this );
296 
297     if ( m_pMenu )
298     {
299         Window* pWindow = m_pMenu->GetWindow();
300         if ( pWindow )
301             pWindow->GrabFocus();
302     }
303 }
304 
305 // -----------------------------------------------------------------------------
306 
getForeground()307 sal_Int32 OAccessibleMenuComponent::getForeground(  ) throw (RuntimeException)
308 {
309     OExternalLockGuard aGuard( this );
310 
311     const StyleSettings& rStyleSettings = Application::GetSettings().GetStyleSettings();
312     sal_Int32 nColor = rStyleSettings.GetMenuTextColor().GetColor();
313 
314     return nColor;
315 }
316 
317 // -----------------------------------------------------------------------------
318 
getBackground()319 sal_Int32 OAccessibleMenuComponent::getBackground(  ) throw (RuntimeException)
320 {
321     OExternalLockGuard aGuard( this );
322 
323     return 0;
324 }
325 
326 // -----------------------------------------------------------------------------
327 // XAccessibleExtendedComponent
328 // -----------------------------------------------------------------------------
329 
getFont()330 Reference< awt::XFont > OAccessibleMenuComponent::getFont(  ) throw (RuntimeException)
331 {
332     OExternalLockGuard aGuard( this );
333 
334     Reference< awt::XFont > xFont;
335 
336     if ( m_pMenu )
337     {
338         Window* pWindow = m_pMenu->GetWindow();
339         if ( pWindow )
340         {
341             Reference< awt::XDevice > xDev( pWindow->GetComponentInterface(), UNO_QUERY );
342             if ( xDev.is() )
343             {
344                 const StyleSettings& rStyleSettings = Application::GetSettings().GetStyleSettings();
345                 VCLXFont* pVCLXFont = new VCLXFont;
346                 pVCLXFont->Init( *xDev.get(), rStyleSettings.GetMenuFont() );
347                 xFont = pVCLXFont;
348             }
349         }
350     }
351 
352     return xFont;
353 }
354 
355 // -----------------------------------------------------------------------------
356 
getTitledBorderText()357 ::rtl::OUString OAccessibleMenuComponent::getTitledBorderText(  ) throw (RuntimeException)
358 {
359     OExternalLockGuard aGuard( this );
360 
361     return ::rtl::OUString();
362 }
363 
364 // -----------------------------------------------------------------------------
365 
getToolTipText()366 ::rtl::OUString OAccessibleMenuComponent::getToolTipText(  ) throw (RuntimeException)
367 {
368     OExternalLockGuard aGuard( this );
369 
370     return ::rtl::OUString();
371 }
372 
373 // -----------------------------------------------------------------------------
374 // XAccessibleSelection
375 // -----------------------------------------------------------------------------
376 
selectAccessibleChild(sal_Int32 nChildIndex)377 void OAccessibleMenuComponent::selectAccessibleChild( sal_Int32 nChildIndex ) throw (IndexOutOfBoundsException, RuntimeException)
378 {
379     OExternalLockGuard aGuard( this );
380 
381     if ( nChildIndex < 0 || nChildIndex >= GetChildCount() )
382         throw IndexOutOfBoundsException();
383 
384     SelectChild( nChildIndex );
385 }
386 
387 // -----------------------------------------------------------------------------
388 
isAccessibleChildSelected(sal_Int32 nChildIndex)389 sal_Bool OAccessibleMenuComponent::isAccessibleChildSelected( sal_Int32 nChildIndex ) throw (IndexOutOfBoundsException, RuntimeException)
390 {
391     OExternalLockGuard aGuard( this );
392 
393     if ( nChildIndex < 0 || nChildIndex >= GetChildCount() )
394         throw IndexOutOfBoundsException();
395 
396     return IsChildSelected( nChildIndex );
397 }
398 
399 // -----------------------------------------------------------------------------
400 
clearAccessibleSelection()401 void OAccessibleMenuComponent::clearAccessibleSelection(  ) throw (RuntimeException)
402 {
403     OExternalLockGuard aGuard( this );
404 
405     DeSelectAll();
406 }
407 
408 // -----------------------------------------------------------------------------
409 
selectAllAccessibleChildren()410 void OAccessibleMenuComponent::selectAllAccessibleChildren(  ) throw (RuntimeException)
411 {
412     // This method makes no sense in a menu, and so does nothing.
413 }
414 
415 // -----------------------------------------------------------------------------
416 
getSelectedAccessibleChildCount()417 sal_Int32 OAccessibleMenuComponent::getSelectedAccessibleChildCount(  ) throw (RuntimeException)
418 {
419     OExternalLockGuard aGuard( this );
420 
421     sal_Int32 nRet = 0;
422 
423     for ( sal_Int32 i = 0, nCount = GetChildCount(); i < nCount; i++ )
424     {
425         if ( IsChildSelected( i ) )
426             ++nRet;
427     }
428 
429     return nRet;
430 }
431 
432 // -----------------------------------------------------------------------------
433 
getSelectedAccessibleChild(sal_Int32 nSelectedChildIndex)434 Reference< XAccessible > OAccessibleMenuComponent::getSelectedAccessibleChild( sal_Int32 nSelectedChildIndex ) throw (IndexOutOfBoundsException, RuntimeException)
435 {
436     OExternalLockGuard aGuard( this );
437 
438     if ( nSelectedChildIndex < 0 || nSelectedChildIndex >= getSelectedAccessibleChildCount() )
439         throw IndexOutOfBoundsException();
440 
441     Reference< XAccessible > xChild;
442 
443     for ( sal_Int32 i = 0, j = 0, nCount = GetChildCount(); i < nCount; i++ )
444     {
445         if ( IsChildSelected( i ) && ( j++ == nSelectedChildIndex ) )
446         {
447             xChild = GetChild( i );
448             break;
449         }
450     }
451 
452     return xChild;
453 }
454 
455 // -----------------------------------------------------------------------------
456 
deselectAccessibleChild(sal_Int32 nChildIndex)457 void OAccessibleMenuComponent::deselectAccessibleChild( sal_Int32 nChildIndex ) throw (IndexOutOfBoundsException, RuntimeException)
458 {
459     OExternalLockGuard aGuard( this );
460 
461     if ( nChildIndex < 0 || nChildIndex >= GetChildCount() )
462         throw IndexOutOfBoundsException();
463 
464     DeSelectAll();
465 }
466 
467 // -----------------------------------------------------------------------------
468