AutomationProperties.NameProperty 屬性

定義

命名空間:

Microsoft.UI.Xaml.Automation

識別 AutomationProperties.Name 附加屬性，這是保存自動化專案名稱的字串。

public:
 static property DependencyProperty ^ NameProperty { DependencyProperty ^ get(); };

static DependencyProperty NameProperty();

public static DependencyProperty NameProperty { get; }

var dependencyProperty = AutomationProperties.nameProperty;

Public Shared ReadOnly Property NameProperty As DependencyProperty

屬性值

DependencyProperty

AutomationProperties.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 屬性與控件中顯示的文字相同。