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.

Valor retornado	Descrição
S_OK	O método foi executado com êxito.
E_NOT_SUFFICIENT_BUFFER	O buffer é muito pequeno. O actualRangeCount era mais do que o maxRangeCount.

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

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_1.lib
DLL	Dwrite_1.dll

Confira também

IDWriteFont1