Condividi tramite


Funzione GetKerningPairsA (wingdi.h)

La funzione GetKerningPairs recupera le coppie di crenatura dei caratteri per il tipo di carattere attualmente selezionato per il contesto di dispositivo specificato.

Sintassi

DWORD GetKerningPairsA(
  [in]  HDC           hdc,
  [in]  DWORD         nPairs,
  [out] LPKERNINGPAIR lpKernPair
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] nPairs

Numero di coppie nella matrice lpkrnpair. Se il tipo di carattere ha più di nNumPairs coppie di crenatura, la funzione restituisce un errore.

[out] lpKernPair

Puntatore a una matrice di strutture KERNINGPAIR che riceve le coppie di crenatura. La matrice deve contenere almeno il numero di strutture specificato dal parametro nNumPairs. Se questo parametro è NULL, la funzione restituisce il numero totale di coppie di crenatura per il tipo di carattere.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è il numero di coppie di crenatura restituite.

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

Osservazioni

Nota

L'intestazione wingdi.h definisce GetKerningPairs 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

KERNINGPAIR