展開 最小化

AutomationProperties.Name Attached Property

要素の UI オートメーション名を取得または設定します。


<object AutomationProperties.Name="nameString" />

XAML Values

nameString

要素の名前。

解説

AutomationProperties.Name は、XAML の使用をサポートする添付プロパティです。コードでこのプロパティを取得する場合、GetName を使用します。コードでこのプロパティを設定する場合、SetName を代わりに使用します。コードを使用する場合、target パラメーターは、添付プロパティの値が設定されているオブジェクトです。コードで値を取得または設定する別の方法は、依存関係プロパティ システムを使用して、GetValue または SetValue を呼び出し、依存関係プロパティの識別子として NameProperty を渡す方法です。

AutomationProperties.Name 添付プロパティおよび AutomationProperties 添付プロパティの目的は、存在しない、またはコントロール定義かコントロールの適用されている汎用テンプレートに定義されている動作のインスタンス値を提供することです。

AutomationProperties.Name は、UI オートメーション クライアントが選択する可能性が最も高いオートメーション プロパティです。UI のほとんどのコントロールの既定のピア実装にはロジックが含まれており、このロジックは、オートメーション ツリーを走査してテキスト コンテンツを検索し、そのテキスト コンテンツは、AutomationProperties.Name のためにコントロールで生成された既定値として使用されます。たとえば、Button コントロールの既定インスタンスでは、ButtonAutomationPeer ピアを使用します。このピアでは、ボタンのコンテンツ内で見つかった内部テキストを UI オートメーションの Name プロパティ値に上位変換する動作を実装しています。したがって、すべての UI 要素に日常的に AutomationProperties.Name を設定する前に、最初に実行時に UI オートメーション構造をテストすることが望まれます。既定のピアの動作を使用している場合は、通常、既にインストールされているその他の機構を利用できます。たとえば、ButtonContent の設定に Binding を使用している場合、オートメーション ピアの動的な実行時の動作は、ローカライズされた文字列とリソース ディクショナリを使用している可能性がある評価済みの束縛を使用できます。このため、AutomationProperties.Name 値を個別にローカライズする必要はありません。

要件

最小限サポートされるクライアント

Windows 8

最小限サポートされるサーバー

Windows Server 2012

名前空間

Windows.UI.Xaml.Automation

メタデータ

Windows.winmd

参照

AutomationProperties

 

 

表示:
© 2015 Microsoft