Método IDWriteTextAnalysisSource::GetTextAtPosition (dwrite.h)
Obtiene un bloque de texto que comienza en la posición de texto especificada.
Sintaxis
HRESULT GetTextAtPosition(
UINT32 textPosition,
[out] WCHAR const **textString,
[out] UINT32 *textLength
);
Parámetros
textPosition
Tipo: UINT32
Primera posición de la pieza que se va a obtener. Todas las posiciones están en unidades de código UTF16 , no en caracteres enteros, lo que importa cuando se usan caracteres adicionales.
[out] textString
Tipo: const WCHAR**
Cuando este método vuelve, contiene una dirección del bloque de texto como una matriz de caracteres que se va a recuperar del análisis de texto.
[out] textLength
Tipo: UINT32*
Cuando este método vuelve, contiene el número de unidades UTF16 del fragmento recuperado. La longitud devuelta no es la longitud del bloque, pero la longitud restante en el bloque, desde la posición especificada hasta su final. Por ejemplo, la consulta de una posición de 75 posiciones en un bloque de 100 posiciones devolvería 25.
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.
Comentarios
Devolver NULL indica el final del texto, que es la posición después del último carácter. Esta función se denomina iterativamente para cada bloque consecutivo, agrupando varios bloques fragmentados en el almacén de respaldo en una cadena contigua virtual.
Aunque las aplicaciones pueden implementar contenido textual disperso que solo asigna parte del almacén de respaldo, la aplicación debe asignar cualquier texto que esté en el intervalo pasado a cualquier función de análisis.
Requisitos
| 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 |