Automation 要素のプロパティ識別子

このトピックでは、Microsoft UI オートメーション要素のプロパティを識別する名前付き定数について説明します。

定数/値 Description
UIA_AcceleratorKeyPropertyId
30006
AcceleratorKey プロパティを識別します。これは、オートメーション要素のアクセラレータ キー (ショートカット キーとも呼ばれます) の組み合わせを含む文字列です。
ショートカット キーの組み合わせによってアクションが呼び出されます。 たとえば、Ctrl + O は、多くの場合、[ファイルを開く] 共通ダイアログ ボックスを呼び出すために使用されます。 AcceleratorKey プロパティを持つオートメーション要素は、ショートカット コマンドと同等のアクションの Invoke コントロール パターンを実装できます。
バリアント型: VT_BSTR
既定値: 空の文字列
UIA_AccessKeyPropertyId
30007
AccessKey プロパティを識別します。これは、オートメーション要素のアクセス キー文字を含む文字列です。
アクセス キー (ニーモニックと呼ばれることもあります) は、メニュー、メニュー項目、またはボタンなどのコントロールのラベルのテキスト内の文字であり、関連付けられているメニュー関数をアクティブにします。 たとえば、アクセス キーが通常 F である [ファイル] メニューを開くには、ユーザーは Alt キーを押しながら F キーを押します。
バリアント型: VT_BSTR
既定値: 空の文字列
UIA_AnnotationObjectsPropertyId
30156
AnnotationObjects プロパティを識別します。これは、コメント、ヘッダー、フッターなど、ドキュメント内の注釈オブジェクトのリストです。
バリアント型: VT_I4 | VT_ARRAY
既定値: 空の配列
UIA_AnnotationTypesPropertyId
30155
AnnotationTypes プロパティを識別します。これは、コメント、ヘッダー、フッターなど、ドキュメント内の注釈の種類の一覧です。
バリアント型: VT_I4 | VT_ARRAY
既定値: 空の配列
UIA_AriaPropertiesPropertyId
30102
オートメーション要素の Accessible Rich Internet Application (ARIA) プロパティ情報を含む書式設定された文字列である AriaProperties プロパティを識別します。 ARIA の状態とプロパティを UI オートメーションのプロパティと関数にマッピングする方法の詳細については、「 UI Automation for W3C Accessible Rich Internet Applications Specification」を参照してください。
AriaProperties は、"checked=true;disabled=false" などの区切り記号 = (等しい) と ; (セミコロン) を持つ名前と値のペアのコレクションです。 \ (円記号) は、これらの区切り文字が値に表示される場合に\エスケープ文字として使用されます。 セキュリティやその他の理由により、このプロパティのプロバイダー実装では、元の ARIA プロパティを検証する手順を実行できます。ただし、必須ではありません。
バリアント型: VT_BSTR
既定値: 空の文字列
UIA_AriaRolePropertyId
30101
AriaRole プロパティを識別します。これは、Automation 要素のアクセシビリティ対応リッチ インターネット アプリケーション (ARIA) ロール情報を含む文字列です。 ARIA ロールを UI オートメーション コントロールの種類にマッピングする方法の詳細については、「 UI Automation for W3C Accessible Rich Internet Applications Specification」を参照してください

注:
オプションとして、ユーザー エージェントは LocalizedControlType プロパティで W3C ARIA ロールのローカライズされた説明を提供することもできます。 ローカライズされた文字列が指定されていない場合、システムは 要素の既定の LocalizedControlType 文字列を提供します。



バリアント型: VT_BSTR
既定値: 空の文字列

