Graphics ::MeasureDriverString, méthode (gdiplusgraphics.h)
La méthode Graphics ::MeasureDriverString mesure le cadre englobant pour les caractères spécifiés et leurs positions correspondantes.
Syntaxe
Status MeasureDriverString(
[in] const UINT16 *text,
[in] INT length,
[in] const Font *font,
[in] const PointF *positions,
[in] INT flags,
[in] const Matrix *matrix,
[out] RectF *boundingBox
);
Paramètres
[in] text
Type : const UINT16*
Pointeur vers un tableau de valeurs 16 bits. Si l’indicateur DriverStringOptionsCmapLookup est défini, chaque valeur spécifie un caractère Unicode à afficher. Sinon, chaque valeur spécifie un index pour un glyphe de police qui définit un caractère à afficher.
[in] length
Type : INT
Entier qui spécifie le nombre de valeurs dans le tableau de texte . Le paramètre length peut être défini sur –1 si la chaîne est terminée par null.
[in] font
Type : const Font*
Pointeur vers un objet Font qui spécifie le nom de famille, la taille et le style de la police à appliquer à la chaîne.
[in] positions
Type : const PointF*
Si l’indicateur DriverStringOptionsRealizedAdvance est défini, positions est un pointeur vers un objet PointF qui spécifie la position du premier glyphe. Sinon, positions est un tableau d’objets PointF , chacun spécifiant l’origine d’un glyphe individuel.
[in] flags
Type : INT
Entier qui spécifie les options pour l’apparence de la chaîne. Cette valeur doit être un élément de l’énumération DriverStringOptions ou le résultat d’un bit OU appliqué à au moins deux de ces éléments.
[in] matrix
Type : const Matrix*
Pointeur vers un objet Matrix qui spécifie la matrice de transformation à appliquer à chaque valeur du tableau de texte .
[out] boundingBox
Type : RectF*
Pointeur vers un objet RectF qui reçoit le rectangle qui lie la chaîne.
Valeur retournée
Type : État
Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .
Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP, Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | gdiplusgraphics.h (include Gdiplus.h) |
| Bibliothèque | Gdiplus.lib |
| DLL | Gdiplus.dll |