Compartir a través de

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

  • Artículo

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

Una lista de intervalos de caracteres admitidos por la fuente es útil para escenarios como la selección de caracteres, la visualización del glifo y la búsqueda eficaz de la selección de fuentes. Esto 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

IDWriteFontFace1