Graphics ::D rawDriverString, méthode (gdiplusgraphics.h)

Article
02/26/2024

La méthode Graphics ::D rawDriverString dessine des caractères aux positions spécifiées. La méthode donne au client un contrôle total sur l’apparence du texte. La méthode suppose que le client a déjà configuré le format et la disposition à appliquer.

Syntaxe

Status DrawDriverString(
  [in] const UINT16 *text,
  [in] INT          length,
  [in] const Font   *font,
  [in] const Brush  *brush,
  [in] const PointF *positions,
  [in] INT          flags,
  [in] const Matrix *matrix
);

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] brush

Type : const Brush*

Pointeur vers un objet Brush utilisé pour remplir 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 .

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 .

Remarques

Cette méthode ne prend pas en charge la gestion des scripts complexes et suppose que le client a configuré toute la disposition du texte d’une autre manière. Cette méthode est utile pour créer des éléments de menu dessinés par le propriétaire. Le client doit utiliser la méthode DrawString Methods à des fins générales.

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