Método IDWriteTextLayout::HitTestPoint (dwrite.h)

  • Artículo

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

Consulte también

IDWriteTextLayout