AutomationElement 类

定义

命名空间:

System.Windows.Automation

程序集:

UIAutomationClient.dll

表示 UI 自动化树中的一个 UI 自动化元素，并包含由 UI 自动化客户端应用程序用作标识符的值。

public ref class AutomationElement sealed

public sealed class AutomationElement

type AutomationElement = class

Public NotInheritable Class AutomationElement

继承

Object

AutomationElement

注解

AutomationElement对应于 UI) (用户界面的一部分，而不考虑基础实现 (，例如Windows Presentation Foundation (WPF) 或 Win32) 。

字段

AcceleratorKeyProperty	标识 AcceleratorKey 属性。
AccessKeyProperty	标识 AccessKey 属性。
ActiveTextPositionChangedEvent	事件 ID：ActiveTextPositionChanged - 指示文本元素中的活动位置已更改。
AsyncContentLoadedEvent	标识在异步加载内容过程中引发的事件。
AutomationFocusChangedEvent	标识在已更改焦点时引发的事件。
AutomationIdProperty	标识 AutomationId 属性，该属性用于标识元素。
AutomationPropertyChangedEvent	标识 property-changed 事件。
BoundingRectangleProperty	标识 BoundingRectangle 属性。
ClassNameProperty	标识 ClassName 属性。
ClickablePointProperty	标识可单击点的属性。
ControlTypeProperty	标识 ControlType 属性。
CultureProperty	标识区域性属性。
FrameworkIdProperty	标识 FrameworkId 属性。
HasKeyboardFocusProperty	标识 HasKeyboardFocus 属性。
HeadingLevelProperty	属性 ID：HeadingLevel - 描述元素的标题级别。
HelpTextProperty	标识 HelpText 属性。
IsContentElementProperty	标识 IsContentElement 属性。
IsControlElementProperty	标识 IsControlElement 属性。
IsDialogProperty	属性 ID：IsDialog - 标识自动化元素是否为对话框。
IsDockPatternAvailableProperty	标识表示在此 DockPattern 上 AutomationElement 控件模式是否可用的属性。
IsEnabledProperty	IsEnabled标识 属性，该属性指定是否启用 由 引用AutomationElement的用户界面 (UI) 项。
IsExpandCollapsePatternAvailableProperty	标识表示在此 ExpandCollapsePattern 上 AutomationElement 控件模式是否可用的属性。
IsGridItemPatternAvailableProperty	标识表示在此 GridItemPattern 上 AutomationElement 控件模式是否可用的属性。
IsGridPatternAvailableProperty	标识表示在此 GridPattern 上 AutomationElement 控件模式是否可用的属性。
IsInvokePatternAvailableProperty	标识表示在此 InvokePattern 上 AutomationElement 控件模式是否可用的属性。
IsItemContainerPatternAvailableProperty	标识表示在此 ItemContainerPattern 上 AutomationElement 控件模式是否可用的属性。
IsKeyboardFocusableProperty	标识 IsKeyboardFocusable 属性。
IsMultipleViewPatternAvailableProperty	标识表示在此 MultipleViewPattern 上 AutomationElement 控件模式是否可用的属性。
IsOffscreenProperty	标识 IsOffscreen 属性，该属性指示用户界面 (UI) 项是否在屏幕上可见。
IsPasswordProperty	标识 IsPassword 属性。
IsRangeValuePatternAvailableProperty	标识表示在此 RangeValuePattern 上 AutomationElement 控件模式是否可用的属性。
IsRequiredForFormProperty	标识 IsRequiredForForm 属性。
IsScrollItemPatternAvailableProperty	标识表示 ScrollItemPattern 控件模式对于此 AutomationElement 是否可用的属性。
IsScrollPatternAvailableProperty	标识表示在此 ScrollPattern 上 AutomationElement 控件模式是否可用的属性。
IsSelectionItemPatternAvailableProperty	标识表示在此 SelectionItemPattern 上 AutomationElement 控件模式是否可用的属性。
IsSelectionPatternAvailableProperty	标识表示在此 SelectionPattern 上 AutomationElement 控件模式是否可用的属性。
IsSynchronizedInputPatternAvailableProperty	标识表示在此 SynchronizedInputPattern 上 AutomationElement 控件模式是否可用的属性。
IsTableItemPatternAvailableProperty	标识表示在此 TableItemPattern 上 AutomationElement 控件模式是否可用的属性。
IsTablePatternAvailableProperty	标识表示在此 TablePattern 上 AutomationElement 控件模式是否可用的属性。
IsTextPatternAvailableProperty	标识表示在此 TextPattern 上 AutomationElement 控件模式是否可用的属性。
IsTogglePatternAvailableProperty	标识表示在此 TogglePattern 上 AutomationElement 控件模式是否可用的属性。
IsTransformPatternAvailableProperty	标识表示在此 TransformPattern 上 AutomationElement 控件模式是否可用的属性。
IsValuePatternAvailableProperty	标识表示在此 ValuePattern 上 AutomationElement 控件模式是否可用的属性。
IsVirtualizedItemPatternAvailableProperty	标识表示在此 VirtualizedItemPattern 上 AutomationElement 控件模式是否可用的属性。
IsWindowPatternAvailableProperty	标识表示在此 WindowPattern 上 AutomationElement 控件模式是否可用的属性。
ItemStatusProperty	标识 ItemStatus 属性，它指定复杂项的可视化表示形式的状态。
ItemTypeProperty	标识 ItemType 属性。
LabeledByProperty	标识 LabeledBy 属性，它标识与控件关联的标签。
LayoutInvalidatedEvent	标识布局失效时引发的事件。
LocalizedControlTypeProperty	标识本地语言的 LocalizedControlType 属性。
MenuClosedEvent	标识在关闭菜单时引发的事件。
MenuOpenedEvent	标识在打开菜单时引发的事件。
NameProperty	标识 Name 属性。
NativeWindowHandleProperty	标识 NativeWindowHandle 属性。
NotificationEvent	事件 ID：通知 - 主要由服务器用来引发常规通知。
NotSupported	指示属性不受支持。
OrientationProperty	标识 Orientation 属性。
PositionInSetProperty	描述了自动化元素在一组视为同级的元素中的序号位置。
ProcessIdProperty	标识 ProcessId 属性。
RuntimeIdProperty	标识包含元素的运行时标识符的属性。
SizeOfSetProperty	介绍了自动化元素在视为同级的组或集中的数量。
StructureChangedEvent	标识更改UI 自动化树结构时引发的事件。
ToolTipClosedEvent	标识在关闭工具提示时引发的事件。
ToolTipOpenedEvent	标识在打开工具提示时引发的事件。

属性

Cached	获取此 AutomationElement 对象的缓存UI 自动化属性值。
CachedChildren	获取此 AutomationElement 的已缓存子元素。
CachedParent	获取此 AutomationElement 的已缓存父级。
Current	获取 AutomationElement 的当前属性值。
FocusedElement	获取当前获得焦点的 AutomationElement。
RootElement	获取当前桌面的根 AutomationElement。

方法

Equals(Object)	确定指定的 AutomationElement 是否具有与此 AutomationElement 相同的值。
Finalize()	在垃圾回收将某一对象回收前允许该对象尝试释放资源并执行其他清理操作。
FindAll(TreeScope, Condition)	返回满足指定条件的全部 AutomationElement 对象。
FindFirst(TreeScope, Condition)	返回与指定条件匹配的第一个子级或子代元素。
FromHandle(IntPtr)	检索指定窗口句柄引用的用户界面 (UI) 项的新 AutomationElement 对象。
FromLocalProvider(IRawElementProviderSimple)	从本地 AutomationElement 实现检索新的 IRawElementProviderSimple 对象。
FromPoint(Point)	在桌面上指定点检索用户界面 (UI) 项的新 AutomationElement 对象。
GetCachedPattern(AutomationPattern)	从此 AutomationElement 的缓存中检索指定模式。
GetCachedPropertyValue(AutomationProperty)	从此 AutomationElement 的缓存中检索指定属性的值。 对于目标用户界面 (UI) 元素未显式支持的属性，将返回属性类型的相应默认值。
GetCachedPropertyValue(AutomationProperty, Boolean)	从此 AutomationElement 的缓存中检索指定属性的值，还可以选择忽略任何默认属性。
GetClickablePoint()	检索 AutomationElement 上可以单击的点。
GetCurrentPattern(AutomationPattern)	检索此 AutomationElement 上的指定模式对象。
GetCurrentPropertyValue(AutomationProperty)	检索此 AutomationElement 上指定属性的值。 对于目标用户界面 (UI) 元素未显式支持的属性，将返回属性类型的相应默认值。
GetCurrentPropertyValue(AutomationProperty, Boolean)	检索此 AutomationElement 上指定属性的值，还可以选择忽略任何默认属性。
GetHashCode()	检索此 AutomationElement 的哈希代码。
GetRuntimeId()	检索分配给用户界面 (UI) 项的唯一标识符。
GetSupportedPatterns()	检索此 AutomationElement 支持的控件模式。
GetSupportedProperties()	检索元素支持的属性的标识符。
GetType()	获取当前实例的 Type。 (继承自 Object)
GetUpdatedCache(CacheRequest)	检索一个具有更新缓存的新 AutomationElement。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
SetFocus()	将焦点设置在 AutomationElement 上。
ToString()	返回表示当前对象的字符串。 (继承自 Object)
TryGetCachedPattern(AutomationPattern, Object)	从缓存中检索控件模式。
TryGetClickablePoint(Point)	检索元素内一个可单击的点。
TryGetCurrentPattern(AutomationPattern, Object)	检索一个实现控件模式的对象。

运算符

Equality(AutomationElement, AutomationElement)	返回一个值，该值指示指定的 AutomationElement 对象是否引用同一用户界面 (UI) 元素。
Inequality(AutomationElement, AutomationElement)	返回一个值，该值指示指定的 AutomationElement 对象是否引用不同的用户界面 (UI) 元素。

另请参阅

• UI 自动化概述