IUIAutomation 介面 (uiautomationclient.h)

公開方法，讓 Microsoft 使用者介面自動化 用戶端應用程式探索、存取和篩選 使用者介面自動化 元素。 使用者介面自動化 會將 使用者介面自動化 的每個項目公開為 IUIAutomation 介面所代表的物件。 這個介面的成員不是特定元素特有的。

繼承

IUIAutomation 介面繼承自 IUnknown 介面。 IUIAutomation 也有下列類型的成員：

方法

IUIAutomation 介面具有這些方法。

IUIAutomation：：AddAutomationEventHandler 註冊處理 Microsoft 使用者介面自動化 事件的方法。注意 在實作事件處理程式之前，您應該熟悉了解線程問題中所述的線程問題。
IUIAutomation：：AddFocusChangedEventHandler 註冊處理焦點變更事件的方法。注意 在實作事件處理程式之前，您應該熟悉了解線程問題中所述的線程問題。
IUIAutomation：：AddPropertyChangedEventHandler 註冊處理和屬性變更事件陣列的方法。
IUIAutomation：：AddPropertyChangedEventHandlerNativeArray 註冊處理屬性變更事件原生陣列的方法。
IUIAutomation：：AddStructureChangedEventHandler 註冊處理結構變更事件的方法。注意 在實作事件處理程式之前，您應該熟悉了解線程問題中所述的線程問題。
IUIAutomation：：CheckNotSupported 檢查提供的 VARIANT，以查看它是否包含不支持的識別碼。
IUIAutomation：：CompareElements 比較兩個 使用者介面自動化 元素，以判斷它們是否代表相同的基礎 UI 元素。
IUIAutomation：：CompareRuntimeIds 比較兩個包含運行時間標識碼的整數數位上 (標識碼) ，以判斷其內容是否相同，而且它們屬於相同的UI元素。
IUIAutomation：：CreateAndCondition 建立條件，以選取符合兩個條件的元素。
IUIAutomation：：CreateAndConditionFromArray 建立條件，以根據多個條件選取元素，其中所有條件都必須為 true。
IUIAutomation：：CreateAndConditionFromNativeArray 根據必須全部為 true 的多個條件，建立條件，從原生陣列中選取元素。
IUIAutomation：：CreateCacheRequest 建立快取要求。
IUIAutomation：：CreateFalseCondition 建立一律為 false 的條件。
IUIAutomation：：CreateNotCondition 建立條件，該條件是指定條件的負數。
IUIAutomation：：CreateOrCondition 建立兩個條件的組合，其中如果其中一個條件成立，則為相符專案。
IUIAutomation：：CreateOrConditionFromArray 建立兩個或多個條件的組合，其中如果任一條件成立，則存在相符專案。
IUIAutomation：：CreateOrConditionFromNativeArray 建立兩個或多個條件的組合，其中如果任一條件成立，則存在相符專案。
IUIAutomation：：CreatePropertyCondition 建立條件，以選取具有指定值之屬性的專案。
IUIAutomation：：CreatePropertyConditionEx 使用選擇性旗標，建立條件，以選取具有具有具有指定值之屬性的專案。
IUIAutomation：：CreateProxyFactoryEntry 建立 Proxy Factory 物件的新實例。
IUIAutomation：：CreateTreeWalker 擷取可用來周遊 Microsoft 使用者介面自動化 樹狀結構的樹狀結構逐步解說工具物件。
IUIAutomation：：CreateTrueCondition 擷取會選取所有元素的預先定義條件。
IUIAutomation：：ElementFromHandle 擷取指定視窗的 使用者介面自動化 專案。
IUIAutomation：：ElementFromHandleBuildCache 擷取指定視窗的 使用者介面自動化 專案、預先擷取要求的屬性和控制模式，並將預先擷取的專案儲存在快取中。
IUIAutomation：：ElementFromIAccessible 從 Microsoft Active Accessibility 伺服器擷取指定之可存取物件的 使用者介面自動化 專案。
IUIAutomation：：ElementFromIAccessibleBuildCache 從 Microsoft Active Accessibility 伺服器擷取指定之可存取物件的 使用者介面自動化 專案、預先擷取要求的屬性和控制模式，並將預先擷取的專案儲存在快取中。
IUIAutomation：：ElementFromPoint 擷取桌面上指定點的 使用者介面自動化 專案。
IUIAutomation：：ElementFromPointBuildCache 擷取桌面上指定點的 使用者介面自動化 專案、預先擷取要求的屬性和控制模式，並將預先擷取的專案儲存在快取中。
IUIAutomation：：get_ContentViewCondition 擷取預先定義的 IUIAutomationCondition 介面，以選取內容元素。
IUIAutomation：：get_ContentViewWalker 擷取用來探索內容元素的 IUIAutomationTreeWalker 介面。
IUIAutomation：：get_ControlViewCondition 擷取預先定義的 IUIAutomationCondition 介面，以選取控件元素。
IUIAutomation：：get_ControlViewWalker 擷取用來探索控件專案的 IUIAutomationTreeWalker 介面。
IUIAutomation：：get_ProxyFactoryMapping 擷取 物件，此物件表示 Window 類別名稱與相關聯數據與個別 Proxy Factory 的對應。
IUIAutomation：：get_RawViewCondition 擷取預先定義的 IUIAutomationCondition 介面，以選取未篩選檢視中的所有 UI 元素。
IUIAutomation：：get_RawViewWalker 擷取用來周遊 Microsoft 使用者介面自動化 樹狀結構之未篩選檢視的樹狀結構逐步解說工具物件。
IUIAutomation：：get_ReservedMixedAttributeValue 擷取靜態 Token 物件，代表混合屬性的文字屬性。
IUIAutomation：：get_ReservedNotSupportedValue 擷取靜態 Token 物件，代表不支援的屬性或文字屬性。
IUIAutomation：：GetFocusedElement 擷取具有輸入焦點的 使用者介面自動化 專案。
IUIAutomation：：GetFocusedElementBuildCache 擷取具有輸入焦點的 使用者介面自動化 專案、預先擷取要求的屬性和控制模式，並將預先擷取的專案儲存在快取中。
IUIAutomation：：GetPatternProgrammaticName 擷取控件模式的已註冊程式設計名稱。
IUIAutomation：：GetPropertyProgrammaticName 擷取屬性的已註冊程式設計名稱。
IUIAutomation：：GetRootElement 擷取代表桌面的 使用者介面自動化 專案。
IUIAutomation：：GetRootElementBuildCache 擷取代表桌面的 使用者介面自動化 元素、預先擷取所要求的屬性和控制模式，並將預先擷取的專案儲存在快取中。
IUIAutomation：：IntNativeArrayToSafeArray 將整數陣轉換為 SAFEARRAY。
IUIAutomation：：IntSafeArrayToNativeArray 將整數的 SAFEARRAY 轉換為陣列。
IUIAutomation：:P ollForPotentialSupportedPatterns 擷取 使用者介面自動化 專案可能支援的控件模式。
IUIAutomation：:P ollForPotentialSupportedProperties 擷取 使用者介面自動化 專案上可能支援的屬性。
IUIAutomation：：RectToVariant 建立 VARIANT，其中包含矩形的座標。
IUIAutomation：：RemoveAllEventHandlers 拿掉所有已註冊的 Microsoft 使用者介面自動化 事件處理程式。
IUIAutomation：：RemoveAutomationEventHandler 拿掉指定的 使用者介面自動化 事件處理程式。
IUIAutomation：：RemoveFocusChangedEventHandler 拿掉焦點變更的事件處理程式。
IUIAutomation：：RemovePropertyChangedEventHandler 拿掉屬性變更的事件處理程式。
IUIAutomation：：RemoveStructureChangedEventHandler 拿掉結構變更的事件處理程式。
IUIAutomation：：SafeArrayToRectNativeArray 將包含矩形座標的 SAFEARRAY 轉換為 RECT 類型的陣列。
IUIAutomation：：VariantToRect 將包含矩形座標的 VARIANT 轉換為 RECT。

備註

每個 使用者介面自動化 用戶端應用程式都必須取得 CUIAutomation 物件的這個介面，才能存取 使用者介面自動化 的功能。

下列範例函式會建立 CUIAutomation 物件，並取得 IUIAutomation 介面。

IUIAutomation *g_pAutomation;

BOOL InitializeUIAutomation()
{
    CoInitialize(NULL);
    HRESULT hr = CoCreateInstance(__uuidof(CUIAutomation), NULL, CLSCTX_INPROC_SERVER, 
        __uuidof(IUIAutomation), (void**)&g_pAutomation);
    return (SUCCEEDED(hr));
}

規格需求

需求	值
最低支援的用戶端	Windows 7、Windows Vista SP2 和 Platform Update for Windows Vista、Windows XP 含 SP3 和適用於 Windows Vista 的平臺更新 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008、Windows Server 2003 SP2 和 Platform Update for Windows Server 2008 [僅限桌面應用程式]
目標平台	Windows
標頭	uiautomationclient.h (包含 UIAutomation.h)

另請參閱

用戶端的 使用者介面自動化 元素介面