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

Voir aussi

DrvTextOut

STROBJ

STROBJ_bEnum

STROBJ_bEnumPositionsOnly