AutomationElementIdentifiers Class

Definition

Contains values used as automation property identifiers by UI Automation providers and UI Automation clients.

public ref class AutomationElementIdentifiers sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AutomationElementIdentifiers final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AutomationElementIdentifiers
Public NotInheritable Class AutomationElementIdentifiers
Inheritance
Object Platform::Object IInspectable AutomationElementIdentifiers
Attributes

Windows requirements

Device family
Windows 10 (introduced in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)

Remarks

Classes such as AutomationElementIdentifiers are the identifiers for the Windows Runtime implementation of a common provider pattern for Microsoft UI Automation. AutomationElementIdentifiers identifies the general automation peer properties that are part of the basic peer functionality, as opposed to being related to a specific automation control pattern. You might use these identifiers if you are implementing a Windows Runtime custom automation peer based on AutomationPeer or FrameworkElementAutomationPeer. These identifiers are needed for the RaisePropertyChangedEvent calls that you make from control code that references your own peer, or for FindItemByProperty in an items container peer.

This same set of property identifiers is usually exposed to clients in a different way, depending on which technology they use to implement the client and examine the Microsoft UI Automation tree. One such property identifier list for clients is documented in the topic Automation Element Property Identifiers.

Properties

AcceleratorKeyProperty

Identifies the accelerator key automation property. The accelerator key property value is returned by the GetAcceleratorKey method.

AccessKeyProperty

Identifies the access key automation property. The access key property value is returned by the GetAccessKey method.

AnnotationsProperty

Gets the identifier for the annotations automation property.

AutomationIdProperty

Identifies the automation element identifier automation property. The automation element identifier value is returned by the GetAutomationId method.

BoundingRectangleProperty

Identifies the bounding rectangle automation property. The bounding rectangle property value is returned by the GetBoundingRectangle method.

ClassNameProperty

Identifies the class name automation property. The class name property value is returned by the GetClassName method.

ClickablePointProperty

Identifies the clickable point automation property. A valid clickable point property value is returned by the GetClickablePoint method.

ControlledPeersProperty

Identifies the controlled peers automation property. A list of controlled peers is returned by the GetControlledPeers method.

ControlTypeProperty

Identifies the control type automation property. The control type property value is returned by the GetAutomationControlType method.

CultureProperty

Identifies the Culture property, which contains a locale identifier for the automation element (for example, 0x0409 for "en-US" or English (United States)).

DescribedByProperty

Identifies the described by automation property.

FlowsFromProperty

Identifies the "flows from" automation property. The "flows from" property value is returned by the GetFlowsFrom method.

FlowsToProperty

Identifies the "flows to" automation property. The "flows to" property value is returned by the GetFlowsTo method.

FullDescriptionProperty

Identifies the full description automation property.

HasKeyboardFocusProperty

Identifies the keyboard focus automation property. The keyboard focus state is returned by the HasKeyboardFocus method.

HeadingLevelProperty

Identifies the heading level automation property. The heading level property value is returned by the GetHeadingLevel method.

HelpTextProperty

Identifies the help text automation property. The help text property value is returned by the GetHelpText method.

IsContentElementProperty

Identifies the content element determination automation property. The content element status indicates whether the element contains content that is valuable to the end user. The current status is returned by the IsContentElement method.

IsControlElementProperty

Identifies the control element determination automation property. The control element status indicates whether the element contains user interface components that can be manipulated. The current status is returned by the IsControlElement method.

IsDataValidForFormProperty

Identifies the Boolean automation property that indicates if the data is valid for the form.

IsDialogProperty

Identifies the Boolean AutomationProperties.IsDialogProperty that indicates whether the automation element is a dialog window.

IsEnabledProperty

Identifies the enabled determination automation property. The enabled status indicates whether the item referenced by the automation peer is enabled. The current status is returned by the IsEnabled method.

IsKeyboardFocusableProperty

Identifies the keyboard-focusable determination automation property. The keyboard focusable status is returned by the IsKeyboardFocusable method.

IsOffscreenProperty

Identifies the offscreen determination automation property. The offscreen status indicates whether the item referenced by the automation peer is off the screen. The current status is returned by the IsOffscreen method.

IsPasswordProperty

Identifies the password determination automation property. The password status indicates whether the item referenced by the automation peer contains a password. The current status is returned by the IsPassword method.

IsPeripheralProperty

Identifies the Boolean automation property that indicates if the automation element represents peripheral UI.

IsRequiredForFormProperty

Identifies the form requirement determination automation property. The form requirement status indicates whether the element must be completed on a form. The current status is returned by the IsRequiredForForm method.

ItemStatusProperty

Identifies the item status automation property. The current item status is returned by the GetItemStatus method.

ItemTypeProperty

Identifies the item type automation property. The item type value is returned by GetItemType method.

LabeledByProperty

Identifies the labeled-by peer automation property. The labeling relationship for an automation peer is returned by the GetLabeledBy method.

LandmarkTypeProperty

Gets the identifier for the landmark type automation property.

LevelProperty

Gets the identifier for the level automation property.

LiveSettingProperty

Identifies the live settings automation property. The live settings property value is returned by the GetLiveSetting method.

LocalizedControlTypeProperty

Identifies the localized control type automation property which provides a mechanism to alter the control type read by Narrator.

LocalizedLandmarkTypeProperty

Gets the identifier for the localized landmark type automation property.

NameProperty

Identifies the element name automation property. The current name is returned by the GetName method.

OrientationProperty

Identifies the orientation automation property. The current orientation value is returned by the GetOrientation method.

PositionInSetProperty

Gets the identifier for the position in set automation property.

SizeOfSetProperty

Gets the identification of the size of set automation property.

Applies to

See also