Método IDWriteTextAnalyzer1::GetTextComplexity (dwrite_1.h)
Determina la complejidad del texto y si necesita llamar a IDWriteTextAnalyzer::GetGlyphs para el modelado completo del script.
Sintaxis
HRESULT GetTextComplexity(
[in] WCHAR const *textString,
UINT32 textLength,
IDWriteFontFace *fontFace,
[out] BOOL *isTextSimple,
[out] UINT32 *textLengthRead,
[out, optional] UINT16 *glyphIndices
);
Parámetros
[in] textString
Tipo: const WCHAR*
Texto que se va a comprobar si hay complejidad. Esta cadena puede ser UTF-16, pero los caracteres adicionales se considerarán complejos.
textLength
Tipo: UINT32
Longitud del texto que se va a comprobar.
fontFace
Tipo: IDWriteFontFace*
Cara de fuente que se va a leer.
[out] isTextSimple
Tipo: BOOL*
Si es true, el texto es simple y la matriz glifoIndices ya tendrá los glifos nominales para usted. De lo contrario, debe llamar a IDWriteTextAnalyzer::GetGlyphs para dar forma correctamente a scripts complejos y características de OpenType.
[out] textLengthRead
Tipo: UINT32*
La longitud de lectura del texto se ejecuta con la misma complejidad, simple o compleja. Puede llamar de nuevo desde ese momento.
[out, optional] glyphIndices
Tipo: UINT16*
Índices de glifo opcionales para el texto. Si la función devolvió que el texto era sencillo, ya tiene los glifos que necesita. De lo contrario, los índices de glifo no son significativos y debe llamar a IDWriteTextAnalyzer::GetGlyphs para dar forma en su lugar.
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
El texto no es sencillo si los caracteres forman parte de un script que tiene requisitos de forma complejos, requieren análisis de bidi, se combinan con otros caracteres, residen en los planos complementarios o tienen glifos que participan en características estándar de OpenType. La longitud devuelta no dividirá las marcas combinadas de sus caracteres base.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 y actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | dwrite_1.h |
| Library | Dwrite.lib |
| Archivo DLL | Dwrite.dll |