共用方式為


AutomationProperties.Name 附加屬性

定義

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

see GetName, and SetName
see GetName, and SetName
see GetName, and SetName

備註

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

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

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

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

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

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

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

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

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

適用於

另請參閱