Funzione GetCharWidthA (wingdi.h)

Articolo
11/20/2024

La funzione GetCharWidth recupera le larghezze, in coordinate logiche, di caratteri consecutivi in un intervallo specificato dal tipo di carattere corrente.

Nota Questa funzione viene fornita solo per compatibilità con le versioni a 16 bit di Windows. Le applicazioni devono chiamare la funzione GetCharWidth32 , che fornisce risultati più accurati.

Sintassi

BOOL GetCharWidthA(
  [in]  HDC   hdc,
  [in]  UINT  iFirst,
  [in]  UINT  iLast,
  [out] LPINT lpBuffer
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] iFirst

Primo carattere nel gruppo di caratteri consecutivi.

[in] iLast

Ultimo carattere nel gruppo di caratteri consecutivi, che non deve precedere il primo carattere specificato.

[out] lpBuffer

Puntatore a un buffer che riceve le larghezze dei caratteri, in coordinate logiche.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

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

Osservazioni

GetCharWidth non può essere usato nei tipi di carattere TrueType. Per recuperare la larghezza dei caratteri per i tipi di carattere TrueType, usare GetCharABCWidths.

L'intervallo è inclusivo; ovvero, le larghezze restituite includono le larghezze dei caratteri specificati dai parametri iFirstChar e iLastChar.

Se un carattere non esiste nel tipo di carattere corrente, viene assegnata la larghezza del carattere predefinito.

Nota

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