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

Retorna o mapeamento nominal de pontos de código Unicode UCS4 para índices de glifo, conforme definido pela tabela de fonte 'CMAP'.

Sintaxe

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

Parâmetros

[in] codePoints

Tipo: const UINT32*

Uma matriz de pontos de código USC4 dos quais obter índices de glifo nominal. A matriz deve ser alocada e ser capaz de conter o número de elementos especificados por codePointCount.

codePointCount

Tipo: UINT32

O número de elementos na matriz codePoints .

[out] glyphIndices

Tipo: UINT16*

Quando este método retorna, contém um ponteiro para uma matriz de índices de glifo nominal preenchidos por essa função.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Observe que esse mapeamento é fornecido principalmente para mecanismos de layout de linha criados sobre a API de fonte física. Devido à substituição de glifo OpenType e à substituição de caracteres de layout de linha, a conversão nominal nem sempre corresponde a como uma cadeia de caracteres Unicode será mapeada para índices de glifo ao renderizar usando uma face de fonte específica. Além disso, observe que os seletores de variante Unicode fornecem mapeamentos alternativos para caractere a glifo. Essa chamada sempre retornará a variante padrão.

Quando os caracteres não estão presentes na fonte, esse método retorna o índice 0, que é o glifo indefinido ou o glifo ".notdef". Se um caractere não estiver em uma fonte, IDWriteFont::HasCharacter retornará false e GetUnicodeRanges não o retornará no intervalo.

Requisitos

Confira também

IDWriteFontFace