AutomationElement Class
TOC
Collapse the table of content
Expand the table of content

AutomationElement Class

 

Represents a UI Automation element in the UI Automation tree, and contains values used as identifiers by UI Automation client applications.

Namespace:   System.Windows.Automation
Assembly:  UIAutomationClient (in UIAutomationClient.dll)

System.Object
  System.Windows.Automation.AutomationElement

public sealed class AutomationElement

NameDescription
System_CAPS_pubpropertyCached

Gets the cached UI Automation property values for this AutomationElement object.

System_CAPS_pubpropertyCachedChildren

Gets the cached child elements of this AutomationElement.

System_CAPS_pubpropertyCachedParent

Gets the cached parent of this AutomationElement.

System_CAPS_pubpropertyCurrent

Gets the current property values of the AutomationElement.

System_CAPS_pubpropertySystem_CAPS_staticFocusedElement

Gets the AutomationElement that currently has focus.

System_CAPS_pubpropertySystem_CAPS_staticRootElement

Gets the root AutomationElement for the current desktop.

NameDescription
System_CAPS_pubmethodEquals(Object)

Determines whether the specified AutomationElement has the same value as this AutomationElement.(Overrides Object.Equals(Object).)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Overrides Object.Finalize().)

System_CAPS_pubmethodFindAll(TreeScope, Condition)

Returns all AutomationElement objects that satisfy the specified condition.

System_CAPS_pubmethodFindFirst(TreeScope, Condition)

Returns the first child or descendant element that matches the specified condition.

System_CAPS_pubmethodSystem_CAPS_staticFromHandle(IntPtr)

Retrieves a new AutomationElement object for the user interface (UI) item referenced by the specified window handle.

System_CAPS_pubmethodSystem_CAPS_staticFromLocalProvider(IRawElementProviderSimple)

Retrieves a new AutomationElement object from a local IRawElementProviderSimple implementation.

System_CAPS_pubmethodSystem_CAPS_staticFromPoint(Point)

Retrieves a new AutomationElement object for the user interface (UI) item at specified point on the desktop.

System_CAPS_pubmethodGetCachedPattern(AutomationPattern)

Retrieves the specified pattern from the cache of this AutomationElement.

System_CAPS_pubmethodGetCachedPropertyValue(AutomationProperty)

Retrieves the value of the specified property from the cache of this AutomationElement. An appropriate default value for the property type is returned for properties not explicitly supported by the target user interface (UI) element.

System_CAPS_pubmethodGetCachedPropertyValue(AutomationProperty, Boolean)

Retrieves the value of the specified property from the cache of this AutomationElement, optionally ignoring any default property.

System_CAPS_pubmethodGetClickablePoint()

Retrieves a point on the AutomationElement that can be clicked.

System_CAPS_pubmethodGetCurrentPattern(AutomationPattern)

Retrieves the specified pattern object on this AutomationElement.

System_CAPS_pubmethodGetCurrentPropertyValue(AutomationProperty)

Retrieves the value of the specified property on this AutomationElement. An appropriate default value for the property type is returned for properties not explicitly supported by the target user interface (UI) element.

System_CAPS_pubmethodGetCurrentPropertyValue(AutomationProperty, Boolean)

Retrieves the value of the specified property on this AutomationElement, optionally ignoring any default property.

System_CAPS_pubmethodGetHashCode()

Retrieves the hash code for this AutomationElement.(Overrides Object.GetHashCode().)

System_CAPS_pubmethodGetRuntimeId()

Retrieves the unique identifier assigned to the user interface (UI) item.

System_CAPS_pubmethodGetSupportedPatterns()

Retrieves the control patterns that this AutomationElement supports.

System_CAPS_pubmethodGetSupportedProperties()

Retrieves the identifiers of properties supported by the element.

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodGetUpdatedCache(CacheRequest)

Retrieves a new AutomationElement with an updated cache.

System_CAPS_pubmethodSetFocus()

Sets focus on the AutomationElement.

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

