Método IDWriteFont1::GetUnicodeRanges (dwrite_1.h)

Recupera a lista de intervalos de caracteres com suporte por uma fonte.

Sintaxe

HRESULT GetUnicodeRanges(
                  UINT32               maxRangeCount,
  [out, optional] DWRITE_UNICODE_RANGE *unicodeRanges,
  [out]           UINT32               *actualRangeCount
);

Parâmetros

maxRangeCount

Tipo: UINT32

O número máximo de intervalos de caracteres passados do cliente.

[out, optional] unicodeRanges

Tipo: DWRITE_UNICODE_RANGE*

Uma matriz de estruturas de DWRITE_UNICODE_RANGE que são preenchidas com os intervalos de caracteres.

[out] actualRangeCount

Tipo: UINT32*

Um ponteiro para o número real de intervalos de caracteres, independentemente da contagem máxima.

Retornar valor

Tipo: HRESULT

Esse método pode retornar um desses valores.

Comentários

A lista de intervalos de caracteres com suporte de uma fonte é útil para cenários como seleção de caracteres, exibição de glifo e pesquisa de seleção de fonte eficiente. GetUnicodeRanges é semelhante a GetFontUnicodeRanges da GDI, exceto que ele retorna o intervalo Unicode completo, não apenas UCS-2 de 16 bits.

Esses intervalos são do cmap, não do sistema operacional/2::ulCodePageRange1.

Se esse método não estiver disponível, você poderá usar o método IDWriteFontFace::GetGlyphIndices para marcar para glifos ausentes. O método retorna o índice 0 para glifos que não estão presentes na fonte.

O método IDWriteFont::HasCharacter geralmente é mais simples nos casos em que você precisa marcar um único caractere ou uma série de caracteres únicos em sucessão, como no fallback de fonte.

Requisitos

Confira também

IDWriteFont1