IUIAutomation::ElementFromPoint メソッド (uiautomationclient.h)

  • [アーティクル]

デスクトップ上の指定したポイントにある UI オートメーション要素を取得します。

構文

HRESULT ElementFromPoint(
  [in]          POINT                pt,
  [out, retval] IUIAutomationElement **element
);

パラメーター

[in] pt

種類: POINT

UI オートメーション要素のデスクトップ座標。

[out, retval] element

種類: IUIAutomationElement**

UI オートメーション要素へのポインターを受け取ります。

戻り値

型: HRESULT

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

解説

IUIAutomation::ElementFromPoint メソッドは、ポイントの下の要素がメソッドが返すまでに既に削除されている場合、UIA_E_ELEMENTNOTAVAILABLEエラー コードを返します。 クライアントは、このメソッドのエラーを適切に処理する必要があります。たとえば、呼び出しをもう一度試してみます。

要件

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

関連項目

IUIAutomation

IUIAutomation::ElementFromPointBuildCache