Condividi tramite


Funzione GetCharWidthA (wingdi.h)

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

Vedi anche

Funzioni carattere e testo

Panoramica dei tipi di carattere e del testo

GetCharABCWidths

GetCharABCWidthsFloat

GetCharWidth32

GetCharWidthFloat