IAccessible::accHitTest メソッド (oleacc.h)

IAccessible::accHitTest メソッドは、画面上の特定のポイントに表示される子要素または子オブジェクトを取得します。 すべてのビジュアル オブジェクトでこのメソッドがサポートされていますが、サウンド オブジェクトではサポートされていません。 クライアント アプリケーションでこのメソッドが直接呼び出されることはほとんどありません。ある時点で表示されるアクセス可能なオブジェクトを取得するには、このメソッドを内部的に呼び出す AccessibleObjectFromPoint 関数を使用します。

構文

HRESULT accHitTest(
  [in]          long    xLeft,
  [in]          long    yTop,
  [out, retval] VARIANT *pvarChild
);

パラメーター

[in] xLeft

型: long

ヒット テストされるポイントの画面座標を指定します。 x 座標は左から右に増加します。 画面座標を使用する場合、原点は画面の左上隅であることに注意してください。

[in] yTop

型: long

ヒット テストされるポイントの画面座標を指定します。 y 座標は上から下に増加します。 画面座標を使用する場合、原点は画面の左上隅であることに注意してください。

[out, retval] pvarChild

型: VARIANT*

[out, retval]xLeft および yTop で指定されたポイントに表示されるオブジェクトを識別する VARIANT のアドレス。 pvarID で返される情報は、accHitTest メソッドが呼び出されているオブジェクトに対する指定されたポイントの位置によって異なります。

戻り値

型: HRESULT

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

成功しなかった場合は、次のテーブルの値の 1 つ、または別の標準 COM エラー コードを返します。 サーバーはこれらの値を返しますが、クライアントは常に出力パラメーターをチェックして、有効な値が含まれていることを確認する必要があります。 詳細については、「 IAccessible 戻り値の確認」を参照してください。

クライアント開発者への注意: pvarID の vt メンバーがVT_EMPTY場合、サーバーはS_FALSEを返しますが、pvarID-vt> がVT_EMPTYで戻り値がS_OK場合もクライアントが処理する必要があります。

注釈

テスト対象のポイントがオブジェクトの子の 1 つにあり、この子が IAccessible インターフェイス自体をサポートしている場合、このメソッドは IAccessible インターフェイス ポインターを返す必要があります。 ただし、 IAccessible インターフェイス ポインターまたは子 ID を処理するには、クライアントを準備する必要があります。 詳細については、「 パラメーターでの子 ID の使用方法」を参照してください。

accLocation は外接する四角形を返すので、その四角形内のすべてのポイントがオブジェクトの実際の境界内にあるわけではありません。 外接する四角形内の一部のポイントが オブジェクト上にない場合があります。 1 つの項目にアイコンの四角形とアイコンのテキスト用の別の四角形がある大きなアイコン モードのリスト ビュー項目など、四角形以外のオブジェクトの場合、accHitTest でテストすると、IAccessible::accLocation によって取得されたオブジェクトの外接する四角形の座標が失敗する可能性があります。

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

特定の状況でこの方法を使用する場合は、追加の使用メモが適用されます。 詳細については、「 ヒット テストのナビゲーション」と「画面の場所」を参照してください。

サーバーの例

// m_pControl is the control that returns this accessible object. 
// m_hwnd is the HWND of the control window. 
//  
HRESULT STDMETHODCALLTYPE AccServer::accHitTest( 
    long xLeft,
    long yTop,
    VARIANT *pvarChild) 

{
    POINT pt;
    pt.x = xLeft;
    pt.y = yTop;

    // Not in our window. 
    if (WindowFromPoint(pt) != m_hwnd)
    {
        pvarChild->vt = VT_EMPTY;
        return S_FALSE;
    }

    else  // In our window; return list item, or self if in blank space. 
    {
        pvarChild->vt = VT_I4;
        ScreenToClient(m_hwnd, &pt);
        // IndexFromY returns the 0-based index of the item at that point, 
        // or -1 if the point is not on any item.
        int index = m_pControl->IndexFromY(pt.y);
        if (index >= 0)
        {
            // Increment, because the child array is 1-based. 
            pvarChild->lVal = index + 1;
        }
        else
        {
            pvarChild->lVal = CHILDID_SELF;

        }
        return S_OK;
    }
};

クライアントの例

HRESULT SelectItemAtPoint(IAccessible* pAcc, POINT point)
{
    if (pAcc == NULL)
    {
        return E_INVALIDARG;
    }
    VARIANT varChild;

    HRESULT hr = pAcc->accHitTest(point.x, point.y, &varChild);        
    if ((hr == S_OK) && (varChild.lVal != CHILDID_SELF))
    {
        return pAcc->accSelect((SELFLAG_TAKEFOCUS | SELFLAG_TAKESELECTION), varChild);
    }
    return S_FALSE;
}

要件

こちらもご覧ください

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

Iaccessible

IAccessible::accLocation

IDispatch

ヒット テストと画面の場所のナビゲーション

バリアント