AccessibleObjectFromPoint 関数 (oleacc.h)

[アーティクル]
02/29/2024

画面上の指定したポイントに表示されるオブジェクトの IAccessible インターフェイスポインターのアドレスを取得します。

構文

HRESULT AccessibleObjectFromPoint(
  [in]  POINT       ptScreen,
  [out] IAccessible **ppacc,
  [out] VARIANT     *pvarChild
);

パラメーター

[in] ptScreen

物理画面座標で、検査されるポイントを指定します。

[out] ppacc

オブジェクトの IAccessible インターフェイスのアドレスを受け取るポインター変数のアドレス。

[out] pvarChild

ppacc で返される IAccessible インターフェイスポインターが、指定したポイントに表示されるオブジェクトに属するか、指定したポイントの要素の親に属するかを指定する VARIANT 構造体のアドレス。 VARIANT の vt メンバーは常にVT_I4。 lVal メンバーがCHILDID_SELF場合、ppacc の IAccessible インターフェイスポインターは、その時点のオブジェクトに属します。 lVal メンバーがCHILDID_SELFされていない場合、ppacc は子要素の親オブジェクトの IAccessible インターフェイスのアドレスです。クライアントは、使用が完了したら、取得した VARIANT パラメーターに対して VariantClear を呼び出す必要があります。

戻り値

成功した場合は、S_OK を返します。

成功しなかった場合は、次のいずれかの標準 COM エラーコードを返します。

リターンコード	説明
E_INVALIDARG	引数が有効ではありません。

注釈

この関数は、特定のポイントにあるオブジェクト階層内の最下位レベルのアクセス可能なオブジェクトを取得します。ポイントの要素がアクセス可能なオブジェクトでない場合 (つまり、 IAccessible をサポートしていません)、関数は親オブジェクトの IAccessible インターフェイスを取得します。親オブジェクトは 、IAccessible インターフェイスを介して子要素に関する情報を提供する必要があります。指定した画面座標で子要素を識別するには、 IAccessible::accHitTest を呼び出します。

他の IAccessible メソッドや関数と同様に、クライアントはユーザーアクションのために IAccessible インターフェイスポインターのエラーを受け取る可能性があります。詳細については、「 IAccessible インターフェイスポインターのエラーの受信」を参照してください。

クライアントの例

次の関数例では、画面上の指定したポイントにある項目を選択します。 1 つの選択が必要であると見なされます。


HRESULT SelectItemAtPoint(POINT point)
{
    VARIANT varItem;
    IAccessible* pAcc;
    HRESULT hr = AccessibleObjectFromPoint(point, &pAcc, &varItem);
    if ((hr == S_OK))
    {
        hr = pAcc->accSelect((SELFLAG_TAKEFOCUS | SELFLAG_TAKESELECTION), varItem);
        VariantClear(&varItem);
        pAcc->Release();
    }
    return hr;
}

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	oleacc.h
Library	Oleacc.lib
[DLL]	Oleacc.dll
再頒布可能パッケージ	SP6 以降および Windows 95 を使用した Windows NT 4.0 のアクティブなアクセシビリティ 1.3 RDK