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 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