Automation 元素屬性識別碼
本主題描述識別 Microsoft UI 自動化元素屬性的具名常數。
| 常數/值 | 描述 |
|---|---|
|
識別 AcceleratorKey 屬性，此字串包含快速鍵 (也稱為快速鍵) 自動化專案的組合。 快速鍵組合會叫用動作。 例如，CTRL+O 通常用來叫用 [開啟檔案一般] 對話方塊。 具有 AcceleratorKey 屬性的自動化專案可以針對相當於快速鍵命令的動作實作 Invoke 控制項模式。 變體類型： VT_BSTR 預設值：空字串 |
|
識別 AccessKey 屬性，這是包含自動化專案之便捷鍵字元的字串。 便捷鍵 (有時稱為助憶鍵) 是功能表、功能表項目或按鈕等控制項的文字字元，可啟動相關聯的功能表函式。 例如，若要開啟存取鍵通常是 F 的 [檔案] 功能表，使用者會按 ALT+F。 變體類型： VT_BSTR 預設值：空字串 |
|
識別 AnnotationObjects 屬性，這是檔中的注釋物件清單，例如批註、頁首、頁尾等等。 變體類型：VT_I4 | VT_ARRAY 預設值：空陣列 |
|
識別 AnnotationTypes 屬性，這是檔中批註類型的清單，例如批註、頁首、頁尾等等。 變體類型：VT_I4 | VT_ARRAY 預設值：空陣列 |
|
識別 AriaProperties 屬性，這是一個格式化字串，其中包含 Automation 元素的 Accessible Rich Internet Application (ARIA) 屬性資訊。 如需將 ARIA 狀態和屬性對應至使用者介面自動化屬性和函式的詳細資訊，請參閱 W3C 可存取豐富網際網路應用程式規格的 UI 自動化。 AriaProperties 是名稱/值組的集合，其分隔符號 = (等於) 和 ; (分號) ，例如「checked=true;disabled=false」。 當這些分隔符號或 \ 出現在值時， (\ 反斜線) 會當做逸出字元使用。 基於安全性和其他原因，此屬性的提供者實作可以採取步驟來驗證原始的 ARIA 屬性;不過，並非必要專案。 變體類型： VT_BSTR 預設值：空字串 |
|
識別 AriaRole 屬性，這是字串，其中包含 Automation 元素的可存取豐富網際網路應用程式 (ARIA) 角色資訊。 如需將 ARIA 角色對應至使用者介面自動化控制項類型的詳細資訊，請參閱 W3C 可存取豐富網際網路應用程式規格的 UI 自動化。 注意：
|
|
識別 AutomationId 屬性，這是字串，其中包含自動化專案的 UI 自動化識別碼 (識別碼) 。 可用時，不論本機語言為何，任何應用程式的實例中元素的 AutomationId 都必須相同。 值在同層級元素之間應該是唯一的，但不一定在整個桌面上是唯一的。 例如，應用程式多個實例或 Microsoft Windows 檔案總管中的多個資料夾檢視可以包含具有相同 AutomationId 屬性的專案，例如 「SystemMenuBar」。 雖然一律建議 對 AutomationId 的支援，以取得更佳的自動化測試支援，但這個屬性並非必要。 支援時， AutomationId 適用于建立不論 UI 語言為何的測試自動化腳本。 用戶端不應假設其他應用程式所公開的 AutomationId 值。 AutomationId 不保證可在應用程式的不同版本或組建之間穩定。 變體類型： VT_BSTR 預設值：空字串 |
|
識別 BoundingRectangle 屬性，這個屬性會指定完全括住自動化專案之矩形的座標。 矩形是以實體螢幕座標表示。 如果 UI 專案的圖形或可點選區域不規則，或是專案被其他 UI 元素遮蔽，它可以包含無法點選的點。 變體類型：VT_R8 | VT_ARRAY 預設值：[0，0，0，0] 注意：
|
|
識別 CenterPoint 屬性，指定自動化專案的中心 X 和 Y 點座標。 座標空間是提供者以邏輯方式考慮的頁面。 變體類型：VT_R8 | VT_ARRAY 預設值： VT_EMPTY |
|
識別 ClassName 屬性，這是字串，其中包含控制項開發人員所指派之自動化專案的類別名稱。 類別名稱取決於使用者介面自動化提供者的實作，因此不一定是標準格式。 不過，如果已知類別名稱，它可以用來驗證應用程式是否使用預期的自動化專案。 變體類型： VT_BSTR 預設值：空字串 |
|
識別 ClickablePoint 屬性，這是可按一下之自動化專案上的點。 如果元素被另一個視窗完全或部分遮蔽，則無法按一下它。 變體類型：VT_R8 | VT_ARRAY 預設值： VT_EMPTY |
|
識別 ControllerFor 屬性，這是支援此屬性之自動化元素所操作的自動化元素陣列。 當自動化專案影響應用程式 UI 或桌面的一或多個區段時，會使用ControllerFor;否則，很難將控制項作業的影響與 UI 元素產生關聯。 此識別碼通常用於 自動建議協助工具。 提供者的變體類型：VT_UNKNOWN | VT_ARRAY 用戶端的變體類型： VT_UNKNOWN (IUIAutomationElementArray ) 預設值：空陣列 |
|
識別 ControlType 屬性，這是識別自動化專案類型的類別。 ControlType 會依已知 UI 控制項基本類型定義 UI 元素的特性，例如按鈕或核取方塊。 Variant 類型： VT_I4 預設值： UIA_CustomControlTypeId 注意：
|
|
識別Culture屬性，其中包含自動化元素的地區設定識別碼 (，例如 0x0409 「en-US」 或英文 (美國) ) 。每個地區設定都有唯一識別碼，這是包含語言識別項和排序次序識別碼的 32 位值。 地區設定識別碼是標準國際數值縮寫，具有唯一識別其中一個已安裝作業系統定義地區設定的必要元件。 如需詳細資訊，請參閱 語言識別項常數和字串。 此屬性可能以個別控制項為基礎存在，但通常僅適用于應用層級。 Variant 類型： VT_I4 預設值：0 |
|
識別 DescribedBy 屬性，這是專案陣列，可提供自動化專案的詳細資訊。 當應用程式 UI 的另一個區段說明自動化專案時，會使用DescribedBy。 例如，屬性可以從複雜的自訂清單物件指向 「2，529 個群組中的 2，529 個專案，選取 10 個專案」。 除了將物件模型用於用戶端摘要類似的資訊， DescribedBy 屬性也可以快速存取可能已經提供描述 UI 元素之實用使用者資訊的 UI 元素。 提供者的變體類型：VT_UNKNOWN | VT_ARRAY 用戶端的變體類型： (VT_UNKNOWNIUIAutomationElementArray) 預設值：空陣列 |
|
識別 FillColor 屬性，指定用來填滿自動化專案的色彩。 此屬性指定為 COLORREF，這是用來指定 RGB 或 RGBA 色彩的 32 位值。 Variant 類型： VT_I4 預設值：0 |
|
識別 FillType 屬性，指定用來填滿自動化專案的圖樣，例如無、色彩、漸層、圖片、圖樣等等。 Variant 類型： VT_I4 預設值：0 |
|
識別 FlowFrom 屬性，這是一個自動化元素陣列，可建議目前自動化專案之前的讀取順序。 從 Windows 8 開始支援。 FlowFrom屬性會指定當自動化專案未公開或結構化時，讀取順序與使用者所感知的讀取順序相同。 雖然 FlowFrom 屬性可以指定多個上述元素，但通常只包含讀取順序中的先前元素。 提供者的變體類型：VT_UNKNOWN | VT_ARRAY 用戶端的變體類型： (VT_UNKNOWNIUIAutomationElementArray) 預設值：空陣列 |
|
識別 FlowTo 屬性，這是自動化元素陣列，可建議目前自動化專案之後的讀取順序。 當自動化專案未公開或結構化時， FlowTo 屬性會指定讀取順序，與使用者所感知的讀取順序相同。 雖然 FlowTo 屬性可以指定多個成功元素，但通常只包含讀取順序中的下一個專案。 提供者的變體類型：VT_UNKNOWN | VT_ARRAY 用戶端的變體類型： (VT_UNKNOWNIUIAutomationElementArray) 預設值：空陣列 |
|
識別 FrameworkId 屬性，這是字串，其中包含自動化專案所屬基礎 UI 架構的名稱。 FrameworkId可讓用戶端應用程式根據特定的 UI 架構，以不同的方式處理自動化專案。 屬性值的範例包括 「Win32」、「WinForm」 和 「DirectUI」。 Variant 類型： VT_BSTR 預設值：空字串 |
|
FullDescription屬性會公開當地語系化字串，其中包含專案的擴充描述文字。 FullDescription 可以包含比元素 Name更完整的專案描述。 Variant 類型： VT_BSTR 預設值：空字串 |
|
識別 HasKeyboardFocus 屬性，這是布林值，指出自動化專案是否具有鍵盤焦點。 Variant 類型： VT_BOOL 預設值： FALSE |
|
識別 HeadingLevel 屬性，這個屬性工作表示 UI 自動化專案的標題層級。 Variant 類型： VT_I4 預設值： HeadingLevel_None |
|
識別 HelpText 屬性，這是與自動化專案相關聯的解說文字字串。 您可以在編輯或清單控制項中顯示的預留位置文字支援 HelpText 屬性。 例如，「在這裡輸入文字以供搜尋」是一個適合的候選項目，適用于在使用者實際輸入之前放置文字的編輯控制項的 HelpText 屬性。 不過，它不適用於編輯控制項的名稱屬性。 支援 HelpText 時，字串必須符合應用程式 UI 語言或作業系統預設 UI 語言。 Variant 類型： VT_BSTR 預設值：空字串 |
|
識別 IsContentElement 屬性，這是布林值，指定專案是否出現在自動化專案樹狀結構的內容檢視中。 如需詳細資訊，請參閱 UI 自動化樹狀結構概觀。 注意：
|
|
識別 IsControlElement 屬性，這是布林值，指定專案是否出現在自動化專案樹狀結構的控制項檢視中。 如需詳細資訊，請參閱 UI 自動化樹狀結構概觀。 Variant 類型： VT_BOOL 預設值： TRUE |
|
識別 IsDataValidForForm 屬性，這是布林值，指出輸入或選取的值是否對與自動化專案相關聯的表單規則有效。 例如，如果使用者針對需要 5 或 9 位數的郵遞區號欄位輸入 「425-555-5555」， IsDataValidForForm 屬性可以設定為 FALSE ，表示資料無效。 Variant 類型： VT_BOOL 預設值： FALSE |
|
識別 IsDialog 屬性，這是布林值，指出自動化專案是否為對話方塊視窗。 例如，螢幕助讀程式之類的輔助技術通常會說出對話方塊的標題、對話方塊的焦點控制項，然後將對話方塊的內容移至焦點控制項 (「您要在關閉之前儲存變更」) 。 針對標準視窗，螢幕助讀程式通常會說出視窗標題，後面接著焦點控制項。 IsDialog屬性可以設定為TRUE，表示用戶端應用程式應該將元素視為對話方塊視窗。 Variant 類型： VT_BOOL 預設值： FALSE |
|
識別 IsEnabled 屬性，這是布林值，指出自動化專案所參考的 UI 專案是否已啟用，而且可以與其互動。 當控制項的啟用狀態為 FALSE時，會假設子控制項也不會啟用。 當父控制項的狀態變更時，用戶端不應該預期子項目的屬性變更事件。 Variant 類型： VT_BOOL 預設值： FALSE |
|
識別 IsKeyboardFocusable 屬性，這是布林值，指出自動化專案是否可以接受鍵盤焦點。 Variant 類型： VT_BOOL 預設值： FALSE |
|
識別 IsOffscreen 屬性，這是布林值，指出自動化專案是否完全從檢視中捲動 (例如，位於容器物件的檢視區外部的專案) 或折迭出檢視區 (例如樹狀檢視或功能表的專案， 或在最小化視窗中) 。 如果元素具有可點選的點，可能會導致它接收焦點，則會將元素視為畫面上，而元素的部分是螢幕外。 屬性的值不會受到其他視窗的遮蔽影響，或是專案是否顯示在特定監視器上。 如果 IsOffscreen 屬性為 TRUE，UI 元素會從螢幕外捲動或折迭。 元素會暫時隱藏，但仍會保留在使用者的認知中，並繼續包含在 UI 模型中。 您可以藉由捲動、按一下下拉式清單等等，將物件帶回檢視。 使用者完全不會察覺的物件，或是「以程式設計方式隱藏」 (的物件，例如已關閉的對話方塊，但應用程式仍會快取基礎物件) 不應該在第一個位置的自動化專案樹狀結構中 (，而不是將 IsOffscreen 的狀態設定為 TRUE) 。 Variant 類型： VT_BOOL 預設值： FALSE |
|
識別 IsPassword 屬性，這是布林值，指出自動化專案是否包含受保護的內容或密碼。 當 IsPassword 屬性為 TRUE 且元素具有鍵盤焦點時，用戶端應用程式應該停用鍵盤回應或鍵盤輸入意見反應，以公開使用者受保護的資訊。 嘗試存取受保護專案的 Value 屬性， (編輯控制項) 可能會導致錯誤發生。 Variant 類型： VT_BOOL 預設值： FALSE |
|
識別 IsPeripheral 屬性，這是布林值，指出自動化專案是否代表周邊 UI。 周邊 UI 隨即出現並支援使用者互動，但在出現時不會取得鍵盤焦點。 周邊 UI 的範例包括快顯視窗、飛出視窗、操作功能表或浮動通知。 從 Windows 8.1 開始支援。 當 IsPeripheral 屬性為 TRUE時，即使目前是鍵盤互動，用戶端應用程式也無法假設元素會採用焦點。 此屬性與下列控制項類型相關：
預設值： FALSE |
|
識別 IsRequiredForForm 屬性，這是布林值，指出是否需要在表單上填寫自動化專案。 Variant 類型： VT_BOOL 預設值： FALSE |
|
識別 ItemStatus 屬性，這是描述自動化專案專案狀態的文字字串。 ItemStatus 可讓用戶端確認專案是否要傳達專案的狀態，以及狀態是什麼。 例如，與訊息應用程式中連絡人相關聯的專案可能是「忙碌」或「已連線」。 支援 ItemStatus 時，字串必須符合應用程式 UI 語言或作業系統預設 UI 語言。 Variant 類型： VT_BSTR 預設值：空字串 |
|
識別 ItemType 屬性，這是描述自動化專案類型的文字字串。 ItemType 可用來取得清單、樹狀檢視或資料格中專案的相關資訊。 例如，檔案目錄檢視中的專案可能是「檔檔案」或「資料夾」。 支援 ItemType 時，字串必須符合應用程式 UI 語言或作業系統預設 UI 語言。 Variant 類型： VT_BSTR 預設值：空字串 |
|
識別 LabeledBy 屬性，這是包含這個專案文字標籤的自動化專案。 此屬性可用來擷取下拉式方塊的靜態文字標籤。 Variant 類型： VT_UNKNOWN 預設值： Null |
|
識別 LandmarkType 屬性，這是與專案相關聯的 地標類型識別碼 。 LandmarkType屬性描述代表專案群組的專案。 例如，搜尋地標可以代表一組相關的控制項以供搜尋。 如果使用 UIA_CustomLandmarkTypeId ，則需要 UIA_LocalizedLandmarkTypePropertyId 來描述自訂地標。 Variant 類型： VT_I4 預設值：0 |
|
識別 Level 屬性，這是與自動化專案相關聯的 1 型整數。 Level屬性描述階層式或中斷階層式結構內元素的位置。 例如，點符/編號清單、標題或其他結構化資料項目可以有各種父/子關聯性。 層級 描述專案所在結構中的位置。 建議搭配層級使用CustomNavigation 控制項模式。 變體類型： VT_I4 預設值：0 |
|
識別 LiveSetting 屬性，這個屬性是由代表即時區域的自動化專案所支援。 LiveSetting屬性工作表示用戶端應該用來通知使用者即時區域的變更的「有禮」層級。 這個屬性可以是 LiveSetting 列舉中的其中一個值。 從 Windows 8 開始支援。 變體類型： VT_I4 預設值：0 |
|
識別 LocalizedControlType 屬性，這是描述自動化專案所代表控制項類型的文字字串。 字串應該只包含小寫字元：
當 LocalizedControlType 不是由元素提供者指定時，架構會根據元素的控制項類型 (提供預設當地語系化字串，例如， 按鈕 控制項類型的 「button」) 。 具有 自訂 控制項類型的自動化專案必須支援當地語系化的控制項類型字串，此字串代表元素 (的角色，例如，自訂控制項的「色彩選擇器」可讓使用者選擇及指定色彩) 。 提供自訂值時，字串必須符合應用程式 UI 語言或作業系統預設 UI 語言。 變體類型： VT_BSTR 預設值：空字串 |
|
識別 LocalizedLandmarkType，這是描述自動化專案所代表之地標類型的文字字串。 這應該與UIA_CustomLandmarkTypeId搭配使用，但LocalizedLandmarkType應該一律優先于LandmarkType，並且用來描述地標之前地標。 字串必須符合應用程式 UI 語言或作業系統預設 UI 語言。 變體類型： VT_BSTR 預設值：空字串 |
|
識別 Name 屬性，這是保存自動化專案名稱的字串。 Name屬性應該與螢幕上的標籤文字相同。 例如， 名稱 應該是 「Browse」 標籤為 「Browse」 的按鈕元素。 Name屬性不得包含便捷鍵的助憶鍵字元 (，也就是 UI 文字簡報中加上底線的 「&」) 。 此外， Name 屬性不應該是螢幕上標籤的擴充或修改版本，因為名稱和標籤之間的不一致可能會導致用戶端應用程式和使用者混淆。 當畫面上看不到對應的標籤文字，或由圖形取代時，應該選擇替代文字。 替代文字應簡潔、直覺且當地語系化為應用程式 UI 語言，或作業系統預設 UI 語言。 替代文字不應該是視覺詳細資料的詳細描述，而是 UI 函式或功能的精簡描述，就像是簡單文字所標示一樣。 例如，Windows [開始] 功能表按鈕名為 [開始] 按鈕 (按鈕) ，而不是 [藍色圓球圖形上的 Windows 標誌] (按鈕) 。 如需詳細資訊，請參閱 建立影像的文字對等專案。 例如，當 UI 標籤使用文字圖形 (時，針對從左至右) 新增專案的按鈕使用 「>>」， 則 Name 屬性應該由適當的文字替代 (覆寫，例如「Add」) 。 不過，基於當地語系化和協助工具考慮，不建議使用文字圖形作為 UI 標籤的做法。 Name屬性不得包含控制項角色或類型資訊，例如 「按鈕」或「清單」;否則，當附加這兩個屬性時，它會與LocalizedControlType屬性中的文字衝突， (許多現有的輔助技術會執行此動作) 。 Name屬性不能當做同層級之間的唯一識別碼使用。 不過，只要它與 UI 簡報一致，對等之間就可以支援相同的 Name 值。 針對測試自動化，用戶端應該考慮使用 AutomationId 或 RuntimeId 屬性。 只要也支援Text 模式，文字控制項不一定要讓Name屬性與控制項中顯示的文字相同。 變體類型： VT_BSTR 預設值：空字串 |
|
識別 NativeWindowHandle 屬性，這是整數，如果存在，表示自動化專案視窗的控制碼 (HWND) ;否則，此屬性為 0。 變體類型： VT_I4 預設值：0 |
|
識別 OptimizeForVisualContent 屬性，這是布林值，指出提供者是否只公開可見的專案。 提供者可以使用這個屬性，在處理非常大型的內容時，將效能優化。 例如，當使用者透過大型內容分頁時，提供者可以終結不再顯示的內容元素。 當內容元素終結時，提供者應該會 傳回UIA_E_ELEMENTNOTAVAILABLE 錯誤碼。 從 Windows 8 開始支援。 變體類型： VT_BOOL 預設值： FALSE |
|
識別 Orientation 屬性，這個屬性工作表示自動化專案所代表之控制項的方向。 屬性會以 OrientationType 列舉類型的值表示。 Orientation屬性由可以具有垂直或水準方向的控制項支援，例如捲軸和滑杆。 否則，它一律可以 OrientationType_None，這表示控制項沒有方向。 變體類型： VT_I4 預設值：0 (OrientationType_None) |
|
識別 OutlineColor 屬性，這個屬性會指定用於自動化專案外框的色彩。 這個屬性會指定為 COLORREF，這是用來指定 RGB 或 RGBA 色彩的 32 位值。 變體類型：VT_I4 | VT_ARRAY 預設值：0 |
|
識別 OutlineThickness 屬性，指定自動化專案外框的寬度。 變體類型：VT_R8 | VT_ARRAY 預設值： VT_EMPTY |
|
識別 PositionInSet 屬性，這是與自動化專案相關聯的 1 型整數。 PositionInSet 描述專案在一組元素內的序數位置，這些元素會被視為同層級。 PositionInSet 可與 SizeOfSet 屬性協調，以描述集合中的序數位置。 變體類型： VT_I4 預設值：0 |
|
識別 ProcessId 屬性，這是整數，表示自動化專案 (識別碼) 的進程識別碼。 作業系統會指派進程識別碼 (識別碼) 。 您可以在工作管理員中 [進程] 索引標籤的PID資料行中看到。 變體類型： VT_I4 預設值：0 |
|
識別 ProviderDescription 屬性，這是格式化字串，其中包含自動化專案之 UI 自動化提供者的來源資訊，包括 Proxy 資訊。 變體類型： VT_BSTR 預設值：空字串 |
|
識別 Rotation 屬性，這個屬性會以未指定的單位指定旋轉角度。 變體類型： VT_R8 預設值：0 |
|
識別 RuntimeId 屬性，這是代表自動化專案識別碼的整數陣列。 識別碼在桌面上是唯一的，但保證只在產生該識別碼的桌面 UI 內是唯一的。 識別碼可隨著時間重複使用。 RuntimeId的格式可以變更。 傳回的識別碼應該視為不透明值，並僅用於比較;例如，判斷自動化專案是否在快取中。 變體類型：VT_I4 | VT_ARRAY 預設值： VT_EMPTY |
|
識別 Size 屬性，指定自動化專案的寬度和高度。 變體類型：VT_R8 | VT_ARRAY 預設值： VT_EMPTY |
|
識別 SizeOfSet 屬性，這是與自動化專案相關聯的 1 型整數。 SizeOfSet 描述群組或集合中視為同層級的自動化元素計數。 SizeOfSet 可與 PositionInSet 屬性協調，以描述集合中的專案計數。 變體類型： VT_I4 預設值：0 |
|
識別 VisualEffects 屬性，這是一個位欄位，指定對自動化元素的影響，例如陰影、反射、光暈、柔邊或斜面。 VisualEffects：
預設值：0 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows XP [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 |
Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 標頭 |
|
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應