UIA_AutomationIdPropertyId
30011
AutomationId プロパティを識別します。これは、オートメーション要素の UI オートメーション識別子 (ID) を含む文字列です。
使用可能な場合、要素の AutomationId は、ローカル言語に関係なく、アプリケーションの任意のインスタンスで同じである必要があります。 値は兄弟要素間で一意である必要がありますが、デスクトップ全体で必ずしも一意であるとは限りません。 たとえば、アプリケーションの複数のインスタンス、または Microsoft Windows エクスプローラーの複数のフォルダー ビューには、"SystemMenuBar" などの同じ AutomationId プロパティを持つ要素を含めることができます。
AutomationId のサポートは、自動テストのサポートを向上するために常に推奨されますが、このプロパティは必須ではありません。 サポートされている場合、 AutomationId は、UI 言語に関係なく実行されるテスト自動化スクリプトを作成する場合に便利です。 クライアントは、他のアプリケーションによって公開される AutomationId 値に関する想定を行うべきではありません。 AutomationId は、アプリケーションの異なるリリースまたはビルド間で安定するとは限りません。
バリアント型: VT_BSTR
既定値: 空の文字列
UIA_BoundingRectanglePropertyId
30001
オートメーション要素を完全に囲む四角形の座標を指定する BoundingRectangle プロパティを識別します。 四角形は、物理的な画面座標で表されます。 UI 項目の図形またはクリック可能領域が不規則な場合、または項目が他の UI 要素によって隠されている場合は、クリックできないポイントを含めることができます。
バリアント型: VT_R8 | VT_ARRAY
既定値: [0,0,0,0]

注:
アイテムが現在 UI を表示していない場合、このプロパティは NULL です。



UIA_CenterPointPropertyId
30165
オートメーション要素の中心 X と Y の点座標を指定する CenterPoint プロパティを識別します。 座標空間は、プロバイダーが論理的にページと見なすものです。
バリアント型: VT_R8 | VT_ARRAY
既定値: VT_EMPTY
UIA_ClassNamePropertyId
30012
ClassName プロパティを識別します。これは、コントロール開発者によって割り当てられたオートメーション要素のクラス名を含む文字列です。
クラス名は UI オートメーション プロバイダーの実装に依存するため、常に標準形式であるとは限りません。 ただし、クラス名がわかっている場合は、アプリケーションが予期されるオートメーション要素を使用していることを確認するために使用できます。
バリアント型: VT_BSTR
既定値: 空の文字列
UIA_ClickablePointPropertyId
30014
ClickablePoint プロパティを識別します。これは、クリックできるオートメーション要素上のポイントです。 要素が別のウィンドウで完全または部分的に隠れている場合、要素をクリックすることはできません。
バリアント型: VT_R8 | VT_ARRAY
既定値: VT_EMPTY
UIA_ControllerForPropertyId
30104
ControllerFor プロパティを識別します。これは、このプロパティをサポートするオートメーション要素によって操作されるオートメーション要素の配列です。
ControllerFor は、オートメーション要素がアプリケーション UI またはデスクトップの 1 つ以上のセグメントに影響を与える場合に使用されます。それ以外の場合、コントロール操作の影響を UI 要素に関連付けるのは困難です。
この識別子は、アクセシビリティの 自動提案に一般的に使用されます。
プロバイダーのバリアント型: VT_UNKNOWN | VT_ARRAY
クライアントのバリアント型: VT_UNKNOWN (IUIAutomationElementArray )
既定値: 空の配列
UIA_ControlTypePropertyId
30003
ControlType プロパティを識別します。これは、オートメーション要素の型を識別するクラスです。 ControlType は、ボタンやチェック ボックスなどの既知の UI コントロール プリミティブによって UI 要素の特性を定義します。
バリアント型: VT_I4
既定値: UIA_CustomControlTypeId

注:
オートメーション要素がまったく新しい種類のコントロールを表す場合にのみ、既定値を使用します。



