AutomationPeer.GetName 方法

定義

命名空間:

Windows.UI.Xaml.Automation.Peers

取得文字，這個文字描述與此自動化對等個體關聯的項目。 Microsoft UI 自動化 名稱 值是大部分輔助技術透過與 Microsoft UI 自動化架構互動來代表應用程式 UI 時所使用的主要識別碼。

public:
 virtual Platform::String ^ GetName() = GetName;

winrt::hstring GetName();

public string GetName();

function getName()

Public Function GetName () As String

傳回

String

Platform::String

winrt::hstring

對等擁有者的專案名稱，如輔助技術和其他 Microsoft UI 自動化用戶端所使用。

備註

FrameworkElementAutomationPeer 藉由提供中繼 GetNameCore 實作來引進 GetName 的行為。 如果元素具有 LabeledByMicrosoft UI 自動化屬性的值，標籤元素的 Name 值會當做 Name使用。

FrameworkElementAutomationPeer 也會透過內部 GetPlainText 方法引進行為，其他預設對等類別可能會覆寫這些方法，以便存取該控制項的內容模型，並針對 Name傳回有用的預設值。 例如，任何 ContentControl 衍生類別都會使用其 Content 值的字串表示作為預設 Name。 這是啟用的，因為 ContentControl 會在內部實作 GetPlainText ，並將該行為實作到所有 ContentControl 衍生類別。 例如，您會從Button的字串值取得有用的Name預設值。

其他特定對等可能也有中繼GetNameCore實作，可為該特定Windows 執行階段控制項提供內建值作為 Name的實用方法。 這些值的來源來自一般在 XAML 或應用程式使用者程式碼中設定的其他 UI 屬性。 例如， TextBoxAutomationPeer 會實作行為，使用擁有者 TextBox 中的 Text 屬性值做為預設 Name。 從使用者程式碼的觀點來看，您可以套用不同的 AutomationProperties.Name 值來覆寫預設行為。 從對等實作者/提供者的觀點來看，從現有的對等衍生新的對等類別、覆寫 GetNameCore，並提供一個新的實作，至少在某些情況下不會呼叫基底實作，即可變更對等的預設行為。

若要深入瞭解預設Windows 執行階段控制項之特定對等類別的可能預設行為，請參閱一節中的參考主題，並尋找該特定對等類別的實作注意事項。

另請參閱

• 自訂自動化對等