Funzione GetGlyphIndicesA (wingdi.h)

Articolo
11/20/2024

La funzione GetGlyphIndices converte una stringa in una matrice di indici glifi. La funzione può essere utilizzata per determinare se un glifo esiste in un tipo di carattere.

Sintassi

DWORD GetGlyphIndicesA(
  [in]  HDC    hdc,
  [in]  LPCSTR lpstr,
  [in]  int    c,
  [out] LPWORD pgi,
  [in]  DWORD  fl
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] lpstr

Puntatore alla stringa da convertire.

[in] c

Lunghezza sia della lunghezza della stringa puntata da lpstr che della dimensione (in WORD) del buffer a cui punta pgi.

[out] pgi

Questo buffer deve essere della dimensione c. In caso di esito positivo, contiene una matrice di indici glifi corrispondenti ai caratteri nella stringa.

[in] fl

Specifica la modalità di gestione dei glifi se non sono supportati. Questo parametro può essere il valore seguente.

Valore	Significato
GGI_MARK_NONEXISTING_GLYPHS	Contrassegna glifi non supportati con il valore esadecimale 0xffff.

Valore restituito

Se la funzione ha esito positivo, restituisce il numero di byte (per la funzione ANSI) o word (per la funzione Unicode) convertiti.

Se la funzione ha esito negativo, il valore restituito è GDI_ERROR.

Osservazioni

Questa funzione tenta di identificare una rappresentazione a glifo singolo per ogni carattere nella stringa a cui punta lpstr. Anche se questo è utile per determinati scopi di basso livello (ad esempio la modifica dei file di carattere), le applicazioni di livello superiore che desiderano eseguire il mapping di una stringa ai glifi in genere desiderano usare le funzioni Uniscribe.

Nota

L'intestazione wingdi.h definisce GetGlyphIndices come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wingdi.h (include Windows.h)
libreria	Gdi32.lib
dll	Gdi32.dll

Vedere anche

funzioni di tipo carattere e testo

panoramica tipi di carattere e testo

GetFontUnicodeRanges

Condividi tramite