次の方法で共有


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 構造体のアドレス。 VARIANTvt メンバーは常にVT_I4。 lVal メンバーがCHILDID_SELF場合、ppaccIAccessible インターフェイス ポインターは、その時点の オブジェクトに属します。 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

こちらもご覧ください

AccessibleObjectFromEvent

AccessibleObjectFromWindow

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

Iaccessible

VARIANT 構造体