COleControl::OnQueryHitPoint
Appelé par l'infrastructure en réponse à la requête d' IViewObjectEx::QueryHitPoint d'un conteneur.
virtual BOOL OnQueryHitPoint(
DWORD dwAspect,
LPCRECT pRectBounds,
POINT ptlLoc,
LONG lCloseHint,
DWORD* pHitResult
);
Paramètres
dwAspect
Spécifie comment l'objet est représenté. Les valeurs valides sont prises de l'énumération DVASPECT ou DVASPECT2.pRectBounds
Pointeur vers une structure d' RECT spécifiant le rectangle englobant de la zone cliente du contrôle OLE.ptlLoc
Pointeur vers la structure de POINT spécifiant le point à contrôler une correspondance. Le point est spécifié dans OLE de coordonnées de la zone cliente.lCloseHint
La distance qui définit la « fin » au point a vérifié une correspondance.pHitResult
Pointeur vers le résultat de la requête de correspondance. Une des valeurs suivantes :HITRESULT_OUTSIDE ptlLoc est en dehors de l'objet OLE et non de la fin.
HITRESULT_TRANSPARENT le ptlLoc se trouve dans les limites de l'objet OLE, mais pas la fin à l'image. Par exemple, un point au milieu d'un cercle transparent peut être HITRESULT_TRANSPARENT.
HITRESULT_CLOSE ptlLoc est à l'intérieur ou à l'extérieur de l'objet OLE mais suffisamment de fin à l'objet à réfléchir à l'intérieur. Les petits, minces, ou détaillés objets peuvent utiliser cette valeur. Même si un point se trouve à l'extérieur de le rectangle englobant d'un objet qui peut être fin (cela est nécessaire pour atteindre de petits objets).
HITRESULT_HIT ptlLoc est dans l'image de l'objet.
Valeur de retour
Une valeur différente de zéro si le résultat d'une correspondance est correctement retourné ; sinon 0. Une correspondance est un chevauchement avec OLE zone affichage.
Notes
Demande si le rectangle de l'affichage d'un objet chevauche le point donné (correspond au point). QueryHitPoint peut être substituée pour tester des correspondances pour les objets non rectangulaires.
Configuration requise
Header: afxctl.h