次の方法で共有

AutomationProperties.Name 添付プロパティ

  • リファレンス

定義

名前空間:
Microsoft.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

適用対象

こちらもご覧ください