AccessibleObjectFromPoint 関数 (oleacc.h)

画面上の指定したポイントに表示されるオブジェクトの 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 エラー コードを返します。

注釈

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

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

クライアントの例

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;
}

要件

こちらもご覧ください

AccessibleObjectFromEvent

AccessibleObjectFromWindow

アクティブなアクセシビリティと Windows Vista 画面のスケーリング

Iaccessible

VARIANT 構造体