Compartilhar via


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

Recupera uma 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

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

Uma lista de intervalos de caracteres compatíveis com a fonte é útil para cenários como seleção de caracteres, exibição de glifo e pesquisa de seleção de fonte eficiente. Isso é semelhante ao 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

IDWriteFontFace1