Implementing the UI Automation LegacyIAccessible Control Pattern
This topic introduces guidelines and conventions for using ILegacyIAccessibleProvider, including information about properties, methods, and events. Links to additional references are listed at the end of the topic.
The LegacyIAccessible control pattern is supported by the Microsoft Active Accessibility to UI Automation Proxy. Application and control providers never implement the ILegacyIAccessibleProvider interface.
The LegacyIAccessible control pattern exposes the IUIAutomationLegacyIAccessiblePattern interface to Microsoft UI Automation clients, enabling them to access the underlining IAccessible implementation for certain UI elements. However, IUIAutomationLegacyIAccessiblePattern does not support methods that are obsolete or that are redundant with the UI Automation features.
This topic contains the following sections:
- Implementation Guidelines and Conventions
- Members of the LegacyIAccessible Control Pattern
- Related Topics
Implementation Guidelines and Conventions
No application or control implements ILegacyIAccessibleProvider. The UI Automation framework automatically supplies the provider implementation for a native Microsoft Active Accessibility server.
The LegacyIAccessible control pattern is not available for controls based on UI Automation.
Members of the LegacyIAccessible Control Pattern
The following properties, methods, and events are members of the LegacyIAccessible control pattern. The notes are for UI Automation clients.
| Members | Member type | Notes |
|---|---|---|
| ILegacyIAccessibleProvider::ChildId | Property | Returns CHILDID_SELF (0) for a non-child object. |
| ILegacyIAccessibleProvider::DefaultAction | Method | None |
| ILegacyIAccessibleProvider::Description | Property | None |
| ILegacyIAccessibleProvider::HelpHelp | Property | None |
| ILegacyIAccessibleProvider::KeyboardShortcut | Property | None |
| ILegacyIAccessibleProvider::Name | Property | None |
| ILegacyIAccessibleProvider::Role | Property | Use the GetRoleText function to retrieve localized string. |
| ILegacyIAccessibleProvider::GetSelection | Property | Retrieves an IUIAutomationElementArray interface pointer. |
| ILegacyIAccessibleProvider::State | Property | Use the GetStateText function to retrieve localized string. |
| ILegacyIAccessibleProvider::Value | Property | None |
| DoDefaultAction | Method | None |
| GetIAccessible | Method | None |
| Select | Method | The selection flag is a value from the Microsoft Active AccessibilitySELFLAG enumeration. |
| SetValue | Method | None |