AutomationPeer.GetName 方法

定義

命名空間:

Microsoft.UI.Xaml.Automation.Peers

取得文字，這個文字描述與此自動化對等個體關聯的項目。 Microsoft 使用者介面自動化 Name 值是大部分輔助技術透過與 Microsoft 使用者介面自動化 架構互動來代表應用程式 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 使用者介面自動化 用戶端所使用。

備註

FrameworkElementAutomationPeer 藉由提供中繼 GetNameCore 實作來引進 GetName 的行為。 如果元素具有 LabeledByMicrosoft 使用者介面自動化 屬性的值，標籤元素的 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 執行階段 控件之特定對等類別的可能預設行為，請參閱一節中的參考主題，並尋找實作注意事項。

另請參閱

• 自訂自動化對等