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 contiene più coppie di crenatura nNumPairs , 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.

Commenti

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll

Vedi anche

Funzioni per tipi di carattere e testo

Cenni preliminari su tipi di carattere e testo

CRENINGPAIR