Funzione GetCharWidthA (wingdi.h)

Articolo
03/04/2024

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

Nota Questa funzione viene fornita solo per la 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 nel 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.

Commenti

Non è possibile usare GetCharWidth nei tipi di carattere TrueType. Per recuperare le larghezze dei caratteri 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

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