fonction STROBJ_bGetAdvanceWidths (winddi.h)
La fonction STROBJ_bGetAdvanceWidths récupère un tableau de vecteurs spécifiant les largeurs probables de glyphes constituant une chaîne spécifiée.
Syntaxe
ENGAPI BOOL STROBJ_bGetAdvanceWidths(
STROBJ *pso,
[in] ULONG iFirst,
ULONG c,
POINTQF *pptqD
);
Paramètres
pso
Pointeur fourni par l’appelant vers une structure STROBJ décrivant une chaîne de texte. Il s’agit généralement de la structure STROBJ reçue par la fonction DrvTextOut du pilote.
[in] iFirst
Index de base zéro fourni par l’appelant dans la chaîne de texte fournie par la structure STROBJ. Cet index représente le premier caractère de la chaîne pour laquelle une largeur doit être retournée.
c
Nombre fourni par l’appelant du nombre de caractères contigus, de départ et du caractère spécifié par iFirst, pour lesquels les valeurs de largeur doivent être retournées.
pptqD
Pointeur fourni par l’appelant vers un tableau de structures POINTQF de taille C pour recevoir des largeurs de caractères au format (28.36, 28.36). Pour obtenir une description de ce type de données, consultez Types de données GDI.
Valeur retournée
Si l’opération réussit, la fonction retourne TRUE ; sinon, il retourne FALSE.
Remarques
La fonction STROBJ_bGetAdvanceWidths est utile pour les pilotes d’imprimante qui appellent STROBJ_bEnumPositionsOnly au lieu de STROBJ_bEnum. La fonction remplit le tableau pptqD avec les largeurs probables des glyphes d’une chaîne et peut être utilisée pour calculer la position de l’imprimante après une chaîne telle qu’elle a été rendue par l’imprimante, si le matériel de rendu du glyphe de l’imprimante ne retourne pas exactement les largeurs de caractères.
Notez que les positions de glyphe retournées par STROBJ_bEnumPositionsOnly ne correspondent pas nécessairement exactement aux largeurs retournées par STROBJ_bGetAdvanceWidths.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Universal |
| En-tête | winddi.h (inclure Winddi.h) |
| Bibliothèque | Win32k.lib |
| DLL | Win32k.sys |