IUIAutomation インターフェイス (uiautomationclient.h)
Microsoft UI オートメーション クライアント アプリケーションがUI オートメーション要素を検出、アクセス、フィルター処理できるようにするメソッドを公開します。 UI オートメーションは、IUIAutomation インターフェイスによって表されるオブジェクトとして、UI オートメーションのすべての要素を公開します。 このインターフェイスのメンバーは、特定の要素に固有ではありません。
継承
IUIAutomation インターフェイスは、IUnknown インターフェイスから継承されます。 IUIAutomation には、次の種類のメンバーもあります。
メソッド
IUIAutomation インターフェイスには、これらのメソッドがあります。
| IUIAutomation::AddAutomationEventHandler Microsoft UI オートメーション イベントを処理するメソッドを登録します。メモ イベント ハンドラーを実装する前に、「スレッドの問題について」で説明されているスレッドの問題について理解しておく必要があります。 |
| IUIAutomation::AddFocusChangedEventHandler フォーカスが変更されたイベントを処理するメソッドを登録します。メモ イベント ハンドラーを実装する前に、「スレッドの問題について」で説明されているスレッドの問題について理解しておく必要があります。 |
| IUIAutomation::AddPropertyChangedEventHandler プロパティ変更イベントの および 配列を処理するメソッドを登録します。 |
| IUIAutomation::AddPropertyChangedEventHandlerNativeArray プロパティ変更イベントのネイティブ配列を処理するメソッドを登録します。 |
| IUIAutomation::AddStructureChangedEventHandler 構造体変更イベントを処理するメソッドを登録します。メモ イベント ハンドラーを実装する前に、「スレッドの問題について」で説明されているスレッドの問題について理解しておく必要があります。 |
| IUIAutomation::CheckNotSupported 指定された VARIANT にサポートされていない識別子が含まれているかどうかを確認します。 |
| IUIAutomation::CompareElements 2 つのUI オートメーション要素を比較して、それらが同じ基になる UI 要素を表しているかどうかを判断します。 |
| IUIAutomation::CompareRuntimeIds 実行時識別子 (ID) を含む 2 つの整数配列を比較して、コンテンツが同じであり、同じ UI 要素に属しているかどうかを判断します。 |
| IUIAutomation::CreateAndCondition 2 つの条件の両方に一致する要素を選択する条件を作成します。 |
| IUIAutomation::CreateAndConditionFromArray 複数の条件に基づいて要素を選択する条件を作成します。そのすべてが true である必要があります。 |
| IUIAutomation::CreateAndConditionFromNativeArray すべて true である必要がある複数の条件に基づいて、ネイティブ配列から要素を選択する条件を作成します。 |
| IUIAutomation::CreateCacheRequest キャッシュ要求を作成します。 |
| IUIAutomation::CreateFalseCondition 常に false である条件を作成します。 |
| IUIAutomation::CreateNotCondition 指定した条件の負の条件を作成します。 |
| IUIAutomation::CreateOrCondition いずれかの条件が true の場合に一致が存在する 2 つの条件の組み合わせを作成します。 |
| IUIAutomation::CreateOrConditionFromArray いずれかの条件が true の場合に一致が存在する 2 つ以上の条件の組み合わせを作成します。 |
| IUIAutomation::CreateOrConditionFromNativeArray いずれかの条件が true の場合に一致が存在する 2 つ以上の条件の組み合わせを作成します。 |
| IUIAutomation::CreatePropertyCondition 指定した値を持つプロパティを持つ要素を選択する条件を作成します。 |
| IUIAutomation::CreatePropertyConditionEx 省略可能なフラグを使用して、指定した値を持つプロパティを持つ要素を選択する条件を作成します。 |
| IUIAutomation::CreateProxyFactoryEntry プロキシ ファクトリ オブジェクトの新しいインスタンスを作成します。 |
| IUIAutomation::CreateTreeWalker Microsoft UI オートメーション ツリーを走査するために使用できるツリー ウォーカー オブジェクトを取得します。 |
| IUIAutomation::CreateTrueCondition すべての要素を選択する定義済みの条件を取得します。 |
| IUIAutomation::ElementFromHandle 指定したウィンドウのUI オートメーション要素を取得します。 |
| IUIAutomation::ElementFromHandleBuildCache 指定したウィンドウのUI オートメーション要素を取得し、要求されたプロパティとコントロール パターンをプリフェッチし、プリフェッチされた項目をキャッシュに格納します。 |
| IUIAutomation::ElementFromIAccessible Microsoft Active Accessibility サーバーから、指定したアクセシビリティ対応オブジェクトのUI オートメーション要素を取得します。 |
| IUIAutomation::ElementFromIAccessibleBuildCache 指定したアクセシビリティ対応オブジェクトのUI オートメーション要素を Microsoft Active Accessibility サーバーから取得し、要求されたプロパティとコントロール パターンをプリフェッチし、プリフェッチされた項目をキャッシュに格納します。 |
| IUIAutomation::ElementFromPoint デスクトップ上の指定したポイントにあるUI オートメーション要素を取得します。 |
| IUIAutomation::ElementFromPointBuildCache デスクトップ上の指定したポイントにあるUI オートメーション要素を取得し、要求されたプロパティとコントロール パターンをプリフェッチし、プリフェッチされた項目をキャッシュに格納します。 |
| IUIAutomation::get_ContentViewCondition コンテンツ要素を選択する定義済みの IUIAutomationCondition インターフェイスを取得します。 |
| IUIAutomation::get_ContentViewWalker コンテンツ要素の検出に使用される IUIAutomationTreeWalker インターフェイスを取得します。 |
| IUIAutomation::get_ControlViewCondition コントロール要素を選択する定義済みの IUIAutomationCondition インターフェイスを取得します。 |
| IUIAutomation::get_ControlViewWalker コントロール要素の検出に使用される IUIAutomationTreeWalker インターフェイスを取得します。 |
| IUIAutomation::get_ProxyFactoryMapping Window クラス名と関連付けられたデータを個々のプロキシ ファクトリにマッピングするオブジェクトを取得します。 |
| IUIAutomation::get_RawViewCondition フィルター処理されていないビュー内のすべての UI 要素を選択する定義済みの IUIAutomationCondition インターフェイスを取得します。 |
| IUIAutomation::get_RawViewWalker Microsoft UI オートメーション ツリーのフィルター処理されていないビューを走査するために使用されるツリー ウォーカー オブジェクトを取得します。 |
| IUIAutomation::get_ReservedMixedAttributeValue 混合属性であるテキスト属性を表す静的トークン オブジェクトを取得します。 |
| IUIAutomation::get_ReservedNotSupportedValue サポートされていないプロパティまたはテキスト属性を表す静的トークン オブジェクトを取得します。 |
| IUIAutomation::GetFocusedElement 入力フォーカスを持つUI オートメーション要素を取得します。 |
| IUIAutomation::GetFocusedElementBuildCache 入力フォーカスを持つUI オートメーション要素を取得し、要求されたプロパティとコントロール パターンをプリフェッチし、プリフェッチされた項目をキャッシュに格納します。 |
| IUIAutomation::GetPatternProgrammaticName コントロール パターンの登録済みのプログラム名を取得します。 |
| IUIAutomation::GetPropertyProgrammaticName プロパティの登録済みのプログラム名を取得します。 |
| IUIAutomation::GetRootElement デスクトップを表すUI オートメーション要素を取得します。 |
| IUIAutomation::GetRootElementBuildCache デスクトップを表すUI オートメーション要素を取得し、要求されたプロパティとコントロール パターンをプリフェッチし、プリフェッチされた項目をキャッシュに格納します。 |
| IUIAutomation::IntNativeArrayToSafeArray 整数の配列を SAFEARRAY に変換します。 |
| IUIAutomation::IntSafeArrayToNativeArray 整数の SAFEARRAY を配列に変換します。 |
| IUIAutomation::P ollForPotentialSupportedPatterns UI オートメーション要素でサポートされる可能性があるコントロール パターンを取得します。 |
| IUIAutomation::P ollForPotentialSupportedProperties UI オートメーション要素でサポートされる可能性があるプロパティを取得します。 |
| IUIAutomation::RectToVariant 四角形の座標を含む VARIANT を作成します。 |
| IUIAutomation::RemoveAllEventHandlers 登録されているすべての Microsoft UI オートメーション イベント ハンドラーを削除します。 |
| IUIAutomation::RemoveAutomationEventHandler 指定したUI オートメーションイベント ハンドラーを削除します。 |
| IUIAutomation::RemoveFocusChangedEventHandler フォーカスが変更されたイベント ハンドラーを削除します。 |
| IUIAutomation::RemovePropertyChangedEventHandler プロパティ変更イベント ハンドラーを削除します。 |
| IUIAutomation::RemoveStructureChangedEventHandler 構造体変更イベント ハンドラーを削除します。 |
| IUIAutomation::SafeArrayToRectNativeArray 四角形の座標を含む SAFEARRAY を RECT 型の配列に変換します。 |
| IUIAutomation::VariantToRect 四角形の座標を含む VARIANT を RECT に変換します。 |
注釈
すべてのUI オートメーションクライアント アプリケーションは、UI オートメーションの機能にアクセスするために、このインターフェイスを CUIAutomation オブジェクトに取得する必要があります。
次の関数例では、 CUIAutomation オブジェクトを作成し、 IUIAutomation インターフェイスを取得します。
IUIAutomation *g_pAutomation;
BOOL InitializeUIAutomation()
{
CoInitialize(NULL);
HRESULT hr = CoCreateInstance(__uuidof(CUIAutomation), NULL, CLSCTX_INPROC_SERVER,
__uuidof(IUIAutomation), (void**)&g_pAutomation);
return (SUCCEEDED(hr));
}
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム、WINDOWS XP SP3 と Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム、WINDOWS Server 2003 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | uiautomationclient.h (UIAutomation.h を含む) |