UIA_CulturePropertyId
30015
オートメーション要素のロケール識別子 (たとえば、0x0409"en-US" や英語 (米国)) を含む Culture プロパティを識別します。
各ロケールには、一意識別子、言語識別子と並べ替え順序識別子で構成される 32 ビット値があります。 ロケール識別子は標準の国際数値省略形であり、インストールされているオペレーティング システムで定義されているロケールの 1 つを一意に識別するために必要なコンポーネントを持ちます。 詳細については、「 言語識別子の定数と文字列」を参照してください。
このプロパティはコントロールごとに存在する場合がありますが、通常はアプリケーション レベルでのみ使用できます。
バリアント型: VT_I4
既定値: 0
UIA_DescribedByPropertyId
30105
DescribedBy プロパティを識別します。これは、オートメーション要素に関する詳細情報を提供する要素の配列です。
DescribedBy は、オートメーション要素がアプリケーション UI の別のセグメントによって説明されるときに使用されます。 たとえば、 プロパティは、複雑なカスタム リスト オブジェクトから "85 グループ内の 2,529 アイテム、選択された 10 個の項目" のテキスト要素を指すことができます。 クライアントにオブジェクト モデルを使用して同様の情報をダイジェストする代わりに、 DescribedBy プロパティを使用すると、UI 要素を記述する便利なエンド ユーザー情報を既に提供している可能性がある UI 要素にすばやくアクセスできます。
プロバイダーのバリアント型: VT_UNKNOWN | VT_ARRAY
クライアントのバリアント型: VT_UNKNOWN (IUIAutomationElementArray)
既定値: 空の配列
UIA_FillColorPropertyId
30160
オートメーション要素の 塗りつぶし に使用する色を指定する FillColor プロパティを識別します。 この属性は、RGB または RGBA の色を指定するために使用される 32 ビット値である COLORREF として指定されます。
バリアント型: VT_I4
既定値: 0
UIA_FillTypePropertyId
30162
FillType プロパティを識別します。このプロパティは、オートメーション要素の塗りつぶしに使用されるパターン (なし、色、グラデーション、図、パターンなど) を指定します。
バリアント型: VT_I4
既定値: 0
UIA_FlowsFromPropertyId
30148
FlowsFrom プロパティを識別します。これは、現在のオートメーション要素の前に読み取り順序を提案するオートメーション要素の配列です。 Windows 8 以降でサポートされています。
FlowsFrom プロパティは、オートメーション要素がユーザーが認識するのと同じ読み取り順序で公開または構造化されていない場合の読み取り順序を指定します。 FlowsFrom プロパティでは、先行する複数の要素を指定できますが、通常、読み取り順序には前の要素のみが含まれます。
プロバイダーのバリアント型: VT_UNKNOWN | VT_ARRAY
クライアントのバリアント型: VT_UNKNOWN (IUIAutomationElementArray)
既定値: 空の配列
UIA_FlowsToPropertyId
30106
FlowsTo プロパティを識別します。これは、現在のオートメーション要素の後の読み取り順序を示すオートメーション要素の配列です。
FlowsTo プロパティは、オートメーション要素がユーザーによって認識されるのと同じ読み取り順序で公開または構造化されていない場合の読み取り順序を指定します。 FlowsTo プロパティは複数の後続の要素を指定できますが、通常は読み取り順序に次の要素のみが含まれます。
プロバイダーのバリアント型: VT_UNKNOWN | VT_ARRAY
クライアントのバリアント型: VT_UNKNOWN (IUIAutomationElementArray)
既定値: 空の配列
UIA_FrameworkIdPropertyId
30024
FrameworkId プロパティを識別します。これは、オートメーション要素が属する基になる UI フレームワークの名前を含む文字列です。
FrameworkId を使用すると、クライアント アプリケーションは、特定の UI フレームワークに応じて、オートメーション要素を異なる方法で処理できます。 プロパティ値の例としては、"Win32"、"WinForm"、"DirectUI" などがあります。
バリアント型: VT_BSTR
既定値: 空の文字列
UIA_FullDescriptionPropertyId
30159
FullDescription プロパティは、要素の拡張説明テキストを含めることができるローカライズされた文字列を公開します。 FullDescription には、要素 に適したより詳細な要素の説明を含めることができます。
バリアント型: VT_BSTR
既定値: 空の文字列
UIA_HasKeyboardFocusPropertyId
30008
HasKeyboardFocus プロパティを識別します。これは、オートメーション要素にキーボード フォーカスがあるかどうかを示すブール値です。
バリアント型: VT_BOOL
既定値: FALSE
UIA_HeadingLevelPropertyId
30173
UI オートメーション要素の見出しレベルを示す HeadingLevel プロパティを識別します。
バリアント型: VT_I4
既定値: HeadingLevel_None
UIA_HelpTextPropertyId
30013
オートメーション要素に関連付けられたヘルプ テキスト文字列である HelpText プロパティを識別します。
HelpText プロパティは、編集コントロールまたはリスト コントロールにプレースホルダー テキストが表示される場合にサポートできます。 たとえば、ユーザーの実際の入力の前にテキストを配置する編集コントロールの HelpText プロパティは、"検索用にここにテキストを入力する" の候補として適しています。 ただし、編集コントロールの name プロパティには適していません。
HelpText がサポートされている場合、文字列はアプリケーション UI 言語またはオペレーティング システムの既定の UI 言語と一致する必要があります。
バリアント型: VT_BSTR
既定値: 空の文字列
UIA_IsContentElementPropertyId
30017
IsContentElement プロパティを識別します。これは、要素がオートメーション要素ツリーのコンテンツ ビューに表示されるかどうかを指定するブール値です。 詳細については、「 UI オートメーション ツリーの概要」を参照してください。

