strepsirrhini/office-gobmx
9
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
office-gobmx/vcl/osx/a11yrolehelper.mm
Jim Raykowski 947fe0d89d tdf#119788 tdf#117173 add accessibility NOTIFICATION role 
and use it to make screen readers announce notifications from the
'Find and Replace' dialog

Change-Id: Ifcf9304883e2e824ea1b7998d7767e474b87c8b6
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/139709
Tested-by: Jenkins
Reviewed-by: Michael Weghorn <m.weghorn@posteo.de>
2022-09-26 05:55:25 +02:00

284 lines
14 KiB
Text
Raw Blame History

/* -*- 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 .
*/
#include <osx/a11yfactory.h>
#include "a11yrolehelper.h"
#include <com/sun/star/accessibility/AccessibleRole.hpp>
#include <com/sun/star/accessibility/AccessibleStateType.hpp>
using namespace ::com::sun::star::accessibility;
using namespace ::com::sun::star::uno;
@implementation AquaA11yRoleHelper
+(id)simpleMapNativeRoleFrom: (XAccessibleContext *) accessibleContext {
id nativeRole = nil;
if (accessibleContext == nullptr)
return nativeRole;
switch( accessibleContext -> getAccessibleRole() ) {
#define MAP(a,b) \
case a: nativeRole = b; break
MAP( AccessibleRole::UNKNOWN, NSAccessibilityUnknownRole );
MAP( AccessibleRole::ALERT, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::COLUMN_HEADER, NSAccessibilityColumnRole );
MAP( AccessibleRole::CANVAS, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::CHECK_BOX, NSAccessibilityCheckBoxRole );
MAP( AccessibleRole::CHECK_MENU_ITEM, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::COLOR_CHOOSER, NSAccessibilityColorWellRole ); // FIXME
MAP( AccessibleRole::COMBO_BOX, NSAccessibilityComboBoxRole );
MAP( AccessibleRole::DATE_EDITOR, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::DESKTOP_ICON, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::DESKTOP_PANE, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::DIRECTORY_PANE, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::DIALOG, NSAccessibilityGroupRole );
MAP( AccessibleRole::DOCUMENT, NSAccessibilityGroupRole );
MAP( AccessibleRole::EMBEDDED_OBJECT, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::END_NOTE, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::FILE_CHOOSER, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::FILLER, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::FONT_CHOOSER, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::FOOTER, NSAccessibilityGroupRole ); // FIXME
MAP( AccessibleRole::FOOTNOTE, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::FRAME, NSAccessibilityWindowRole );
MAP( AccessibleRole::GLASS_PANE, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::GRAPHIC, NSAccessibilityImageRole );
MAP( AccessibleRole::GROUP_BOX, NSAccessibilityGroupRole );
MAP( AccessibleRole::HEADER, NSAccessibilityGroupRole ); // FIXME
MAP( AccessibleRole::HEADING, NSAccessibilityTextAreaRole ); // FIXME
MAP( AccessibleRole::HYPER_LINK, NSAccessibilityLinkRole );
MAP( AccessibleRole::ICON, NSAccessibilityImageRole );
MAP( AccessibleRole::INTERNAL_FRAME, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::LABEL, NSAccessibilityStaticTextRole );
MAP( AccessibleRole::LAYERED_PANE, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::LIST, NSAccessibilityMenuRole );
MAP( AccessibleRole::LIST_ITEM, NSAccessibilityMenuItemRole );
MAP( AccessibleRole::MENU, NSAccessibilityMenuRole );
MAP( AccessibleRole::MENU_BAR, NSAccessibilityMenuBarRole );
MAP( AccessibleRole::MENU_ITEM, NSAccessibilityMenuItemRole );
MAP( AccessibleRole::OPTION_PANE, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::PAGE_TAB, NSAccessibilityButtonRole );
MAP( AccessibleRole::PAGE_TAB_LIST, NSAccessibilityTabGroupRole );
MAP( AccessibleRole::PANEL, NSAccessibilityGroupRole );
MAP( AccessibleRole::PARAGRAPH, NSAccessibilityTextAreaRole );
MAP( AccessibleRole::PASSWORD_TEXT, NSAccessibilityTextFieldRole );
MAP( AccessibleRole::POPUP_MENU, NSAccessibilityMenuRole );
MAP( AccessibleRole::PUSH_BUTTON, NSAccessibilityButtonRole );
MAP( AccessibleRole::PROGRESS_BAR, NSAccessibilityProgressIndicatorRole );
MAP( AccessibleRole::RADIO_BUTTON, NSAccessibilityRadioButtonRole );
MAP( AccessibleRole::RADIO_MENU_ITEM, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::ROW_HEADER, NSAccessibilityRowRole );
MAP( AccessibleRole::ROOT_PANE, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::SCROLL_BAR, NSAccessibilityScrollBarRole );
MAP( AccessibleRole::SCROLL_PANE, NSAccessibilityScrollAreaRole );
MAP( AccessibleRole::SHAPE, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::SEPARATOR, NSAccessibilitySplitterRole ); // FIXME
MAP( AccessibleRole::SLIDER, NSAccessibilitySliderRole );
MAP( AccessibleRole::SPIN_BOX, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::SPLIT_PANE, NSAccessibilitySplitGroupRole );
MAP( AccessibleRole::STATUS_BAR, NSAccessibilityGroupRole ); // FIXME
MAP( AccessibleRole::TABLE, NSAccessibilityTableRole );
MAP( AccessibleRole::TABLE_CELL, NSAccessibilityTextFieldRole );
MAP( AccessibleRole::TEXT, NSAccessibilityTextAreaRole );
MAP( AccessibleRole::TEXT_FRAME, NSAccessibilityGroupRole );
MAP( AccessibleRole::TOGGLE_BUTTON, NSAccessibilityCheckBoxRole );
MAP( AccessibleRole::TOOL_BAR, NSAccessibilityToolbarRole );
MAP( AccessibleRole::TOOL_TIP, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::TREE, NSAccessibilityGroupRole );
MAP( AccessibleRole::VIEW_PORT, NSAccessibilityUnknownRole ); // FIXME
MAP( AccessibleRole::WINDOW, NSAccessibilityWindowRole );
MAP( AccessibleRole::BUTTON_DROPDOWN, NSAccessibilityMenuButtonRole );
MAP( AccessibleRole::BUTTON_MENU, NSAccessibilityMenuButtonRole );
MAP( AccessibleRole::CAPTION, NSAccessibilityUnknownRole );
MAP( AccessibleRole::CHART, NSAccessibilityUnknownRole );
MAP( AccessibleRole::FORM, NSAccessibilityUnknownRole );
MAP( AccessibleRole::IMAGE_MAP, NSAccessibilityUnknownRole );
MAP( AccessibleRole::NOTE, NSAccessibilityUnknownRole );
MAP( AccessibleRole::PAGE, NSAccessibilityUnknownRole );
MAP( AccessibleRole::RULER, NSAccessibilityUnknownRole );
MAP( AccessibleRole::SECTION, NSAccessibilityUnknownRole );
MAP( AccessibleRole::TREE_ITEM, NSAccessibilityUnknownRole );
MAP( AccessibleRole::TREE_TABLE, NSAccessibilityUnknownRole );
MAP( AccessibleRole::DOCUMENT_PRESENTATION, NSAccessibilityGroupRole );
MAP( AccessibleRole::DOCUMENT_SPREADSHEET, NSAccessibilityGroupRole );
MAP( AccessibleRole::DOCUMENT_TEXT, NSAccessibilityGroupRole );
MAP( AccessibleRole::STATIC, NSAccessibilityStaticTextRole );
MAP( AccessibleRole::NOTIFICATION, NSAccessibilityStaticTextRole );
#undef MAP
default:
break;
}
return nativeRole;
}
+(id)getNativeRoleFrom: (XAccessibleContext *) accessibleContext {
id nativeRole = [ AquaA11yRoleHelper simpleMapNativeRoleFrom: accessibleContext ];
if ( accessibleContext -> getAccessibleRole() == AccessibleRole::LABEL ) {
if ( accessibleContext -> getAccessibleChildCount() > 0 ) {
[ nativeRole release ];
nativeRole = NSAccessibilityOutlineRole;
} else if ( accessibleContext -> getAccessibleParent().is() ) {
Reference < XAccessibleContext > rxParentContext = accessibleContext -> getAccessibleParent() -> getAccessibleContext();
if ( rxParentContext.is() ) {
NSString * roleParent = static_cast<NSString *>([ AquaA11yRoleHelper simpleMapNativeRoleFrom: rxParentContext.get() ]);
if ( [ roleParent isEqualToString: NSAccessibilityOutlineRole ] ) {
[ nativeRole release ];
nativeRole = NSAccessibilityRowRole;
}
[ roleParent release ];
}
}
} else if ( accessibleContext -> getAccessibleRole() == AccessibleRole::COMBO_BOX ) {
Reference < XAccessible > rxAccessible = accessibleContext -> getAccessibleChild(0);
if ( rxAccessible.is() ) {
Reference < XAccessibleContext > rxAccessibleContext = rxAccessible -> getAccessibleContext();
if ( rxAccessibleContext.is() && rxAccessibleContext -> getAccessibleRole() == AccessibleRole::TEXT ) {
sal_Int64 nStateSet = rxAccessibleContext -> getAccessibleStateSet();
if ( !(nStateSet & AccessibleStateType::EDITABLE ) ) {
[ nativeRole release ];
nativeRole = NSAccessibilityPopUpButtonRole;
}
}
}
}
return nativeRole;
}
+(id)getNativeSubroleFrom: (sal_Int16) nRole {
id nativeSubrole = nil;
switch( nRole ) {
#define MAP(a,b) \
case a: nativeSubrole = b; break
MAP( AccessibleRole::UNKNOWN, NSAccessibilityUnknownSubrole );
MAP( AccessibleRole::ALERT, NSAccessibilitySystemDialogSubrole );
MAP( AccessibleRole::COLUMN_HEADER, @"" );
MAP( AccessibleRole::CANVAS, @"" );
MAP( AccessibleRole::CHECK_BOX, @"" );
MAP( AccessibleRole::CHECK_MENU_ITEM, @"" );
MAP( AccessibleRole::COLOR_CHOOSER, @"" );
MAP( AccessibleRole::COMBO_BOX, @"" );
MAP( AccessibleRole::DATE_EDITOR, @"" );
MAP( AccessibleRole::DESKTOP_ICON, @"" );
MAP( AccessibleRole::DESKTOP_PANE, @"" );
MAP( AccessibleRole::DIRECTORY_PANE, @"" );
MAP( AccessibleRole::DIALOG, NSAccessibilityDialogSubrole );
MAP( AccessibleRole::DOCUMENT, @"" );
MAP( AccessibleRole::EMBEDDED_OBJECT, @"" );
MAP( AccessibleRole::END_NOTE, @"" );
MAP( AccessibleRole::FILE_CHOOSER, @"" );
MAP( AccessibleRole::FILLER, @"" );
MAP( AccessibleRole::FONT_CHOOSER, @"" );
MAP( AccessibleRole::FOOTER, @"" );
MAP( AccessibleRole::FOOTNOTE, @"" );
MAP( AccessibleRole::FRAME, @"" );
MAP( AccessibleRole::GLASS_PANE, @"" );
MAP( AccessibleRole::GRAPHIC, @"" );
MAP( AccessibleRole::GROUP_BOX, @"" );
MAP( AccessibleRole::HEADER, @"" );
MAP( AccessibleRole::HEADING, @"" );
MAP( AccessibleRole::HYPER_LINK, NSAccessibilityTextLinkSubrole );
MAP( AccessibleRole::ICON, @"" );
MAP( AccessibleRole::INTERNAL_FRAME, @"" );
MAP( AccessibleRole::LABEL, @"" );
MAP( AccessibleRole::LAYERED_PANE, @"" );
MAP( AccessibleRole::LIST, @"" );
MAP( AccessibleRole::LIST_ITEM, NSAccessibilityOutlineRowSubrole );
MAP( AccessibleRole::MENU, @"" );
MAP( AccessibleRole::MENU_BAR, @"" );
MAP( AccessibleRole::MENU_ITEM, @"" );
MAP( AccessibleRole::OPTION_PANE, @"" );
MAP( AccessibleRole::PAGE_TAB, @"" );
MAP( AccessibleRole::PAGE_TAB_LIST, @"" );
MAP( AccessibleRole::PANEL, @"" );
MAP( AccessibleRole::PARAGRAPH, @"" );
MAP( AccessibleRole::PASSWORD_TEXT, NSAccessibilitySecureTextFieldSubrole );
MAP( AccessibleRole::POPUP_MENU, @"" );
MAP( AccessibleRole::PUSH_BUTTON, @"" );
MAP( AccessibleRole::PROGRESS_BAR, @"" );
MAP( AccessibleRole::RADIO_BUTTON, @"" );
MAP( AccessibleRole::RADIO_MENU_ITEM, @"" );
MAP( AccessibleRole::ROW_HEADER, @"" );
MAP( AccessibleRole::ROOT_PANE, @"" );
MAP( AccessibleRole::SCROLL_BAR, @"" );
MAP( AccessibleRole::SCROLL_PANE, @"" );
MAP( AccessibleRole::SHAPE, @"" );
MAP( AccessibleRole::SEPARATOR, @"" );
MAP( AccessibleRole::SLIDER, @"" );
MAP( AccessibleRole::SPIN_BOX, @"" );
MAP( AccessibleRole::SPLIT_PANE, @"" );
MAP( AccessibleRole::STATUS_BAR, @"" );
MAP( AccessibleRole::TABLE, @"" );
MAP( AccessibleRole::TABLE_CELL, @"" );
MAP( AccessibleRole::TEXT, @"" );
MAP( AccessibleRole::TEXT_FRAME, @"" );
MAP( AccessibleRole::TOGGLE_BUTTON, @"" );
MAP( AccessibleRole::TOOL_BAR, @"" );
MAP( AccessibleRole::TOOL_TIP, @"" );
MAP( AccessibleRole::TREE, @"" );
MAP( AccessibleRole::VIEW_PORT, @"" );
MAP( AccessibleRole::WINDOW, NSAccessibilityStandardWindowSubrole );
MAP( AccessibleRole::BUTTON_DROPDOWN, @"" );
MAP( AccessibleRole::BUTTON_MENU, @"" );
MAP( AccessibleRole::CAPTION, @"" );
MAP( AccessibleRole::CHART, @"" );
MAP( AccessibleRole::FORM, @"" );
MAP( AccessibleRole::IMAGE_MAP, @"" );
MAP( AccessibleRole::NOTE, @"" );
MAP( AccessibleRole::PAGE, @"" );
MAP( AccessibleRole::RULER, @"" );
MAP( AccessibleRole::SECTION, @"" );
MAP( AccessibleRole::TREE_ITEM, @"" );
MAP( AccessibleRole::TREE_TABLE, @"" );
MAP( AccessibleRole::DOCUMENT_PRESENTATION, @"" );
MAP( AccessibleRole::DOCUMENT_SPREADSHEET, @"" );
MAP( AccessibleRole::DOCUMENT_TEXT, @"" );
MAP( AccessibleRole::STATIC, @"" );
MAP( AccessibleRole::NOTIFICATION, @"" );
#undef MAP
default:
break;
}
return nativeSubrole;
}
+(id)getRoleDescriptionFrom: (NSString *) role with: (NSString *) subRole {
id roleDescription;
if ( [ subRole length ] == 0 )
roleDescription = NSAccessibilityRoleDescription( role, nil );
else
roleDescription = NSAccessibilityRoleDescription( role, subRole );
return roleDescription;
}
@end
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
Reference in a new issue View git blame Copy permalink