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.

Valor devuelto	Descripción
S_OK	El método se ejecutó correctamente.
E_NOT_SUFFICIENT_BUFFER	El búfer es demasiado pequeño. ActualRangeCount era más que maxRangeCount.

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

Requisito	Value
Cliente mínimo compatible	Windows 8 y actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	dwrite_1.h
Library	Dwrite_1.lib
Archivo DLL	Dwrite_1.dll

Consulte también

IDWriteFont1