注:
コンテンツ ビューに要素を表示するには、 IsContentElement プロパティと IsControlElement プロパティの両方が TRUE である必要があります。



バリアント型: VT_BOOL
既定値: TRUE

UIA_IsControlElementPropertyId
30016
IsControlElement プロパティを識別します。これは、オートメーション要素ツリーのコントロール ビューに要素が表示されるかどうかを指定するブール値です。 詳細については、「 UI オートメーション ツリーの概要」を参照してください。
バリアント型: VT_BOOL
既定値: TRUE
UIA_IsDataValidForFormPropertyId
30103
IsDataValidForForm プロパティを識別します。これは、入力した値または選択した値がオートメーション要素に関連付けられているフォーム ルールに対して有効かどうかを示すブール値です。 たとえば、ユーザーが 5 桁または 9 桁の郵便番号フィールドに "425-555-5555" と入力した場合、 IsDataValidForForm プロパティを FALSE に設定して、データが無効であることを示すことができます。
バリアント型: VT_BOOL
既定値: FALSE
UIA_IsDialogPropertyId
30174
IsDialog プロパティを識別します。これは、オートメーション要素がダイアログ ウィンドウであるかどうかを示すブール値です。 たとえば、スクリーン リーダーなどの支援技術は、通常、ダイアログのタイトル、ダイアログ内のフォーカスされたコントロール、フォーカスされたコントロールまでダイアログの内容を読み上げます ("閉じる前に変更を保存しますか")。 標準ウィンドウの場合、スクリーン リーダーは通常、ウィンドウ タイトルの後にフォーカスされたコントロールを読み上げます。 IsDialog プロパティを TRUE に設定すると、クライアント アプリケーションが要素をダイアログ ウィンドウとして扱う必要があることを示すことができます。
バリアント型: VT_BOOL
既定値: FALSE
UIA_IsEnabledPropertyId
30010
IsEnabled プロパティを識別します。これは、オートメーション要素によって参照される UI 項目が有効であり、操作できるかどうかを示すブール値です。
コントロールの有効状態が FALSE の場合、子コントロールも有効になっていないと見なされます。 親コントロールの状態が変更された場合、クライアントは子要素からプロパティ変更イベントを想定しないでください。
バリアント型: VT_BOOL
既定値: FALSE
UIA_IsKeyboardFocusablePropertyId
30009
IsKeyboardFocusable プロパティを識別します。これは、オートメーション要素がキーボード フォーカスを受け入れられるかどうかを示すブール値です。
バリアント型: VT_BOOL
既定値: FALSE
UIA_IsOffscreenPropertyId
30022
IsOffscreen プロパティを識別します。これは、オートメーション要素が完全にビュー外にスクロールされるか (たとえば、コンテナー オブジェクトのビューポートの外側にあるリスト ボックス内の項目)、またはビュー外に折りたたまれている (ツリー ビューやメニューの項目、最小化されたウィンドウ内など) かどうかを示すブール値です。 要素にクリック可能なポイントがあり、それがフォーカスを受け取る可能性がある場合、要素の一部が画面外である間、要素は画面上にあると見なされます。
プロパティの値は、他のウィンドウによるオクルージョンや、要素が特定のモニターに表示されているかどうかの影響を受けません。
IsOffscreen プロパティが TRUE の場合、UI 要素は画面外にスクロールされるか折りたたまれます。 要素は一時的に非表示になっていますが、エンド ユーザーの認識に残り、UI モデルに引き続き含まれます。 オブジェクトは、スクロールしたり、ドロップダウンをクリックしたりして、ビューに戻すことができます。
エンド ユーザーがまったく認識しないオブジェクト、または "プログラムによって非表示になっている" オブジェクト (たとえば、無視されたが、基になるオブジェクトはアプリケーションによってキャッシュされている) は、最初はオートメーション要素ツリーに配置しないでください ( IsOffscreen の状態を TRUE に設定する代わりに)。
バリアント型: VT_BOOL
既定値: FALSE
UIA_IsPasswordPropertyId
30019
IsPassword プロパティを識別します。これは、オートメーション要素に保護されたコンテンツまたはパスワードが含まれているかどうかを示すブール値です。
IsPassword プロパティが TRUE で、要素にキーボード フォーカスがある場合、クライアント アプリケーションは、ユーザーの保護された情報を公開する可能性があるキーボードエコーまたはキーボード入力フィードバックを無効にする必要があります。 保護された要素 (エディット コントロール) の Value プロパティにアクセスしようとすると、エラーが発生する可能性があります。
バリアント型: VT_BOOL
既定値: FALSE
UIA_IsPeripheralPropertyId
30150
IsPeripheral プロパティを識別します。これは、オートメーション要素が周辺機器 UI を表すかどうかを示すブール値です。 周辺機器 UI が表示され、ユーザーの操作がサポートされますが、表示されるときにキーボード フォーカスは使用されません。 周辺機器 UI の例としては、ポップアップ、ポップアップ、コンテキスト メニュー、フローティング通知などがあります。 Windows 8.1 以降でサポートされています。
IsPeripheral プロパティが TRUE の場合、クライアント アプリケーションでは、現在キーボード対話型であっても、 要素によってフォーカスが取得されたと見なすことはできません。
このプロパティは、次のコントロールの種類に関連します。
  • UIA_GroupControlTypeId
  • UIA_MenuControlTypeId
  • UIA_PaneControlTypeId
  • UIA_ToolBarControlTypeId
  • UIA_ToolTipControlTypeId
  • UIA_WindowControlTypeId
  • UIA_CustomControlTypeId
