LegacyIAccessible Control Pattern

Describes guidelines and conventions for using ILegacyIAccessibleProvider, including information about properties, methods, and events. The LegacyIAccessible control pattern is supported by the Microsoft Active Accessibility to Microsoft UI Automation Proxy.

Application and control providers never implement the ILegacyIAccessibleProvider interface.

The LegacyIAccessible control pattern exposes the IUIAutomationLegacyIAccessiblePattern interface to UI Automation clients, enabling them to access the underlying 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

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
ChildId Property Returns CHILDID_SELF (0) for a non-child object.
DefaultAction Property None
Description Property None
Help Property None
KeyboardShortcut Property None
Name Property None
Role Property Use the GetRoleText function to retrieve localized string.
GetSelection Method Retrieves an IUIAutomationElementArray interface pointer.
State Property Use the GetStateText function to retrieve localized string.
Value Property None
DoDefaultAction Method None
GetIAccessible Method None
Select Method The selection flag is a Microsoft Active AccessibilitySELFLAG value. For more information, see SELFLAG Constants.
SetValue Method None

 

This control pattern has no associated events.

Control Types and Their Supported Control Patterns

UI Automation Control Patterns Overview

UI Automation Tree Overview