AutomationProperties クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オートメーション プロパティのインスタンス レベルの値を取得または設定するためのサポートを提供します。 これらのプロパティ値は添付プロパティ (通常は XAML) として設定され、コントロールの AutomationPeerからオートメーション プロパティ値を補完またはオーバーライドします。
public ref class AutomationProperties sealed
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AutomationProperties final
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AutomationProperties
Public NotInheritable Class AutomationProperties
- 継承
- 属性
注釈
XAML 添付プロパティ
AutomationProperties は、のいくつかの
アタッチされたプロパティへの XAML プロセッサ アクセスをサポートし、同等の get 操作と set 操作をコードに公開するために、各 XAML 添付プロパティには、Get と set アクセサー メソッドのペアがあります。これは AutomationProperties のメンバーでもあります。 たとえば、GetName メソッドと SetName メソッドでは、名前添付プロパティを使用して XAML で設定するのではなく、Microsoft UI オートメーションに対するオートメーション 名前 値をレポートするための同等のコードのみのサポートが提供されます。 または、依存関係プロパティ システムを使用して添付プロパティの値を取得または設定できます。これにより、基になる値も Microsoft UI オートメーションに報告されます。 GetValue
Name プロパティ
さまざまな添付プロパティのうち、おそらく最も重要なものは 名前です。 これは、ユーザーがアクセシビリティ シナリオでアプリを操作するときに、支援技術によって最も頻繁にアクセスおよび報告される Name プロパティであるためです。 名 は、UI 要素の人間が判読できる識別子として機能します。
さまざまな UI 要素には、他の要素プロパティに基づいて既定の Name 値を提供できるピア 転送があります。 たとえば、Button クラスのピア 転送では、Button コンテンツの ToString 評価が転送され、この文字列が既定の Nameとして使用されます。 その既定値をオーバーライドしたり、Microsoft UI オートメーションの
ローカライズの理由から、XAML の Name の文字列値をハードコーディングしないようにする必要があります。 要素 x:Uid ディレクティブ を設定した場合は、RESW リソースを使用してプロパティをターゲットにし、ローカライズに異なる値を指定できます。 添付プロパティの場合、リソース識別子フォームには、名前空間と using: プレフィックスを含む、XAML 形式の添付プロパティの完全な修飾が必要です。 たとえば、x:Uid ディレクティブ 値が "sendButton"
添付プロパティ
手記
添付プロパティの詳細については、プロパティの Identifier フィールドのページを参照してください。
添付プロパティ | 形容 |
---|---|
AcceleratorKey | 指定した要素のアクセラレータ キーを取得または設定します。
|
AccessibilityView | 要素の Microsoft UI オートメーション ツリー ビュー モードを取得または設定します。 |
AccessKey | 指定した要素のアクセス キーを取得または設定します。
|
AutomationId | Microsoft UI オートメーションに対して要素を一意に識別する文字列を取得または設定します。
|
文化 | オートメーション要素のロケール識別子 ("en-US" や英語 (米国) の0x0409など) を取得または設定します。
|
FullDescription | 要素の拡張説明テキストを含むローカライズされた文字列を取得または設定します。
|
HeadingLevel | UI オートメーション要素の見出しレベルを取得または設定します。 |
HelpText | 要素のヘルプ テキストを取得または設定します。
|
IsDataValidForForm | データがフォームに対して有効かどうかを示す値を取得または設定します。 |
IsDialog | オートメーション要素がダイアログ ウィンドウかどうかを示す値を取得または設定します。
|
IsPeripheral | オートメーション要素が周辺機器 UI を表すかどうかを示す値を取得または設定します。
|
IsRequiredForForm | 要素をフォームに入力する必要があるかどうかを示す値を取得または設定します。 |
ItemStatus | 要素内の項目の状態の説明を取得または設定します。
|
ItemType | 指定した要素の型の説明を取得または設定します。
|
LabeledBy | 要素のテキスト ラベルを含む要素を取得または設定します。 |
LandmarkType | 要素に関連付けられた ランドマーク型識別子 を取得または設定します。 |
レベル | 階層構造または壊れた階層構造内の要素の位置を表す 1 から始まる整数を取得または設定します。
|
LiveSetting | 指定した要素のライブ設定値を取得または設定します。
|
LocalizedControlType | オートメーション要素が表すコントロールの種類を記述するローカライズされたテキスト文字列を取得または設定します。 |
LocalizedLandmarkType | オートメーション要素が表すランドマークの種類を記述するローカライズされたテキスト文字列を取得または設定します。 |
名前 | 要素の UI オートメーション名を取得または設定します。
|
PositionInSet | 兄弟と見なされる要素のセット内の要素の序数位置を表す 1 から始まる整数を取得または設定します。
|
SizeOfSet | 兄弟と見なされる要素のセット内の要素の数を取得または設定します。
|
プロパティ
AcceleratorKeyProperty |
AutomationProperties.AcceleratorKey 添付プロパティを識別します。これは、オートメーション要素のアクセラレータ キー (ショートカット キーとも呼ばれます) の組み合わせを含む文字列です。 |
AccessibilityViewProperty |
AutomationProperties.AccessibilityView 添付プロパティを識別します。 UI オートメーション クライアントによって要求された特定のモードに要素の可視性を変更するには、個々の要素にこの添付プロパティを設定します。 |
AccessKeyProperty |
AutomationProperties.AccessKey 添付プロパティを識別します。これは、オートメーション要素のアクセス キー文字を含む文字列です。 |
AnnotationsProperty |
コメント、ヘッダー、フッターなど、ドキュメント内の注釈オブジェクトの一覧に使用される依存関係プロパティを識別します。 |
AutomationControlTypeProperty |
|
AutomationIdProperty |
AutomationProperties.AutomationId 添付プロパティを識別します。これは、オートメーション要素の UI オートメーション識別子 (ID) を含む文字列です。 |
ControlledPeersProperty |
指定したオートメーション要素によって操作できるオートメーション要素のコレクションに使用される、ControlledPeers 添付プロパティを識別します。 |
CultureProperty |
オートメーション要素のロケール識別子を含むカルチャ添付プロパティの識別子を取得します (たとえば、"en-US" または英語 (米国) の0x0409)。 |
DescribedByProperty |
添付プロパティによって記述される識別子を取得します。これは、オートメーション要素に関する詳細情報を提供する要素の配列です。 |
FlowsFromProperty |
FlowsFrom 添付プロパティの識別子を取得します。これは、現在のオートメーション要素の前に読み取り順序を提案するオートメーション要素の配列です。 |
FlowsToProperty |
FlowsTo 添付プロパティの識別子を取得します。これは、現在のオートメーション要素の後の読み取り順序を提案するオートメーション要素の配列です。 |
FullDescriptionProperty |
要素の拡張説明テキストを含むローカライズされた文字列を公開する、完全な説明添付プロパティの識別子を取得します。 |
HeadingLevelProperty |
HeadingLevel 添付プロパティの識別子を取得します。これは、UI オートメーション要素の見出しレベルを示します。 |
HelpTextProperty |
AutomationProperties.HelpText 添付プロパティ |
IsDataValidForFormProperty |
データがフォームに対して有効かどうかを示すブール型の依存関係プロパティを識別します。 |
IsDialogProperty |
AutomationProperties.IsDialog 添付プロパティを識別します。これは、オートメーション要素がダイアログ ウィンドウであるかどうかを示すブール値です。 |
IsPeripheralProperty |
オートメーション要素が周辺機器 UI を表すかどうかを示すブール型の依存関係プロパティを識別します。 |
IsRequiredForFormProperty |
AutomationProperties.IsRequiredForForm 添付プロパティを識別します。これは、オートメーション要素をフォームに入力する必要があるかどうかを示すブール値です。 |
ItemStatusProperty |
ItemStatus 添付プロパティを識別します。これは、オートメーション要素項目の状態を表します。 |
ItemTypeProperty |
AutomationProperties.ItemType 添付プロパティを識別します。これは、オートメーション要素の型を記述するテキスト文字列です。 |
LabeledByProperty |
AutomationProperties.LabeledBy 添付プロパティを識別します。これは、この要素のテキスト ラベルを含むオートメーション要素です。 |
LandmarkTypeProperty |
要素に関連付けられた ランドマーク型識別子 であるランドマーク型添付プロパティの識別子を取得します。 |
LevelProperty |
Level 添付プロパティの識別子を取得します。これは、オートメーション要素に関連付けられた 1 から始まる整数です。 |
LiveSettingProperty |
AutomationProperties.LiveSetting 添付プロパティを識別します。これは、ライブリージョンを表すオートメーション要素によってサポートされます。 |
LocalizedControlTypeProperty |
ローカライズされたコントロール型の依存関係プロパティを識別します。これは、オートメーション要素が表すコントロールの型を記述するテキスト文字列です。 |
LocalizedLandmarkTypeProperty |
ローカライズされたランドマーク型の添付プロパティの識別子を取得します。これは、オートメーション要素が表すランドマークの種類を記述するローカライズされたテキスト文字列です。 |
NameProperty |
AutomationProperties.Name 添付プロパティを識別します。これは、オートメーション要素の名前を保持する文字列です。 |
PositionInSetProperty |
PositionInSet 添付プロパティの識別子を取得します。これは、オートメーション要素に関連付けられた 1 から始まる整数です。 |
SizeOfSetProperty |
添付プロパティの識別子を取得します。 |
添付プロパティ
AcceleratorKey |
オートメーション要素のアクセラレータ キー (ショートカット キーとも呼ばれます) の組み合わせを含む文字列を取得または設定します。 |
AccessibilityView |
要素の Microsoft UI オートメーション ツリー ビュー モードを取得または設定します。 |
AccessKey |
オートメーション要素のアクセス キー文字を含む文字列を取得または設定します。 |
Annotations |
コメント、ヘッダー、フッターなど、ドキュメント内の注釈オブジェクトの一覧を取得します。 |
AutomationControlType |
Microsoft UI オートメーション クライアントに公開されるユーザー インターフェイス (UI) 要素の種類を識別します。 |
AutomationId |
Microsoft UI オートメーションに対して要素を一意に識別する文字列を取得または設定します。 |
ControlledPeers |
指定したオートメーション要素によって操作できるオートメーション要素のコレクションを取得します。 |
Culture |
オートメーション要素のロケール識別子 ("en-US" や英語 (米国) の0x0409など) を取得または設定します。 |
DescribedBy |
オートメーション要素に関する詳細情報を提供する要素の配列を取得します。 |
FlowsFrom |
現在のオートメーション要素の前に読み取り順序を提案するオートメーション要素の配列を取得します。 |
FlowsTo |
現在のオートメーション要素の後の読み取り順序を示すオートメーション要素の配列を取得します。 |
FullDescription |
要素の拡張説明テキストを含むローカライズされた文字列を取得または設定します。 |
HeadingLevel |
UI オートメーション要素の見出しレベルを取得または設定します。 |
HelpText |
オートメーション要素に関連付けられているヘルプ テキスト文字列を取得または設定します。 |
IsDataValidForForm |
データがフォームに対して有効かどうかを示す値を取得または設定します。 |
IsDialog |
オートメーション要素がダイアログ ウィンドウかどうかを示す値を取得または設定します。 |
IsPeripheral |
オートメーション要素が周辺機器 UI を表すかどうかを示す値を取得または設定します。 |
IsRequiredForForm |
要素をフォームに入力する必要があるかどうかを示す値を取得または設定します。 |
ItemStatus |
要素内の項目の状態の説明を取得または設定します。 |
ItemType |
指定した要素の型の説明を取得または設定します。 |
LabeledBy |
この要素のテキスト ラベルを含むオートメーション要素を取得または設定します。 |
LandmarkType |
要素に関連付けられた ランドマーク型識別子 を取得または設定します。 |
Level |
階層構造または壊れた階層構造内の要素の位置を表す 1 から始まる整数を取得または設定します。 |
LiveSetting |
ライブ領域を表すオートメーション要素でサポートされている、指定した要素のライブ設定値を取得または設定します。 |
LocalizedControlType |
オートメーション要素が表すコントロールの種類を記述するローカライズされたテキスト文字列を取得または設定します。 |
LocalizedLandmarkType |
オートメーション要素が表すランドマークの種類を記述するローカライズされたテキスト文字列を取得または設定します。 |
Name |
要素の UI オートメーション名を取得または設定します。 |
PositionInSet |
兄弟と見なされる要素のセット内の要素の序数位置を表す 1 から始まる整数を取得または設定します。 |
SizeOfSet |
兄弟と見なされる要素のセット内の要素の数を取得または設定します。 |