AutomationElement 類別

定義

命名空間:: System.Windows.Automation

組件:: UIAutomationClient.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

代表使用者介面自動化樹中的使用者介面自動化元素，並包含使用者介面自動化客戶端應用程式所使用的識別碼值。

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）。

欄位

名稱	Description
AcceleratorKeyProperty	識別該 AcceleratorKey 物業。
AccessKeyProperty	識別該 AccessKey 物業。
ActiveTextPositionChangedEvent	事件 ID：ActiveTextPositionChanged - 表示文字元素中的主動位置已改變。
AsyncContentLoadedEvent	識別非同步內容載入期間產生的事件。
AutomationFocusChangedEvent	指出焦點改變時會提出的事件。
AutomationIdProperty	識別 AutomationId 屬性，用以識別元素。
AutomationPropertyChangedEvent	識別屬性變更事件。
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	事件識別碼：通知——主要供伺服器用來發送通用通知。
NotSupported	表示該物業未被支持。
OrientationProperty	識別該 Orientation 物業。
PositionInSetProperty	描述自動化元素在被視為兄弟姊妹的元素集合中的序數位置。
ProcessIdProperty	識別該 ProcessId 物業。
RuntimeIdProperty	識別包含該元素執行時識別碼的屬性。
SizeOfSetProperty	描述一組或集合中被視為兄弟姊妹的自動化元素數量。
StructureChangedEvent	識別當使用者介面自動化樹結構變更時所引發的事件。
ToolTipClosedEvent	識別關閉提示時所引發的事件。
ToolTipOpenedEvent	識別開啟提示時所觸發的事件。

屬性

名稱	Description
Cached	取得此 AutomationElement 物件快取的使用者介面自動化屬性值。
CachedChildren	取得此 AutomationElement的快取子元素。
CachedParent	取得這個 AutomationElement快取的父檔。
Current	取得當前屬性值。AutomationElement
FocusedElement	取得 AutomationElement 目前有焦點的。
RootElement	取得目前桌面的根權限 AutomationElement 。

方法

名稱	Description
Equals(Object)	判斷指定的 AutomationElement 值是否與此 AutomationElement值相同。
Finalize()	允許對象嘗試釋放資源，並在垃圾收集回收之前執行其他清除作業。
FindAll(TreeScope, Condition)	回傳所有 AutomationElement 符合指定條件的物件。
FindFirst(TreeScope, Condition)	回傳第一個符合指定條件的子元素或後代元素。
FromHandle(IntPtr)	為指定的視窗指柄所參考的使用者介面（UI）項目，取得一個新的 AutomationElement 物件。
FromLocalProvider(IRawElementProviderSimple)	從本地AutomationElement實作中擷取新IRawElementProviderSimple物件。
FromPoint(Point)	在桌面指定點取得使用者 AutomationElement 介面（UI）項目的新物件。
GetCachedPattern(AutomationPattern)	從該 AutomationElement快取中取得指定的模式。
GetCachedPropertyValue(AutomationProperty, Boolean)	從該 AutomationElement屬性的快取中取得指定屬性的值，可選擇性地忽略任何預設屬性。
GetCachedPropertyValue(AutomationProperty)	從該 AutomationElement的快取中取得指定屬性的值。對於目標使用者介面（UI）元素未明確支援的屬性，則會回傳適當的屬性預設值。
GetClickablePoint()	可以點擊取得的一個點 AutomationElement 。
GetCurrentPattern(AutomationPattern)	在此上取得指定的模式物件 AutomationElement。
GetCurrentPropertyValue(AutomationProperty, Boolean)	取得指定 AutomationElement屬性的值，選擇性地忽略任何預設屬性。
GetCurrentPropertyValue(AutomationProperty)	取得指定屬性在該屬性 AutomationElement上的值。對於目標使用者介面（UI）元素未明確支援的屬性，則會回傳適當的屬性預設值。
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)	擷取實作控制模式的物件。

運算子

名稱	Description
Equality(AutomationElement, AutomationElement)	回傳一個值，表示指定的 AutomationElement 物件是否指向相同的使用者介面（UI）元素。
Inequality(AutomationElement, AutomationElement)	回傳一個值，指示指定物件是否 AutomationElement 指向不同的使用者介面（UI）元素。

適用於

另請參閱

UI 自動化概觀

意見反應

此頁面對您有幫助嗎？