Funzione GetCharWidthI (wingdi.h)

Articolo
03/08/2023

La funzione GetCharWidthI recupera le larghezze, in coordinate logiche, di indici di glifi consecutivi in un intervallo specificato dal tipo di carattere corrente.

Sintassi

BOOL GetCharWidthI(
  [in]  HDC    hdc,
  [in]  UINT   giFirst,
  [in]  UINT   cgi,
  [in]  LPWORD pgi,
  [out] LPINT  piWidths
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] giFirst

Primo indice del glifo nel gruppo di indici glifi consecutivi.

[in] cgi

Numero di indici del glifo.

[in] pgi

Puntatore a una matrice di indici di glifi. Se questo parametro non è NULL, viene usato anziché il parametro giFirst .

[out] piWidths

Puntatore a un buffer che riceve le larghezze, 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

La funzione GetCharWidthI elabora indici di glifi consecutivi se il parametro pgi è NULL con il parametro giFirst che indica il primo indice del glifo da elaborare e il parametro cgi che indica il numero di indici del glifo da elaborare. In caso contrario, la funzione GetCharWidthI elabora la matrice di indici del glifo a cui punta il parametro pgi con il parametro cgi che indica il numero di indici glifi da elaborare.

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

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