Condividi tramite


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

Vedi anche

DrvTextOut

STROBJ

STROBJ_bEnum

STROBJ_bEnumPositionsOnly