COleControl::OnQueryHitPoint

virtual BOOL OnQueryHitPoint ( DWORD dwAspect, LPCRECT pRectBounds, POINT ptlLoc, LONG lCloseHint, DWORD * pHitResult );

Valeur de retour

Différent de zéro si le résultat du succès est retourné avec succès ; sinon 0. Un succès est un chevauchement avec la zone d'affichage du contrôle OLE.

Paramètres

dwAspect

Spécifie la façon dont l'objet est représentée. Les valeurs valides sont issus de l'énumération DVASPECT ou DVASPECT2.

pRectBounds

Pointeur vers une structure RECT spécifiant le rectangle de délimitation de la zone client de contrôle OLE.

ptlLoc

Pointeur vers la structure POINT spécifie le point à vérifier pour un hit. Le point est spécifié en coordonnées de zone client OLE.

lCloseHint

La distance qui définit « proche » au point contrôlé pour un succès.

pHitResult

Pointeur vers le résultat de la requête de succès. Une des valeurs suivantes:

• HITRESULT_OUTSIDE  ;ptlLoc est à l'extérieur de l'objet OLE et ne pas fermer.
  
  
• HITRESULT_TRA&NSPARENTnbsp ;ptlLoc est dans les limites de l'objet OLE, mais pas à proximité de 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 assez près de l'objet à considérer à l'intérieur. Petites, minces ou détaillées des objets peuvent utiliser cette valeur. Même si un point est à l'extérieur de la bounding rectangle d'un objet, il peut encore être proche (cela est nécessaire pour frapper les petits objets).
  
  
• HITRESULT_HIT  ;ptlLoc est l'image de l'objet.

Remarques

Appelé par le framework en réponse à la demande de IViewObjectEx::QueryHitPoint du conteneur. Interroge si le rectangle d'affichage un objet chevauche le point donné (frappe le point). QueryHitPoint peut être substituée pour tester des hits pour des objets non rectangulaires.

COleControl aperçu |nbsp ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;COleControl::OnQueryHitRect