COleControl::OnQueryHitPoint

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

Valor devuelto

Distinto de cero si correctamente se devuelve un resultado exitoso; 0 lo contrario. Un éxito es una superposición con el área de visualización del control OLE.

Parámetros

dwAspect

Especifica cómo se representa el objeto. Los valores válidos son tomados de la enumeración DVASPECT o DVASPECT2.

pRectBounds

Puntero a una estructura RECT especificando el rectángulo de delimitación del área de cliente del control OLE.

ptlLoc

Puntero a la estructura de punto especifica el punto al comprobarse un hit. Se especifica el punto en las coordenadas del área de cliente OLE.

lCloseHint

La distancia que define "cerrar" para el punto busca un éxito.

pHitResult

Puntero al resultado de la consulta activa. Uno de los siguientes valores:

• HITRESULT_OUTSIDE ptlLoc está fuera del objeto OLE y no cerrar.
  
  
• HITRESULT_TRA&NSPARENTnbsp;ptlLoc está dentro de los límites del objeto OLE, pero no a la imagen. Por ejemplo, un punto en el centro de un círculo transparente podría ser HITRESULT_TRANSPARENT.
  
  
• HITRESULT_CLOSE ptlLoc es dentro o fuera del objeto OLE, pero suficientemente próximos para el objeto de ser considerado dentro. Objetos pequeños, delgados o detallados pueden utilizar este valor. Incluso si un punto está fuera del límite rectángulo de un objeto puede aún estar cerca (esto es necesario para golpear objetos pequeños).
  
  
• HITRESULT_HIT ptlLoc está dentro de la imagen del objeto.

Observaciones

Llamado por el marco en respuesta a la solicitud de IViewObjectEx::QueryHitPoint del contenedor. Consulta si el rectángulo de visualización de un objeto superpone el punto dado (golpea el punto). QueryHitPoint se puede reemplazar para probar éxitos para objetos no rectangulares.

Introducción a COleControl |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;COleControl::OnQueryHitRect