Método ITextServices::TxQueryHitPoint (textserv.h)

Artículo
08/26/2023

Comprueba si un punto especificado está dentro del rectángulo del objeto de servicios de texto.

Sintaxis

HRESULT TxQueryHitPoint(
  [in]  DWORD          dwDrawAspect,
        LONG           lindex,
  [in]  void           *pvAspect,
  [in]  DVTARGETDEVICE *ptd,
  [in]  HDC            hdcDraw,
  [in]  HDC            hicTargetDev,
  [in]  LPCRECT        lprcClient,
  [in]  INT            x,
  [in]  INT            y,
  [out] DWORD          *pHitResult
);

Parámetros

[in] dwDrawAspect

Tipo: DWORD

El aspecto de dibujo puede ser uno de los siguientes valores.

Valor	Significado
DVASPECT_CONTENT	Representa una imagen de pantalla del contenido de texto en el contexto del dispositivo hdcDraw . Los parámetros hicTargetDev y ptd proporcionan información sobre el contexto del dispositivo de destino si existe (normalmente una impresora).
DVASPECT_DOCPRINT	Representa el objeto en el contexto del dispositivo hdcDraw como si se imprimiese en una impresora. Por lo tanto, el objeto de servicios de texto puede optimizar para la impresora (por ejemplo, no pintar el color de fondo, si es blanco). Además, ciertos elementos específicos de la pantalla (como la selección) no deben representarse. ITextServices::TxGetNaturalSize debe representar el rectángulo lprcClient , comenzando en la posición de desplazamiento actual.

Valor

Significado

DVASPECT_CONTENT

Representa una imagen de pantalla del contenido de texto en el contexto del dispositivo hdcDraw .

Los parámetros hicTargetDev y ptd proporcionan información sobre el contexto del dispositivo de destino si existe (normalmente una impresora).

DVASPECT_DOCPRINT

Representa el objeto en el contexto del dispositivo hdcDraw como si se imprimiese en una impresora. Por lo tanto, el objeto de servicios de texto puede optimizar para la impresora (por ejemplo, no pintar el color de fondo, si es blanco). Además, ciertos elementos específicos de la pantalla (como la selección) no deben representarse.

ITextServices::TxGetNaturalSize debe representar el rectángulo lprcClient , comenzando en la posición de desplazamiento actual.

lindex

Tipo: LONG

No compatible.

[in] pvAspect

Tipo: void*

Información sobre las optimizaciones de dibujo.

[in] ptd

Tipo: DVTARGETDEVICE*

Información sobre el dispositivo de destino.

[in] hdcDraw

Tipo: HDC

Representación del contexto del dispositivo.

[in] hicTargetDev

Tipo: HDC

Contexto de información de destino.

[in] lprcClient

Tipo: LPCRECT

Rectángulo de cliente del control, en coordenadas del cliente (dispositivo) de la vista en la que se realiza la prueba de posicionamiento.

[in] x

Tipo: INT

Coordenada x para comprobar, en coordenadas de cliente, de la vista en la que se realiza la prueba de posicionamiento.

[in] y

Tipo: INT

Coordenada y para comprobar, en coordenadas de cliente, de la vista en la que se realiza la prueba de posicionamiento.

[out] pHitResult

Tipo: DWORD*

Resultado de la prueba de posicionamiento. Puede ser cualquiera de los siguientes valores de enumeración TXTHITRESULT .

Valor	Significado
TXTHITRESULT_CLOSE	El punto está en el rectángulo del cliente y cerca de un área notransparente.
TXTHITRESULT_HIT	El punto está en el rectángulo del cliente y, sobre texto o en segundo plano, no es transparente.
TXTHITRESULT_NOHIT	El punto está fuera del rectángulo del cliente.
TXTHITRESULT_TRANSPARENT	El punto está en el rectángulo del cliente y no sobre el texto o el fondo era transparente.

Valor devuelto

Tipo: HRESULT

El valor devuelto es un código HRESULT .

Comentarios

Este método permite al host implementar pruebas de posicionamiento transparentes en texto.

Para obtener más información, vea la sección Comentarios de ITextServices::TxDraw e ITextServices::OnTxSetCursor.

Requisitos


Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	textserv.h
Archivo DLL	Msftedit.dll