UiaFind 関数 (uiautomationcoreapi.h)
構文
HRESULT UiaFind(
[in] HUIANODE hnode,
[in] UiaFindParams *pParams,
[in] UiaCacheRequest *pRequest,
[out] SAFEARRAY **ppRequestedData,
[out] SAFEARRAY **ppOffsets,
[out] SAFEARRAY **ppTreeStructures
);
パラメーター
[in] hnode
種類: HUIANODE
検索の開始点として使用するノード。
[in] pParams
種類: UiaFindParams*
検索パラメーターを含む UiaFindParams 構造体のアドレス。
[in] pRequest
型: UiaCacheRequest*
キャッシュする情報を指定する UiaCacheRequest 構造体のアドレス。
[out] ppRequestedData
種類: SAFEARRAY**
要求されたデータを含む SAFEARRAY へのポインターを受け取る変数のアドレス。 このパラメーターは初期化せずに渡されます。 「解説」を参照してください。
[out] ppOffsets
種類: SAFEARRAY**
要素サブツリーが開始する要求されたデータ配列へのインデックスを含む SAFEARRAY へのポインターを受け取る変数のアドレス。 このパラメーターは初期化せずに渡されます。
[out] ppTreeStructures
種類: SAFEARRAY**
ツリー構造の説明を含む SAFEARRAY へのポインターを受け取る変数のアドレス。 このパラメーターは初期化せずに渡されます。 「解説」を参照してください。
戻り値
種類: HRESULT
成功した場合はS_OKを返し、それ以外の場合はエラー値を返します。
注釈
ツリー構造は、すべての文字が "p" または ")" である文字列によって記述されます。 文字列の最初の文字は常にルート ノードを表します。 関数から要素が返されない場合、文字列は NULL です 。
"p" はノード (UI オートメーション要素) を表します。 1 つの "p" が別のノードに直接続くと、2 番目のノードは最初のノードの子になります。 ")" は、ツリーをバックアップするステップを表します。 たとえば、"pp)p" はノードを表し、その後に互いの兄弟である 2 つの子ノードが続きます。 "pp))p" では、最後のノードは最初のノードの兄弟です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | uiautomationcoreapi.h |
| Library | Uiautomationcore.lib |
| [DLL] | Uiautomationcore.dll |