Graphics ::MeasureDriverString, méthode (gdiplusgraphics.h)

Article
02/29/2024

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