AutomationPeer.GetNameCore 方法

  • 參考

定義

命名空間:
Windows.UI.Xaml.Automation.Peers
編輯

當 Microsoft UI 自動化用戶端呼叫 GetName 或對等的 Microsoft UI 自動化用戶端 API 時，提供對等的行為。

protected:
 virtual Platform::String ^ GetNameCore() = GetNameCore;
winrt::hstring GetNameCore();
protected virtual string GetNameCore();
function getNameCore()
Protected Overridable Function GetNameCore () As String

傳回

String

Platform::String

winrt::hstring

輔助技術和其他 Microsoft UI 自動化用戶端所使用的名稱。

備註

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

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

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

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

適用於

另請參閱