Método IDWriteFontFace::GetGlyphIndices (dwrite.h)

  • Artículo

Devuelve la asignación nominal de los puntos de código Unicode UCS4 a los índices de glifo, tal y como se define en la tabla de fuente "CMAP".

Sintaxis

HRESULT GetGlyphIndices(
  [in]  UINT32 const *codePoints,
        UINT32       codePointCount,
  [out] UINT16       *glyphIndices
);

Parámetros

[in] codePoints

Tipo: const UINT32*

Matriz de puntos de código USC4 de los que se van a obtener índices nominales de glifo. La matriz debe asignarse y poder contener el número de elementos especificados por codePointCount.

codePointCount

Tipo: UINT32

Número de elementos de la matriz codePoints .

[out] glyphIndices

Tipo: UINT16*

Cuando este método devuelve, contiene un puntero a una matriz de índices de glifos nominales rellenados por esta función.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Tenga en cuenta que esta asignación se proporciona principalmente para los motores de diseño de línea basados en la API de fuente física. Debido a la sustitución de glifos OpenType y la sustitución de caracteres de diseño de línea, la conversión nominal no siempre corresponde a cómo una cadena Unicode se asignará a índices de glifos al representar mediante una cara de fuente determinada. Además, tenga en cuenta que los selectores de variantes Unicode proporcionan asignaciones alternativas para el carácter al glifo. Esta llamada siempre devolverá la variante predeterminada.

Cuando los caracteres no están presentes en la fuente, este método devuelve el índice 0, que es el glifo no definido o el glifo ".notdef". Si un carácter no está en una fuente, IDWriteFont::HasCharacter devuelve false y GetUnicodeRanges no lo devuelve en el intervalo.

Requisitos

   
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado dwrite.h
Library Dwrite.lib
Archivo DLL Dwrite.dll

Consulte también

IDWriteFontFace