Apéndice G: Puente de accesibilidad activo a Automatización de la interfaz de usuario

  • Artículo

Este apéndice contiene información sobre el Puente de accesibilidad activo de Microsoft. El Puente de accesibilidad activo permite a las aplicaciones que implementan la accesibilidad activa de Microsoft para acceder a las aplicaciones que implementan Microsoft Automatización de la interfaz de usuario. Al unir microsoft Active Accessibility y Automatización de la interfaz de usuario juntos, los clientes basados en accesibilidad activa de Microsoft, como un lector de pantalla en Windows XP, pueden interactuar mediante programación con proveedores basados en Automatización de la interfaz de usuario de Automatización de la interfaz de usuario, como una aplicación de Windows Presentation Foundation (WPF). Forma parte de Automatización de la interfaz de usuario Native Core API (UIAutomationCore.dll).

El Puente de accesibilidad activa asigna Automatización de la interfaz de usuario propiedades y eventos a los de accesibilidad activa de Microsoft. En las tablas siguientes se asignan los métodos y propiedades de la interfaz IAccessible de accesibilidad activa de Microsoft a Automatización de la interfaz de usuario. Use estas tablas para determinar las prácticas de codificación adecuadas para desarrollar el cliente basado en accesibilidad activa de Microsoft.

IAccessible (propiedad) Propiedad de la Automatización de la interfaz de usuario
get_accChild No implementado
get_accChildCount Derivado de Automatización de la interfaz de usuario árbol
get_accParent Derivado de Automatización de la interfaz de usuario árbol
accNavigate No implementado

 

Propiedades y métodos descriptivos

IAccessible Automatización de la interfaz de usuario
accDoDefaultAction Consulte la tabla Tipos de control y accRole para obtener más información.
get_accDefaultAction Consulte la tabla Tipos de control y accRole para obtener más información.
get_accKeyboardShortcut AccessKeyPropertyor AcceleratorKeyProperty; Si ambos están presentes, AccessKeyProperty tiene prioridad.
get_accName NameProperty
get_accRole ControlTypeProperty. Consulte la tabla Tipos de control y accRole para obtener más información.
get_accState Consulte la tabla Tipos de control y accRole para obtener más información.
get_accValue ValueProperty; compatible con los tipos de control que admiten el patrón de control Value o el patrón de control RangeValue . Los valores rangeValue son coherentes con el comportamiento de accesibilidad activa de Microsoft (de 0 a 100). Los elementos de valor usan una cadena.
put_accValue ValueProperty; compatible con los tipos de control que admiten el patrón de control Value o el patrón de control RangeValue
get_accHelp HelpTextProperty
get_accDescription No implementado
get_accHelpTopic No implementado

 

Tipos de control y accRole

El rol predeterminado de accesibilidad activa de Microsoft es ROLE_SYSTEM_CLIENT. Si no se encuentra ninguna acción predeterminada para un tipo de control, el puente de accesibilidad activo también usará los siguientes patrones de control disponibles: Invoke, ExpandCollapse y Toggle. Por ejemplo, un control groupbox no tiene ninguna acción predeterminada. Si admite ExpandCollapse, el puente de accesibilidad activo usará para la acción predeterminada.

Tipo de control de la Automatización de la interfaz de usuario accRole Acción predeterminada
Button ROLE_SYSTEM_PUSHBUTTON Presione
Calendario ROLE_SYSTEM_CLIENT Ninguno
CheckBox ROLE_SYSTEM_CHECKBUTTON Activar o desactivar (alternar)
ComboBox ROLE_SYSTEM_COMBOBOX Ninguno
Personalizado ROLE_SYSTEM_CLIENT Ninguno
DataGrid ROLE_SYSTEM_LIST Ninguno
DataItem ROLE_SYSTEM_LISTITEM Ninguno
Documento ROLE_SYSTEM_DOCUMENT Ninguno
Editar ROLE_SYSTEM_TEXT Ninguno
Grupo ROLE_SYSTEM_GROUPING Ninguno
Encabezado ROLE_SYSTEM_LIST Ninguno
HeaderItem ROLE_SYSTEM_COLUMNHEADER Haga clic en
Hipervínculo ROLE_SYSTEM_LINK Saltar (mapas para invocar)
Imagen ROLE_SYSTEM_GRAPHIC Ninguno
Lista ROLE_SYSTEM_LIST Ninguno
ListItem ROLE_SYSTEM_LISTITEM Doble clic
Menú ROLE_SYSTEM_MENUPOPUP Ninguno
MenuBar ROLE_SYSTEM_MENUBAR Ninguno
MenuItem ROLE_SYSTEM_MENUITEM Ejecute o abra o cierre para los elementos de menú que tienen elementos secundarios.
Panel ROLE_SYSTEM_PANE Ninguno
ProgressBar ROLE_SYSTEM_PROGRESSBAR Ninguno
RadioButton ROLE_SYSTEM_RADIOBUTTON de Azure Functions
ScrollBar ROLE_SYSTEM_SCROLLBAR Ninguno
Control deslizante ROLE_SYSTEM_SLIDER Ninguno
Spinner ROLE_SYSTEM_SPINBUTTON Ninguno
SplitButton ROLE_SYSTEM_SPLITBUTTON Ninguno
StatusBar ROLE_SYSTEM_STATUSBAR Ninguno
Pestaña ROLE_SYSTEM_PAGETABLIST Ninguno
TabItem ROLE_SYSTEM_PAGETAB Switch
Tabla ROLE_SYSTEM_TABLE Ninguno
Texto ROLE_SYSTEM_STATICTEXT Ninguno
Thumb ROLE_SYSTEM_INDICATOR Ninguno
TitleBar ROLE_SYSTEM_TITLEBAR Ninguno
ToolBar ROLE_SYSTEM_TOOLBAR Ninguno
ToolTip ROLE_SYSTEM_TOOLTIP Ninguno
Árbol ROLE_SYSTEM_OUTLINE Ninguno
TreeItem ROLE_SYSTEM_OUTLINEITEM Expandir o contraer
Ventana ROLE_SYSTEM_WINDOW Ninguno

 

