Método IDWriteTextAnalyzer1::GetTextComplexity (dwrite_1.h)

Determina a complexidade do texto e se você precisa chamar IDWriteTextAnalyzer::GetGlyphs para formatação completa do script.

Sintaxe

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*

O texto a ser marcar para complexidade. Essa cadeia de caracteres pode ser UTF-16, mas todos os caracteres suplementares serão considerados complexos.

textLength

Tipo: UINT32

Comprimento do texto para marcar.

fontFace

Tipo: IDWriteFontFace*

A face da fonte a ser lida.

[out] isTextSimple

Tipo: BOOL*

Se for true, o texto será simples e a matriz gliphIndices já terá os glifos nominais para você. Caso contrário, você precisará chamar IDWriteTextAnalyzer::GetGlyphs para moldar corretamente scripts complexos e recursos OpenType.

[out] textLengthRead

Tipo: UINT32*

A leitura de comprimento do texto é executada com a mesma complexidade, simples ou complexa. Você pode chamar novamente a partir desse ponto em diante.

[out, optional] glyphIndices

Tipo: UINT16*

Índices de glifo opcionais para o texto. Se a função retornou que o texto era simples, você já tem os glifos necessários. Caso contrário, os índices de glifo não são significativos e você precisa chamar IDWriteTextAnalyzer::GetGlyphs para modelagem.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O texto não será simples se os caracteres fizerem parte de um script que tenha requisitos de modelagem complexos, exigir análise bidi, combinar com outros caracteres, residir nos planos suplementares ou tiver glifos que participam dos recursos padrão do OpenType. O comprimento retornado não dividirá as marcas de combinação de seus caracteres base.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 e Atualização de Plataforma para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 e Atualização de Plataforma para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	dwrite_1.h
Biblioteca	Dwrite.lib
DLL	Dwrite.dll

Confira também

IDWriteTextAnalyzer1

IDWriteTextAnalyzer::GetGlyphs