AutomationProperties.Name Attached Property

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


<object AutomationProperties.Name="nameString" />

XAML Values

nameString

項目的名稱。

備註

AutomationProperties.Name 是支援 XAML 用法的附加屬性。在程式碼中取得這個屬性時,請使用 GetName。在程式碼中設定這個屬性時,請改為使用 SetName。在程式碼用法中,目標參數是已設定附加屬性值的物件。另一個在程式碼中取得或設定值的方法是使用相依性屬性系統,呼叫 GetValueSetValue 並傳遞 NameProperty 做為相依性屬性的識別項。

AutomationProperties.NameAutomationProperties 附加屬性的目的在於,為不存在或定義於控制項定義中或控制項已套用的泛型範本中的行為提供執行個體值。

AutomationProperties.Name 是使用者介面自動化用戶端最可能挑選的自動化屬性。大部分的 UI 控制項的預設對等實作,都包括查核進入自動化樹狀結構以尋找文字內容的嘗試,並使用該文字內容做為 AutomationProperties.Name 的控制項產生預設值。例如,預設的 Button 控制項執行個體會使用 ButtonAutomationPeer 對等。這個對等會實作一種行為,將按鈕內容內找到的任何內部文字升級為 UI Automation 的 Name 屬性值。因此,在常態性地設定所有 UI 項目的 AutomationProperties.Name 之前,建議您先在執行階段測試 UI 自動化結構。如果您使用預設對等行為,您通常可以利用已經準備就緒的其他機制。例如,如果使用 Binding 設定 ButtonContent,則自動化對等的動態執行階段行為可以使用可能會使用當地語系化字串及資源字典的已評估繫結,如此就不需要另行當地語系化 AutomationProperties.Name 值。

需求

支援的最小用戶端

Windows 8

支援的最小伺服器

Windows Server 2012

命名空間

Windows.UI.Xaml.Automation

Metadata

Windows.winmd

請參閱

AutomationProperties

 

 

顯示:
© 2014 Microsoft