propiedades de Automatización de la interfaz de usuario y accState

accState Propiedad de la Automatización de la interfaz de usuario Cambio de estado de desencadenadores
STATE_SYSTEM_CHECKED Para ControlType = "checkbox" use ToggleState.On. Para "radiobutton" use SelectionItemPattern::IsSelected Sí
STATE_SYSTEM_FOCUSABLE IsKeyboardFocusableProperty No
STATE_SYSTEM_FOCUSED HasKeyboardFocusProperty No
STATE_SYSTEM_PROTECTED IsPasswordProperty No
STATE_SYSTEM_READONLY IsReadOnlyProperty (patrón de control Value y Patrón de control RangeValue) No
STATE_SYSTEM_UNAVAILABLE IsEnabledProperty Sí
STATE_SYSTEM_LINKED ControlTypeProperty = "hyperlink" No
STATE_SYSTEM_SELECTABLE Se admite SelectionItemPattern No
STATE_SYSTEM_SELECTED IsSelectedProperty (patrón de control SelectionItem) No
STATE_SYSTEM_COLLAPSED ExpandCollapseState = Collapsed Sí
STATE_SYSTEM_EXPANDED ExpandCollapseState = Expanded o PartiallyExpanded Sí
STATE_SYSTEM_HASPOPUP Elementos de menú que admiten Expandir/Contraer No
STATE_SYSTEM_MIXED ToggleState = Indeterminado No
STATE_SYSTEM_SIZEABLE IUIAutomationTransformPattern::CanResize No
STATE_SYSTEM_MOVEABLE IUIAutomationTransformPattern::CanMove No
STATE_SYSTEM_MULTISELECTABLE IUIAutomationSelectionPattern::CanSelectMultiple No

 

Selección y enfoque

IAccessible Automatización de la interfaz de usuario
get_accFocus IUIAutomation::FocusedElement
accSelect Consulte la tabla propiedades de Automatización de la interfaz de usuario y accSelect SELFLAGs para obtener más información.
get_accSelection SelectionPattern::GetSelection

 

propiedades de Automatización de la interfaz de usuario y accSelect SELFLAG

accSelect SELFLAG Propiedad de la Automatización de la interfaz de usuario
SELFLAG_NONE No disponible
SELFLAG_TAKFOCUS IUIAutomationElement::SetFocus
SELFLAG_TAKESELECTION IUIAutomationSelectionItemPattern::Select
SELFLAG_ADDSELECTION IUIAutomationSelectionItemPattern::AddToSelection
SELFLAG_TAKEREMOVESELECTION IUIAutomationSelectionItemPattern::RemoveFromSelection
SELFLAG_EXTENDSELECTION No disponible

 

Asignación espacial

IAccessible Automatización de la interfaz de usuario
accLocation BoundingRectangleProperty
accHitTest IRawElementProviderFragmentRoot::ElementProviderFromPoint

 

Eventos

constantes de eventos de System-Level Automatización de la interfaz de usuario
EVENT_SYSTEM_MENUPOPUPSTART UIA_MenuOpenedEventId (Nota: Debe comprobar si se trata de una ventana emergente).
EVENT_SYSTEM_MENUPOPUPEND UIA_MenuClosedEventId
EVENT_SYSTEM_MENUSTART UIA_MenuModeStartEventId
EVENT_SYSTEM_MENUEND UIA_MenuModeEndEventId
EVENT_SYSTEM_SOUND
EVENT_SYSTEM_ALERT
EVENT_SYSTEM_CAPTURESTART
EVENT_SYSTEM_CAPTUREEND
EVENT_SYSTEM_DIALOGSTART
EVENT_SYSTEM_DIALOGEND
EVENT_SYSTEM_MOVESIZESTART
EVENT_SYSTEM_MOVESIZEEND
EVENT_SYSTEM_CONTEXTHELPSTART
EVENT_SYSTEM_CONTEXTHELPEND No es relevante.
EVENT_SYSTEM_DRAGDROPSTART
EVENT_SYSTEM_DRAGDROPEND
EVENT_SYSTEM_SWITCHSTART No es relevante.
EVENT_SYSTEM_SWITCHEND No es relevante.
EVENT_SYSTEM_MINIMIZESTART
EVENT_SYSTEM_MINIMIZEEND
EVENT_SYSTEM_FOREGROUND
EVENT_SYSTEM_SCROLLINGSTART No disponible
EVENT_SYSTEM_SCROLLINGEND No disponible

 

constantes de eventos de Object-Level Automatización de la interfaz de usuario
EVENT_OBJECT_FOCUS AutomationFocusChangedEvent
EVENT_OBJECT_VALUECHANGE ValueProperty (patrón de control Value y patrón de control RangeValue)
EVENT_OBJECT_SELECTION ElementSelectedEvent (patrón de control SelectionItem)
EVENT_OBJECT_SELECTIONADD ElementAddedToSelectionEvent (patrón de control SelectionItem)
EVENT_OBJECT_SELECTIONREMOVE ElementRemovedFromSelectionEvent
EVENT_OBJECT_SELECTIONWITHIN EventsSelectionInvalidatedEvent
EVENT_OBJECT_STATECHANGE Consulte Automatización de la interfaz de usuario tabla Properties and accState (Propiedades y tabla accState) para ver los estados que desencadenan un cambio de estado.