Funzione GetCharWidth32A (wingdi.h)

Articolo
08/27/2023

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

Sintassi

BOOL GetCharWidth32A(
  [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 GetCharWidth32 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.

Esempio

Per un esempio, vedere "Visualizzazione dell'input della tastiera" in Uso dell'input da tastiera.

Nota

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


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