Método IDWriteTextLayout::HitTestPoint (dwrite.h)
La aplicación llama a esta función pasando una ubicación de píxel específica en relación con la ubicación superior izquierda del cuadro de diseño y obtiene la información sobre las métricas de prueba de posicionamiento correspondientes de la cadena de texto donde se ha producido la prueba de posicionamiento. Cuando la ubicación de píxel especificada está fuera de la cadena de texto, la función establece el valor de salida *isInside en FALSE.
Sintaxis
HRESULT HitTestPoint(
FLOAT pointX,
FLOAT pointY,
[out] BOOL *isTrailingHit,
[out] BOOL *isInside,
[out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);
Parámetros
pointX
Tipo: FLOAT
La ubicación de píxeles X a la prueba de posicionamiento, en relación con la ubicación superior izquierda del cuadro de diseño.
pointY
Tipo: FLOAT
La ubicación de píxeles Y a la prueba de posicionamiento, en relación con la ubicación superior izquierda del cuadro de diseño.
[out] isTrailingHit
Tipo: BOOL*
Marca de salida que indica si la ubicación de la prueba de posicionamiento está en el lado inicial o final del carácter. Cuando el valor *isInside de salida se establece en FALSE, este valor se establece según el valor hitTestMetrics-textPosition> de salida para representar el borde más cercano a la ubicación de la prueba de posicionamiento.
[out] isInside
Tipo: BOOL*
Marca de salida que indica si la ubicación de la prueba de posicionamiento está dentro de la cadena de texto. Cuando es FALSE, se devuelve la posición más cercana al borde del texto.
[out] hitTestMetrics
Tipo: DWRITE_HIT_TEST_METRICS*
Geometría de salida totalmente envolvente de la ubicación de prueba de posicionamiento. Cuando el valor *isInside de salida se establece en FALSE, esta estructura representa la geometría que incluye el borde más cercano a la ubicación de la prueba de posicionamiento.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | dwrite.h |
| Library | Dwrite.lib |
| Archivo DLL | Dwrite.dll |