共用方式為


AutomationPeer.GetNameCore 方法

定義

當 Microsoft 使用者介面自動化 用戶端呼叫 GetName 或對等的 Microsoft 使用者介面自動化 用戶端 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 使用者介面自動化 用戶端所使用的名稱。

備註

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 執行階段 控件之特定對等類別的可能預設行為,請參閱一節中的參考主題,並尋找該特定對等類別的參考主題。

適用於

另請參閱