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 |