IUIAutomationTextRange3::GetChildrenBuildCache メソッド (uiautomationclient.h)

  • [アーティクル]

1 回のクロスプロセス呼び出しで、テキスト範囲内の要素の子と指定されたプロパティとパターンを返します。 これは GetChildren を呼び出すことと同じですが、標準のビルド キャッシュ パターンが追加されます。

構文

HRESULT GetChildrenBuildCache(
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElementArray **children
);

パラメーター

[in] cacheRequest

キャッシュするプロパティとコントロール パターンを指定する IUIAutomationCacheRequest 。

[out, retval] children

指定された cacheRequest の条件を満たすテキスト範囲の子、および各子のプロパティまたはパターンを返します。

戻り値

成功 した場合はS_OK を返し、それ以外の場合は HRESULT エラー コードを返します。

注釈

GetChildren の設計に従います。

  • テキスト範囲と重なっているが、完全に囲まれていない子も含まれます。
  • 子が存在しない場合は、空のコレクションが返されます。
正常に呼び出された結果、UI オートメーションクライアントは、cacheRequest で提供される IUIAutomationElement の "Cached" API (IUIAutomationElement::GetCachedPropertyValue など) を呼び出すことができるようになります。

要件

要件 値
サポートされている最小のクライアント Windows 10バージョン 1703 [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー uiautomationclient.h (UIAutomation.h を含む)

こちらもご覧ください

IUIAutomationTextRange3

テキスト コンテンツのUI オートメーションサポート