AutomationProperties.Name 附加屬性

定義

命名空間:

Windows.UI.Xaml.Automation

取得或設定專案的 使用者介面自動化 名稱。

see GetName, and SetName

see GetName, and SetName

see GetName, and SetName

備註

屬性 Name 應該與螢幕上的標籤文字相同。 例如， Name 應該是 「Browse」 標籤為按鈕元素的 「Browse」。 屬性 Name 不得包含訪問鍵 (的助記鍵字元，也就是UI文字簡報中加上底線的 「&」) 。 此外， Name 屬性不應該是螢幕上標籤的擴充或修改版本，因為名稱和標籤之間的不一致可能會導致用戶端應用程式和使用者混淆。

當畫面上看不到對應的標籤文字，或由圖形取代時，應該選擇替代文字。 替代文字應簡潔、直覺且當地語系化為應用程式 UI 語言，或操作系統預設 UI 語言。 替代文字不應該是視覺詳細數據的詳細描述，而是 UI 函式或功能的精簡描述，就像是簡單文字所標示一樣。 例如，Windows [開始] 選單按鈕名為 [開始] 按鈕 (按鈕) ，而不是 [藍色圓球圖形上的 Windows 標誌] (按鈕) 。 如需詳細資訊，請參閱 建立影像的文字對等專案。

例如，當 UI 標籤使用文字圖形 (時，針對從左至右) 新增專案的按鈕使用 “>>”， Name 則屬性應該由適當的文字替代 (覆寫，例如 “Add”) 。 不過，基於當地語系化和輔助功能考慮，不建議使用文字圖形作為UI標籤的做法。

屬性 Name 不得包含控件角色或類型資訊，例如 「button」 或 「list」;否則，當附加這兩個屬性時，當附加這兩個屬性時，它將會與 LocalizedControlType 屬性中的文字衝突， (許多現有的輔助技術會執行此) 。

屬性 Name 不能當做同層級之間的唯一標識碼使用。 不過，只要它與UI簡報一致，對等之間就可以支援相同的 Name 值。 針對測試自動化，客戶端應該考慮使用 AutomationId 或 RuntimeId 屬性。

只要也支援 Text 模式，文字控件不一定要讓 Name 屬性與控件中顯示的文字相同。

在各種附加屬性中，最重要的屬性可能是 Name。 這是因為當用戶 Name 在輔助功能案例中與應用程式互動時，最常存取和回報的屬性。 Name做為UI元素的人類可讀取標識碼。

各種UI元素都有對等轉送，可根據其他元素屬性提供預設值 Name 。 例如， Button 類別的對等轉送會轉送 ToStringButton 內容的評估，並使用這個字串做為預設 Name。 若要覆寫該預設值，或為沒有任何 Microsoft 使用者介面自動化 Name 可用的任何 UI 元素案例提供Name值，請在 XAML 中設定Name該元素的附加屬性。 如需 Microsoft 使用者介面自動化 Name 為何很重要的詳細資訊，請參閱基本輔助功能資訊。 如需如何測試專案是否已經有對等提供 Name 且很有用的詳細資訊，請參閱 輔助功能測試。

基於本地化理由，您應該避免 XAML 中的 硬式編碼字串值 Name 。 如果您在 元素上設定 x：Uid 指示詞 ，則可以使用 RESW 資源來以 屬性為目標，並提供不同的當地語系化值。 對於附加屬性，資源標識符窗體需要 XAML 窗體中附加屬性的完整限定性，包括其命名空間和 using： 前置詞。 例如，若要 AutomationProperties.Name 以具有 x：Uid 指示 詞值為 「sendButton」 的資源上附加屬性值為目標， Name RESW 資源 中的數據項值 是 sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name

• 類型：字串
• 標識符欄位： NameProperty
• 存取子方法： GetName、 SetName

另請參閱

• XAML 附加屬性