Funzione GetCharWidth32A (wingdi.h)

Articolo
11/20/2024

La funzione GetCharWidth32 recupera le larghezze, in 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 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

non è possibile utilizzare GetCharWidth32 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.

Esempi

Per un esempio, vedere "Visualizzazione dell'input da 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 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