次の方法で共有


AutomationPeer.GetNameCore メソッド

定義

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 オートメーション プロパティの値がある場合、ラベル付け要素の Name 値が Name として使用されます。

FrameworkElementAutomationPeer では、内部 の GetPlainText メソッドを介して動作も導入されます。この動作は、そのコントロールのコンテンツ モデルにアクセスし、 Name の便利な既定値を返すために、他の既定のピア クラスがオーバーライドする可能性があります。 たとえば、ContentControl 派生クラスでは、既定の Name として Content 値の文字列表現が使用されます。 これは、内部的に ContentControlGetPlainText を 実装し、その動作をすべての ContentControl 派生クラスに付与するためです。 これは、たとえば、Button の文字列値から便利な名前の既定値を取得する方法です。

他の特定のピアにも、中間の GetNameCore 実装があり、その特定のWindows ランタイムコントロールが Name の組み込み値を提供するのに役立つ方法を提供する場合があります。 これらの値のソースは、XAML またはアプリ ユーザー コードで通常設定される他の UI プロパティから取得されます。 たとえば、TextBoxAutomationPeer は、所有者 TextBoxText プロパティの値を既定の Name として使用する動作を実装します。 ユーザー コードの観点からは、別の AutomationProperties.Name 値を適用することで、既定の動作をオーバーライドできます。 ピア実装者/プロバイダーの観点から、ピアの既定の動作を変更するには、既存のピアから新しいピア クラスを派生させ、GetNameCore をオーバーライドし、少なくとも場合は基本実装を呼び出さない新しい実装を提供します。

既定のWindows ランタイム コントロールに対する特定のピア クラスの既定の動作の詳細については、その特定のピア クラスのリファレンス トピックを参照し、「解説」セクションで実装ノートを探してください。

適用対象

こちらもご覧ください