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

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

構文

HRESULT GetCurrentPatternAs(
  [in]  PATTERNID patternId,
  [in]  REFIID    riid,
  [out] void      **patternObject
);

パラメーター

[in] patternId

型: PATTERNID

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

[in] riid

型: REFIID

ppv を介して取得するインターフェイスの IID への参照。

[out] patternObject

型: void**

riid で要求されたインターフェイス ポインターを受信します。

戻り値

型: HRESULT

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

注釈

riid パラメーターと ppv パラメーターをパッケージ化するには、Objbase.h で定義されているIID_PPV_ARGS マクロを使用することをお勧めします。 このマクロは 、ppv の値によって指されるインターフェイスに基づいて正しい IID を提供するため、コーディング エラーが発生する可能性がなくなります。

要件

要件	値
サポートされている最小のクライアント	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 を含む)

関連項目

概念

GetCachedPatternAs

GetCurrentPattern

IUIAutomationElement

リファレンス

UI オートメーション コントロール パターンの概要