バリアント型: VT_BOOL
既定値: FALSE
UIA_IsRequiredForFormPropertyId
30025
IsRequiredForForm プロパティを識別します。これは、オートメーション要素をフォームに入力する必要があるかどうかを示すブール値です。
バリアント型: VT_BOOL
既定値: FALSE
UIA_ItemStatusPropertyId
30026
ItemStatus プロパティを識別します。これは、オートメーション要素の項目の状態を説明するテキスト文字列です。
ItemStatus を使用すると、クライアントは、要素がアイテムに関する状態と状態を伝えるかどうかを確認できます。 たとえば、メッセージング アプリケーションの連絡先に関連付けられているアイテムは、"ビジー" または "接続済み" である可能性があります。
ItemStatus がサポートされている場合、文字列はアプリケーション UI 言語またはオペレーティング システムの既定の UI 言語と一致する必要があります。
バリアント型: VT_BSTR
既定値: 空の文字列
UIA_ItemTypePropertyId
300021
ItemType プロパティを識別します。これは、オートメーション要素の型を説明するテキスト文字列です。
ItemType は、リスト、ツリー ビュー、またはデータ グリッド内の項目に関する情報を取得するために使用されます。 たとえば、ファイル ディレクトリ ビュー内のアイテムは、"ドキュメント ファイル" または "フォルダー" です。
ItemType がサポートされている場合、文字列はアプリケーション UI 言語またはオペレーティング システムの既定の UI 言語と一致する必要があります。
バリアント型: VT_BSTR
既定値: 空の文字列
UIA_LabeledByPropertyId
30018
LabeledBy プロパティを識別します。これは、この要素のテキスト ラベルを含むオートメーション要素です。
このプロパティは、コンボ ボックスの静的テキスト ラベルなどを取得するために使用できます。
バリアント型: VT_UNKNOWN
既定値: NULL
UIA_LandmarkTypePropertyId
30157
要素に関連付けられたランドマーク型識別子である LandmarkType プロパティを識別します。
LandmarkType プロパティは、要素のグループを表す要素を表します。 たとえば、検索ランドマークは、検索に関連する一連のコントロールを表します。
UIA_CustomLandmarkTypeIdを使用する場合は、カスタム ランドマークを記述するためにUIA_LocalizedLandmarkTypePropertyIdが必要です。
バリアント型: VT_I4
既定値: 0
UIA_LevelPropertyId
30154
Level プロパティを識別します。これは、オートメーション要素に関連付けられた 1 から始まる整数です。
Level プロパティは、階層構造または壊れた階層構造内の要素の位置を表します。 たとえば、箇条書き/段落番号付きリスト、見出し、またはその他の構造化データ項目には、さまざまな親子関係を持つことができます。 Level は、構造内の項目が配置されている場所を表します。
Level と共に CustomNavigation コントロール パターンを使用することをお勧めします。
バリアント型: VT_I4
既定値: 0
UIA_LiveSettingPropertyId
30135
LiveSetting プロパティを識別します。このプロパティは、ライブ リージョンを表すオートメーション要素によってサポートされます。 LiveSetting プロパティは、クライアントがライブ リージョンへの変更をユーザーに通知するために使用する必要がある "丁寧さ" レベルを示します。 このプロパティには、 LiveSetting 列挙の値のいずれかを指定できます。 Windows 8 以降でサポートされています。
バリアント型: VT_I4
既定値: 0
UIA_LocalizedControlTypePropertyId
30004
LocalizedControlType プロパティを識別します。これは、オートメーション要素が表すコントロールの種類を説明するテキスト文字列です。 文字列には小文字のみを含める必要があります。
  • 正解: "button"
  • 不正解: "ボタン"