System_CAPS_pubmethodTryGetCachedPattern(AutomationPattern, Object)

Retrieves a control pattern from the cache.

System_CAPS_pubmethodTryGetClickablePoint(Point)

Retrieves a point within the element that can be clicked.

System_CAPS_pubmethodTryGetCurrentPattern(AutomationPattern, Object)

Retrieves an object that implements a control pattern.

NameDescription
System_CAPS_pubfieldSystem_CAPS_staticAcceleratorKeyProperty

Identifies the AcceleratorKey property.

System_CAPS_pubfieldSystem_CAPS_staticAccessKeyProperty

Identifies the AccessKey property.

System_CAPS_pubfieldSystem_CAPS_staticAsyncContentLoadedEvent

Identifies an event raised during asynchronous content-loading.

System_CAPS_pubfieldSystem_CAPS_staticAutomationFocusChangedEvent

Identifies an event that is raised when the focus has changed.

System_CAPS_pubfieldSystem_CAPS_staticAutomationIdProperty

Identifies the AutomationId property, which is used to identify elements.

System_CAPS_pubfieldSystem_CAPS_staticAutomationPropertyChangedEvent

Identifies a property-changed event.

System_CAPS_pubfieldSystem_CAPS_staticBoundingRectangleProperty

Identifies the BoundingRectangle property.

System_CAPS_pubfieldSystem_CAPS_staticClassNameProperty

Identifies the ClassName property.

System_CAPS_pubfieldSystem_CAPS_staticClickablePointProperty

Identifies the clickable point property.

System_CAPS_pubfieldSystem_CAPS_staticControlTypeProperty

Identifies the ControlType property.

System_CAPS_pubfieldSystem_CAPS_staticCultureProperty

Identifies the culture property.

System_CAPS_pubfieldSystem_CAPS_staticFrameworkIdProperty

Identifies the FrameworkId property.

System_CAPS_pubfieldSystem_CAPS_staticHasKeyboardFocusProperty

Identifies the HasKeyboardFocus property.

System_CAPS_pubfieldSystem_CAPS_staticHelpTextProperty

Identifies the HelpText property.

System_CAPS_pubfieldSystem_CAPS_staticIsContentElementProperty

Identifies the IsContentElement property.

System_CAPS_pubfieldSystem_CAPS_staticIsControlElementProperty

Identifies the IsControlElement property.

System_CAPS_pubfieldSystem_CAPS_staticIsDockPatternAvailableProperty

Identifies the property that indicates whether the DockPattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsEnabledProperty

Identifies the IsEnabled property, which specifies whether the user interface (UI) item referenced by the AutomationElement is enabled.

System_CAPS_pubfieldSystem_CAPS_staticIsExpandCollapsePatternAvailableProperty

Identifies the property that indicates whether the ExpandCollapsePattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsGridItemPatternAvailableProperty

Identifies the property that indicates whether the GridItemPattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsGridPatternAvailableProperty

Identifies the property that indicates whether the GridPattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsInvokePatternAvailableProperty

Identifies the property that indicates whether the InvokePattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsItemContainerPatternAvailableProperty

Identifies the property that indicates whether the ItemContainerPattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsKeyboardFocusableProperty

Identifies the IsKeyboardFocusable property.

System_CAPS_pubfieldSystem_CAPS_staticIsMultipleViewPatternAvailableProperty

Identifies the property that indicates whether the MultipleViewPattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsOffscreenProperty

Identifies the IsOffscreen property, which indicates whether the user interface (UI) item is visible on the screen. 

System_CAPS_pubfieldSystem_CAPS_staticIsPasswordProperty

Identifies the IsPassword property.

System_CAPS_pubfieldSystem_CAPS_staticIsRangeValuePatternAvailableProperty

Identifies the property that indicates whether the RangeValuePattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsRequiredForFormProperty

Identifies the IsRequiredForForm property.

System_CAPS_pubfieldSystem_CAPS_staticIsScrollItemPatternAvailableProperty

