AutomationProperties.Name 添付プロパティ

定義

名前空間:

Windows.UI.Xaml.Automation

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

see GetName, and SetName

see GetName, and SetName

see GetName, and SetName

注釈

プロパティは Name 、画面上のラベル テキストと同じである必要があります。 たとえば、 Name "Browse" というラベルが付いたボタン要素の場合は、"Browse" にする必要があります。 プロパティには Name 、UI テキスト プレゼンテーションで下線が付いたアクセス キー ("&" のニーモニック文字を含めてはいけません。 また、 Name 名前とラベルの間の不整合がクライアント アプリケーションとユーザーの間で混乱を引き起こす可能性があるため、このプロパティは、画面上のラベルの拡張または変更されたバージョンにしないでください。

対応するラベル テキストが画面上に表示されない場合、またはグラフィックスに置き換えられた場合は、代替テキストを選択する必要があります。 代替テキストは簡潔で直感的で、アプリケーション UI 言語またはオペレーティング システムの既定の UI 言語にローカライズする必要があります。 代替テキストは、ビジュアルの詳細の詳細な説明ではなく、単純なテキストでラベル付けされたかのように UI 関数または機能の簡潔な説明にする必要があります。 たとえば、Windows の [スタート] メニュー ボタンの名前は、"青い丸い球のグラフィックス上の Windows ロゴ" (ボタン) ではなく、"スタート" (ボタン) という名前です。 詳細については、「画像に 対応するテキストを作成する」を参照してください。

UI ラベルでテキスト グラフィックを使用する場合 (たとえば、左から右に項目を追加するボタンに ">>" を使用する場合) Name 、プロパティは適切な代替テキスト ("追加" など) によってオーバーライドする必要があります。 ただし、ローカライズとアクセシビリティの両方の問題により、テキスト グラフィックスを UI ラベルとして使用する方法はお勧めしません。

プロパティには Name 、"button" や "list" などのコントロール ロールまたは型情報を含めないでください。それ以外の場合、これら 2 つのプロパティが追加されると LocalizedControlType プロパティのテキストと競合します (多くの既存の支援テクノロジでこれを行います)。

プロパティは Name 、兄弟間の一意識別子として使用できません。 ただし、UI プレゼンテーションと一致している限り、ピア間で同じ Name 値をサポートできます。 テスト自動化の場合、クライアントは AutomationId または RuntimeId プロパティの使用を検討する必要があります。

Text パターンもサポートされている限り、テキスト コントロールは、コントロール内に表示されるテキストと常にプロパティが同じである必要Nameはありません。

さまざまな添付プロパティのうち、おそらく最も重要なものは です Name。 これは、ユーザーが Name アクセシビリティ シナリオでアプリを操作するときに、支援技術によって最も頻繁にアクセスおよび報告されるプロパティであるためです。 は Name 、UI 要素の人間が判読できる識別子として機能します。

さまざまな UI 要素には、他の要素プロパティに基づいて既定値 Name を提供できるピア 転送があります。 たとえば、Button クラスのピア 転送では、Button コンテンツの評価がToString転送され、この文字列が既定の として使用されますName。 その既定値をオーバーライドする場合、または使用できる Microsoft UI オートメーションNameがない UI 要素の場合に値を指定Nameするには、XAML でその要素に添付プロパティを設定Nameします。 Microsoft UI オートメーションNameが重要な理由の詳細については、「基本的なアクセシビリティ情報」を参照してください。 要素に、有用なピアが既に指定 Name されているかどうかをテストする方法の詳細については、「 アクセシビリティ テスト」を参照してください。

ローカライズの理由から、XAML で の文字列値をハードコーディングしないようにする Name 必要があります。 要素に x:Uid ディレクティブ を設定すると、RESW リソースを使用して プロパティをターゲットにし、ローカライズに異なる値を指定できます。 添付プロパティの場合、リソース識別子フォームには、名前空間と using: プレフィックスを含む、XAML 形式の添付プロパティの完全な修飾が必要です。 たとえば、x:Uid ディレクティブ値が "sendButton" であるリソースの添付プロパティ値をターゲットAutomationProperties.Nameにするには、NameRESW リソース内のデータ項目の値は次のようになります。sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name

• Type: 文字列
• 識別子フィールド: NameProperty
• アクセサー メソッド: GetName、 SetName

こちらもご覧ください

• XAML 添付プロパティ