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

La aplicación llama a esta función para obtener la ubicación de píxeles en relación con la parte superior izquierda del cuadro de diseño según la posición de texto y el lado lógico de la posición. Esta función se usa normalmente como parte del posicionamiento de intercalación del texto donde el símbolo de intercalación se dibuja en la ubicación correspondiente a la posición de edición de texto actual. También se puede usar como una manera de obtener mediante programación la geometría de una posición de texto determinada en la automatización de la interfaz de usuario.

Sintaxis

HRESULT HitTestTextPosition(
        UINT32                  textPosition,
        BOOL                    isTrailingHit,
  [out] FLOAT                   *pointX,
  [out] FLOAT                   *pointY,
  [out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);

Parámetros

textPosition

Tipo: UINT32

Posición de texto utilizada para obtener la ubicación del píxel.

isTrailingHit

Tipo: BOOL

Marca booleana que indica si la ubicación del píxel es del lado inicial o final de la posición de texto especificada.

[out] pointX

Tipo: FLOAT*

Cuando este método vuelve, contiene la ubicación de píxel de salida X, relativa a la ubicación superior izquierda del cuadro de diseño.

[out] pointY

Tipo: FLOAT*

Cuando este método vuelve, contiene la ubicación de píxel de salida Y, en relación con la ubicación superior izquierda del cuadro de diseño.

[out] hitTestMetrics

Tipo: DWRITE_HIT_TEST_METRICS*

Cuando este método vuelve, contiene la geometría de salida que incluye completamente la posición de texto especificada.

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