COleControl::OnQueryHitRect

[アーティクル]
02/21/2013

コンテナーの IViewObjectEx::QueryHitRect の要求に対する応答として、フレームワークによって呼び出されます。

virtual BOOL OnQueryHitRect(
   DWORD dwAspect,
   LPCRECT pRectBounds,
   LPCRECT prcLoc,
   LONG lCloseHint,
   DWORD* pHitResult 
);

パラメーター

dwAspect
オブジェクトがどのように表示されるかを指定します。有効値は、列挙型 DVASPECT か DVASPECT2から取得されます。
pRectBounds
OLE コントロールのクライアント領域に外接する四角形を指定する RECT の構造体へのポインター。
prcLoc
オブジェクトの左上隅に対するヒット (オブジェクトの四角形との重複) がの場合は、チェックする四角形を指定する RECT の構造体へのポインター。
lCloseHint
使用しません。
pHitResult
ヒットのクエリの結果へのポインター。次のいずれかの値が返されます。
- HITRESULT_OUTSIDE は、OLE オブジェクトによって四角形のポインターヒットしません。
- HITRESULT_HIT は四角形の少なくとも 1 ポイントオブジェクトのヒットです。

戻り値

ヒットの結果が正常に戻った場合、; それ以外の場合は 0。

解説

オブジェクトを表示する四角形が指定された四角形 (ヒット四角形) のポイントに重複するかどうかをクエリ。QueryHitRect は、四角形以外のオブジェクトに対してヒットをテストするためにオーバーライドできます。

必要条件

ヘッダー : afxctl.h

参照

関連項目

COleControl クラス

COleControl::OnQueryHitPoint