Identifies the property that indicates whether the ScrollItemPattern control pattern is available for this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsScrollPatternAvailableProperty

Identifies the property that indicates whether the ScrollPattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsSelectionItemPatternAvailableProperty

Identifies the property that indicates whether the SelectionItemPattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsSelectionPatternAvailableProperty

Identifies the property that indicates whether the SelectionPattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsSynchronizedInputPatternAvailableProperty

Identifies the property that indicates whether the SynchronizedInputPattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsTableItemPatternAvailableProperty

Identifies the property that indicates whether the TableItemPattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsTablePatternAvailableProperty

Identifies the property that indicates whether the TablePattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsTextPatternAvailableProperty

Identifies the property that indicates whether the TextPattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsTogglePatternAvailableProperty

Identifies the property that indicates whether the TogglePattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsTransformPatternAvailableProperty

Identifies the property that indicates whether the TransformPattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsValuePatternAvailableProperty

Identifies the property that indicates whether the ValuePattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsVirtualizedItemPatternAvailableProperty

Identifies the property that indicates whether the VirtualizedItemPattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticIsWindowPatternAvailableProperty

Identifies the property that indicates whether the WindowPattern control pattern is available on this AutomationElement.

System_CAPS_pubfieldSystem_CAPS_staticItemStatusProperty

Identifies the ItemStatus property, which specifies the status of the visual representation of a complex item.

System_CAPS_pubfieldSystem_CAPS_staticItemTypeProperty

Identifies the ItemType property.

System_CAPS_pubfieldSystem_CAPS_staticLabeledByProperty

Identifies the LabeledBy property, which identifies the label associated with a control.

System_CAPS_pubfieldSystem_CAPS_staticLayoutInvalidatedEvent

Identifies the event that is raised when the layout is invalidated.

System_CAPS_pubfieldSystem_CAPS_staticLocalizedControlTypeProperty

Identifies the LocalizedControlType property in the local language.

System_CAPS_pubfieldSystem_CAPS_staticMenuClosedEvent

Identifies the event that is raised when a menu is closed.

System_CAPS_pubfieldSystem_CAPS_staticMenuOpenedEvent

Identifies the event that is raised when a menu is opened.

System_CAPS_pubfieldSystem_CAPS_staticNameProperty

Identifies the Name property.

System_CAPS_pubfieldSystem_CAPS_staticNativeWindowHandleProperty

Identifies the NativeWindowHandle property.

System_CAPS_pubfieldSystem_CAPS_staticNotSupported

Indicates that a property is not supported.

System_CAPS_pubfieldSystem_CAPS_staticOrientationProperty

Identifies the Orientation property.

System_CAPS_pubfieldSystem_CAPS_staticProcessIdProperty

Identifies the ProcessId property.

System_CAPS_pubfieldSystem_CAPS_staticRuntimeIdProperty

Identifies the property that contains the runtime identifier of the element.

System_CAPS_pubfieldSystem_CAPS_staticStructureChangedEvent

Identifies the event that is raised when the UI Automation tree structure is changed.

System_CAPS_pubfieldSystem_CAPS_staticToolTipClosedEvent

Identifies the event that is raised when a tooltip is closed.

System_CAPS_pubfieldSystem_CAPS_staticToolTipOpenedEvent

Identifies the event that is raised when a tooltip is opened.

NameDescription
System_CAPS_puboperatorSystem_CAPS_staticEquality(AutomationElement, AutomationElement)

Returns a value indicating whether the specified AutomationElement objects refer to the same user interface (UI) element.

System_CAPS_puboperatorSystem_CAPS_staticInequality(AutomationElement, AutomationElement)

Returns a value indicating whether the specified AutomationElement objects refer to different user interface (UI) elements.

An AutomationElement corresponds to a piece of user interface (UI), regardless of underlying implementation (such as Windows Presentation Foundation (WPF) or Win32).

.NET Framework
Available since 3.0

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show:
© 2016 Microsoft