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

Recupera la lista de intervalos de caracteres admitidos por una fuente.

Sintaxis

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 pasados desde el cliente.

[out, optional] unicodeRanges

Tipo: DWRITE_UNICODE_RANGE*

Matriz de estructuras de DWRITE_UNICODE_RANGE que se rellenan con los intervalos de caracteres.

[out] actualRangeCount

Tipo: UINT32*

Puntero al número real de intervalos de caracteres, independientemente del recuento máximo.

Valor devuelto

Tipo: HRESULT

Este método puede devolver uno de estos valores.

Comentarios

La lista de intervalos de caracteres compatibles con una fuente es útil para escenarios como la selección de caracteres, la visualización del glifo y la búsqueda de selección de fuentes eficaz. GetUnicodeRanges es similar a GetFontUnicodeRanges de GDI, salvo que devuelve el intervalo Unicode completo, no solo UCS-2 de 16 bits.

Estos intervalos proceden del mapa c, no del sistema operativo o 2::ulCodePageRange1.

Si este método no está disponible, puede usar el método IDWriteFontFace::GetGlyphIndices para comprobar si faltan glifos. El método devuelve el índice 0 para glifos que no están presentes en la fuente.

El método IDWriteFont::HasCharacter suele ser más sencillo en los casos en los que es necesario comprobar un solo carácter o una serie de caracteres individuales en sucesión, como en la reserva de fuentes.

Requisitos

Consulte también

IDWriteFont1