Metodo IDWriteFontFace::GetGlyphIndices (dwrite.h)

Restituisce il mapping nominale del codice Unicode UCS4 punta agli indici glifi, come definito dalla tabella "CMAP".

Sintassi

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

Parametri

[in] codePoints

Tipo: const UINT32*

Matrice di punti di codice USC4 da cui ottenere indici di glifi nominale. La matrice deve essere allocata e può contenere il numero di elementi specificati da codePointCount.

codePointCount

Tipo: UINT32

Numero di elementi nella matrice codePoints .

[out] glyphIndices

Tipo: UINT16*

Quando questo metodo restituisce, contiene un puntatore a una matrice di indici del glifo nominale riempiti da questa funzione.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Si noti che questo mapping viene fornito principalmente per i motori di layout linea basati sull'API del tipo di carattere fisico. A causa della sostituzione del glifo OpenType e della sostituzione dei caratteri di layout della riga, la conversione nominale non corrisponde sempre alla modalità di mapping di una stringa Unicode agli indici del glifo quando si esegue il rendering usando un particolare viso di carattere. Si noti anche che i selettore varianti Unicode forniscono mapping alternativi per il carattere a glifo. Questa chiamata restituirà sempre la variante predefinita.

Quando i caratteri non sono presenti nel tipo di carattere, questo metodo restituisce l'indice 0, ovvero il glifo non definito o ".notdef". Se un carattere non è in un tipo di carattere, IDWriteFont::HasCharacter restituisce false e GetUnicodeRanges non lo restituisce nell'intervallo.

Requisiti

Vedi anche

IDWriteFontFace