AutomationProperties.NameProperty プロパティ

定義

名前空間:

Microsoft.UI.Xaml.Automation

添付プロパティ AutomationProperties.Name 識別します。これは、オートメーション要素の名前を保持する文字列です。

public:
 static property DependencyProperty ^ NameProperty { DependencyProperty ^ get(); };

static DependencyProperty NameProperty();

public static DependencyProperty NameProperty { get; }

var dependencyProperty = AutomationProperties.nameProperty;

Public Shared ReadOnly Property NameProperty As DependencyProperty

プロパティ値

DependencyProperty

AutomationProperties.Name 添付プロパティの識別子。

注釈

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

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

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

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

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

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