IUIAutomationElement::GetCurrentPattern メソッド (uiautomationclient.h)

この UI オートメーション要素の指定したコントロールパターンの IUnknown インターフェイスを取得します。

構文

HRESULT GetCurrentPattern(
  [in]          PATTERNID patternId,
  [out, retval] IUnknown  **patternObject
);

[in] patternId

型: PATTERNID

コントロールパターンの識別子。コントロールパターン ID の一覧については、「コントロールパターン識別子」を参照してください。

[out, retval] patternObject

種類: IUnknown**

IUnknown インターフェイスへのポインターを受け取ります。

種類: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

このメソッドは、呼び出し時の可用性に基づいて、指定された制御パターンを取得します。

一部の形式の UI では、このメソッドではプロセス間のパフォーマンスオーバーヘッドが発生します。アプリケーションでは、コントロールパターンをキャッシュし、 IUIAutomationElement::GetCachedPattern を使用してそれらを取得することで、オーバーヘッドを削減できます。


サポートされている最小のクライアント	Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム、SP3 を使用した Windows XP、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 を含む)