Compartir a través de


COleControl::OnQueryHitPoint

Llamado por el marco en respuesta a la solicitud de IViewObjectEx:: QueryHitPoint de un contenedor.

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

Parámetros

  • dwAspect
    especifica cómo se representa el objeto. los valores válidos se toman de la enumeración DVASPECT o DVASPE CT2.

  • pRectBounds
    Puntero a una estructura de RECT que especifica el rectángulo delimitador del área cliente de controles activex.

  • ptlLoc
    Puntero a la estructura de puntos que especifica el punto que se buscará un acierto. El punto se especifica en coordenadas del área de cliente OLE.

  • lCloseHint
    La distancia que define “cierre” al punto comprobó para buscar un acierto.

  • pHitResult
    Puntero al resultado de la consulta de la posición. Uno de los valores siguientes:

    • HITRESULT_OUTSIDE   ptlLoc está fuera del objeto OLE y no de cierre.

    • HITRESULT_TRANSPARENT   el ptlLoc está dentro de los límites del objeto OLE, pero no de cierre a la imagen. Por ejemplo, un punto en medio de un círculo transparente podría ser HITRESULT_TRANSPARENT.

    • HITRESULT_CLOSE   ptlLoc está dentro o fuera del objeto OLE pero de cierre en lugar del objeto que se verán en. Los objetos pequeños, precisión, o detallados pueden utilizar este valor. Incluso si un punto está fuera del rectángulo delimitador de un objeto todavía puede cierre (esto es necesario para alcanzar pequeños objetos).

    • HITRESULT_HIT   ptlLoc está dentro del objeto.

Valor devuelto

Distinto de cero si el resultado de la posición se devuelve correctamente; si no 0. Un acierto es una superposición con el área de presentación del control).

Comentarios

Consultas si el rectángulo de presentación de un objeto se superpone a punto determinado (aciertos el punto). QueryHitPoint se puede invalidar para probar los aciertos de los objetos no rectangulares.

Requisitos

encabezado: afxctl.h

Vea también

Referencia

COleControl Class

Gráfico de jerarquías

COleControl::OnQueryHitRect