Funzione GetCharABCWidthsI (wingdi.h)
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 |