Funzione GetCharABCWidthsI (wingdi.h)

Articolo
03/08/2023

La funzione GetCharABCWidthsI recupera le larghezze, in unità logiche, di indici glifi consecutivi in un intervallo specificato dal tipo di carattere TrueType corrente. Questa funzione ha esito positivo solo con i tipi di carattere TrueType.

Sintassi

BOOL GetCharABCWidthsI(
  [in]  HDC    hdc,
  [in]  UINT   giFirst,
  [in]  UINT   cgi,
  [in]  LPWORD pgi,
  [out] LPABC  pabc
);

Parametri

[in] hdc

Handle nel contesto del dispositivo.

[in] giFirst

Primo indice glifo nel gruppo di indici glifi consecutivi dal tipo di carattere corrente. Questo parametro viene usato solo se il parametro pgi è NULL.

[in] cgi

Numero di indici glifi.

[in] pgi

Puntatore a una matrice contenente indici glifi. Se questo parametro è NULL, viene invece usato il parametro giFirst . Il parametro cgi specifica il numero di indici glifi in questa matrice.

[out] pabc

Puntatore a una matrice di strutture ABC che ricevono le larghezze dei caratteri, in unità logiche. Questa matrice deve contenere almeno quante strutture ABC sono presenti indici glifi specificati dal parametro cgi .

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

Il rasterizzatore TrueType fornisce la spaziatura dei caratteri ABC dopo aver selezionato una dimensione del punto specifica. Una spaziatura è la distanza aggiunta alla posizione corrente prima di posizionare il glifo. La spaziatura B è la larghezza della parte nera del glifo. La spaziatura C è la distanza aggiunta alla posizione corrente per fornire spazio vuoto a destra del glifo. La larghezza totale avanzata è specificata da A+B+C.

Quando la funzione GetCharABCWidthsI recupera le larghezze A o C negative per un carattere, tale carattere include hangs o overhangs.

Per convertire le larghezze ABC in unità di progettazione dei tipi di carattere, un'applicazione deve usare il valore archiviato nel membro otmEMSquare di una struttura OUTLINETEXTMETRIC . Questo valore può essere recuperato chiamando la funzione GetOutlineTextMetrics .

Le larghezze ABC del carattere predefinito vengono usate per i caratteri all'esterno dell'intervallo del tipo di carattere attualmente selezionato.

Per recuperare le larghezze degli indici glifi nei tipi di carattere non TrueType, le applicazioni devono usare la funzione GetCharWidthI .

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