LocalizedControlType が要素プロバイダーによって指定されていない場合、既定のローカライズされた文字列は、要素のコントロールの種類 (Button コントロール型の "button" など) に従ってフレームワークによって提供されます。 カスタム コントロール型のオートメーション要素は、要素の役割を表すローカライズされたコントロール型の文字列をサポートする必要があります (ユーザーが色を選択および指定できるようにするカスタム コントロールの "カラー ピッカー" など)。
カスタム値を指定する場合、文字列はアプリケーション UI 言語またはオペレーティング システムの既定の UI 言語と一致する必要があります。
バリアント型: VT_BSTR
既定値: 空の文字列
UIA_LocalizedLandmarkTypePropertyId
30158
LocalizedLandmarkType を識別します。これは、オートメーション要素が表すランドマークの種類を記述するテキスト文字列です。
ただし、これは UIA_CustomLandmarkTypeId と組み合わせて使用する必要がありますが、 LocalizedLandmarkType は常に LandmarkType よりも優先され、 ランドマークの前にランドマークを記述するために使用する必要があります。
文字列は、アプリケーション UI 言語またはオペレーティング システムの既定の UI 言語と一致する必要があります。
バリアント型: VT_BSTR
既定値: 空の文字列
UIA_NamePropertyId
30005
Name プロパティを識別します。これは、オートメーション要素の名前を保持する文字列です。
Name プロパティは、画面上のラベル テキストと同じである必要があります。 たとえば、ラベルが "Browse" の button 要素の 場合、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 プロパティがコントロール内に表示されるテキストと同じである必要はありません。
バリアント型: VT_BSTR
既定値: 空の文字列
UIA_NativeWindowHandlePropertyId
30020
NativeWindowHandle プロパティを識別します。これは、オートメーション要素ウィンドウのハンドル (HWND) を表す整数です (存在する場合)。それ以外の場合、このプロパティは 0 です。
バリアント型: VT_I4
既定値: 0
UIA_OptimizeForVisualContentPropertyId
30111
OptimizeForVisualContent プロパティを識別します。これは、プロバイダーが表示される要素のみを公開するかどうかを示すブール値です。 プロバイダーは、このプロパティを使用して、非常に大きなコンテンツを操作するときにパフォーマンスを最適化できます。 たとえば、ユーザーが大量のコンテンツをページ処理すると、プロバイダーは表示されなくなったコンテンツ要素を破棄できます。 コンテンツ要素が破棄されると、プロバイダーは UIA_E_ELEMENTNOTAVAILABLE エラー コードを返す必要があります。 Windows 8 以降でサポートされています。
バリアント型: VT_BOOL
既定値: FALSE
UIA_OrientationPropertyId
300023
Orientation プロパティを 識別します。これは、オートメーション要素によって表されるコントロールの向きを示します。 プロパティは、 OrientationType 列挙型の値として表されます。
Orientation プロパティは、垂直または水平方向の方向を持つコントロール (スクロール バーやスライダーなど) でサポートされています。 それ以外の場合は、常に OrientationType_Noneできます。つまり、コントロールに向きがないことを意味します。
バリアント型: VT_I4
既定値: 0 (OrientationType_None)
UIA_OutlineColorPropertyId
30161
オートメーション要素のアウトラインに使用される色を指定する OutlineColor プロパティを識別します。 この属性は、RGB または RGBA の色を指定するために使用される 32 ビット値である COLORREF として指定されます。
バリアント型: VT_I4 | VT_ARRAY
既定値: 0
UIA_OutlineThicknessPropertyId
30164
オートメーション要素のアウトラインの幅を指定する OutlineThickness プロパティを識別します。
バリアント型: VT_R8 | VT_ARRAY
既定値: VT_EMPTY
UIA_PositionInSetPropertyId
30152
PositionInSet プロパティを識別します。これは、オートメーション要素に関連付けられた 1 から始まる整数です。 PositionInSet は、兄弟と見なされる一連の要素内の要素の序数の位置を表します。
PositionInSetSizeOfSet プロパティと連携して、セット内の序数の位置を記述します。
バリアント型: VT_I4
既定値: 0
UIA_ProcessIdPropertyId
30002
ProcessId プロパティを識別します。これは、オートメーション要素のプロセス識別子 (ID) を表す整数です。
プロセス識別子 (ID) はオペレーティング システムによって割り当てられます。 これは、タスク マネージャーの [プロセス] タブの [PID] 列に表示されます。
バリアント型: VT_I4
既定値: 0
UIA_ProviderDescriptionPropertyId
30107
ProviderDescription プロパティを識別します。これは、オートメーション要素の UI オートメーション プロバイダーのソース情報 (プロキシ情報を含む) を含む書式設定された文字列です。
バリアント型: VT_BSTR
既定値: 空の文字列
UIA_RotationPropertyId
30166
回転角度を指定しない単位で指定する Rotation プロパティを識別します。
バリアント型: VT_R8
既定値: 0
UIA_RuntimeIdPropertyId
30000
RuntimeId プロパティを識別します。これは、オートメーション要素の識別子を表す整数の配列です。
識別子はデスクトップで一意ですが、生成されたデスクトップの UI 内でのみ一意であることが保証されます。 識別子は、時間の経過と同時に再利用できます。
RuntimeId の形式は変更できます。 返される識別子は不透明な値として扱い、比較にのみ使用する必要があります。たとえば、オートメーション要素がキャッシュ内にあるかどうかを判断します。
バリアント型: VT_I4 | VT_ARRAY
既定値: VT_EMPTY
UIA_SizePropertyId
30167
オートメーション要素の幅と高さを指定する Size プロパティを識別します。
バリアント型: VT_R8 | VT_ARRAY
既定値: VT_EMPTY
UIA_SizeOfSetPropertyId
30153
SizeOfSet プロパティを識別します。これは、オートメーション要素に関連付けられた 1 から始まる整数です。 SizeOfSet は、兄弟と見なされるグループまたはセット内のオートメーション要素の数を表します。
SizeOfSet はPositionInSet プロパティと連携して、セット内の項目数を記述します。
バリアント型: VT_I4
既定値: 0
UIA_VisualEffectsPropertyId
30163
VisualEffects プロパティを識別します。これは、影、反射、光彩、ぼかし、面取りなど、オートメーション要素に対する効果を指定するビット フィールドです。
VisualEffects:
  • VisualEffects_Shadow: 0x1
  • VisualEffects_Reflection: 0x2
  • VisualEffects_Glow: 0x4
  • VisualEffects_SoftEdges: 0x8
  • VisualEffects_Bevel: 0x10
バリアント型: VT_I4
既定値: 0

必要条件

要件
サポートされている最小のクライアント
Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー
Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
ヘッダー
UIAutomationClient.h

関連項目

概念

UI オートメーション プロパティの概要

UI オートメーション要素からのプロパティの取得