Рекомендации по реализации IAccessibleEx

Ядро Microsoft модель автоматизации пользовательского интерфейса может извлекать все свойства Microsoft Active Accessibility для любого объекта со специальными возможностями, предоставляемого сервером через интерфейс IAccessible. При реализации IAccessibleEx необходимо предоставлять только те аспекты функциональности пользовательского интерфейса, которые невозможно предоставить через существующие свойства Microsoft Active Accessibility. В этом разделе описываются модель автоматизации пользовательского интерфейса свойства и шаблоны элементов управления, представляющие функциональные возможности пользовательского интерфейса, которые не имеют аналогов в Microsoft Active Accessibility. Это свойства и шаблоны элементов управления, которые можно предоставить в реализации IAccessibleEx.

Этот раздел состоит из следующих подразделов.

• Свойства
• Шаблоны элементов управления
• События WinEvents для событий изменения свойства модель автоматизации пользовательского интерфейса
• Связанные темы

Свойства

Следующие свойства модель автоматизации пользовательского интерфейса не перекрываются с функциональностью Microsoft Active Accessibility. Их можно использовать в реализации IAccessibleEx :

• AriaProperties
• AriaRole
• AutomationId
• ClassName
• ClickablePoint
• ControllerFor
• Культура
• Описание По
• FlowsTo
• FrameworkId
• IsContentElement
• IsControlElement
• IsDataValidForForm
• IsRequiredForForm
• ItemStatus
• ItemType
• LabeledBy
• LocalizedControlType
• Ориентация

Хотя свойства AcceleratorKey и AccessKey модель автоматизации пользовательского интерфейса перекрываются со свойством accKeyboardShortcut Microsoft Active Accessibility, их по-прежнему можно использовать в реализации IAccessibleEx для элементов управления с ключом доступа и ускорителем. Аналогичным образом свойство ControlType модель автоматизации пользовательского интерфейса перекрывается со свойством Microsoft Active Accessibility accRole, но его по-прежнему можно использовать в реализации IAccessibleEx для определения более конкретной роли для элемента управления.

Так как следующие свойства элементов модель автоматизации пользовательского интерфейса уже охвачены свойствами Microsoft Active Accessibility, их нет необходимости использовать в реализации IAccessibleEx.

Для любого неподдерживаемого свойства модель автоматизации пользовательского интерфейса реализация метода IRawElementProviderSimple::GetPropertyValue должна задать для параметра pRetVal значение VT_EMPTY и вернуть S_OK. Возврат UIA_E_NOTSUPPORTED может привести к тому, что прокси-сервер MSAA-to-UIA удалит сопоставление по умолчанию для соответствующего свойства.

Шаблоны элементов управления

Следующие модель автоматизации пользовательского интерфейса шаблоны элементов управления не перекрываются с возможностями Microsoft Active Accessibility. Их можно использовать в реализации IAccessibleEx :

• Панель закрепления
• ExpandCollapse
• Сетка
• GridItem
• MultipleView
• RangeValue
• Scroll
• ScrollItem
• SynchronizedInput
• Таблица
• TableItem
• Преобразование

Для шаблонов элементов управления RangeValue и Transform некоторые методы перекрываются между шаблоном элемента управления модель автоматизации пользовательского интерфейса и методами Microsoft Active Accessibility. В этих случаях необходимо реализовать оба варианта. Например, необходимо реализовать оба метода Microsoft Active Accessibility IAccessible::get_accValue и IAccessible::p ut_accValue, а также методы модель автоматизации пользовательского интерфейса IRangeValueProvider::Value и IRangeValueProvider::SetValue. На внутреннем уровне реализация может совместно использовать код для них. Это требование для реализации обоих наборов позволяет избежать частичной реализации интерфейса шаблона, сохраняя интерфейс IAccess в использовании существующими клиентами Microsoft Active Accessibility.

Следующие модель автоматизации пользовательского интерфейса шаблоны элементов управления не требуются, если элемент управления имеет одну из ролей, описанных ниже. В противном случае они должны поддерживаться явным образом, если это необходимо.

События WinEvents для событий изменения свойства модель автоматизации пользовательского интерфейса

Помимо событий, определенных для IAccessible, также определяются следующие идентификаторы событий, которые могут использоваться с реализацией IAccessibleEx в качестве событий изменения свойства для соответствующих свойств модель автоматизации пользовательского интерфейса. Они используют тот же механизм, что и события, определенные для IAccessible. Дополнительные сведения см. в разделе События WinEvents.

Для указанных выше событий, у которых есть значение EVENT_OBJECT_, указанное после них, и реализация IAccessibleEx должна вызывать это событие в дополнение к указанному измененному событию. Это позволяет существующему клиентскому коду IAccessibleEx продолжать работать, передавая более детализированные сведения о событиях заинтересованным клиентам.

Связанные темы

WinEvents

Интерфейс IAccessibleEx