funzione STROBJ_bGetAdvanceWidths (winddi.h)
La funzione STROBJ_bGetAdvanceWidths recupera una matrice di vettori che specifica le probabili larghezze degli glifi che costituiscono una stringa specificata.
Sintassi
ENGAPI BOOL STROBJ_bGetAdvanceWidths(
STROBJ *pso,
[in] ULONG iFirst,
ULONG c,
POINTQF *pptqD
);
Parametri
pso
Puntatore fornito dal chiamante a una struttura STROBJ che descrive una stringa di testo. Questa è in genere la struttura STROBJ ricevuta dalla funzione DrvTextOut del driver.
[in] iFirst
È un indice fornito dal chiamante, in base zero nella stringa di testo fornita dalla struttura STROBJ. Questo indice rappresenta il primo carattere della stringa per cui verrà restituita una larghezza.
c
Conteggio fornito dal chiamante del numero di caratteri contigui, a partire e al carattere specificato da iFirst, per i quali devono essere restituiti i valori di larghezza.
pptqD
Puntatore fornito dal chiamante a una matrice c-size di strutture POINTQF per ricevere le larghezze dei caratteri in (28,36, 28,36) formato. Per una descrizione di questo tipo di dati, vedere Tipi di dati GDI.
Valore restituito
Se l'operazione ha esito positivo, la funzione restituisce TRUE; in caso contrario, restituisce FALSE.
Commenti
La funzione STROBJ_bGetAdvanceWidths è utile per i driver della stampante che chiamano STROBJ_bEnumPositionsOnly anziché STROBJ_bEnum. La funzione riempie la matrice pptqD con le probabili larghezze degli glifi di una stringa e può essere usata per calcolare la posizione della stampante dopo il rendering di una stringa, se l'hardware di rendering del glifo della stampante non restituisce la larghezza esatta dei caratteri.
Si noti che le posizioni del glifo restituite da STROBJ_bEnumPositionsOnly non corrispondono necessariamente esattamente alle larghezze restituite da STROBJ_bGetAdvanceWidths.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | winddi.h (include Winddi.h) |
| Libreria | Win32k.lib |
| DLL | Win32k.sys |