IUIAutomation インターフェイス (uiautomationclient.h)

[アーティクル]
08/26/2023

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 を含む)

こちらもご覧ください

クライアントのUI オートメーション要素インターフェイス

次の方法で共有

IUIAutomation インターフェイス (uiautomationclient.h)

継承

メソッド

注釈

要件

こちらもご覧ください

フィードバック

その他のリソース