GraphicsPath ::AddString(constWCHAR,INT,constFontFamily,INT,REAL,constRect&,constStringFormat*) méthode (gdipluspath.h)

Article
02/26/2024

La méthode GraphicsPath ::AddString ajoute le contour d’une chaîne à ce chemin.

Syntaxe

Status AddString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const FontFamily   *family,
  [in]      INT                style,
  [in]      REAL               emSize,
  [in, ref] const Rect &       layoutRect,
  [in]      const StringFormat *format
);

Paramètres

[in] string

Type : const WCHAR*

Pointeur vers une chaîne à caractères larges.

[in] length

Type : INT

Entier qui spécifie le nombre de caractères à afficher. Si le paramètre string pointe vers une chaîne terminée par NULL, ce paramètre peut être défini sur –1.

[in] family

Type : const FontFamily*

Pointeur vers un objet FontFamily qui spécifie la famille de polices de la chaîne.

[in] style

Type : INT

Entier qui spécifie le style de la police. Cette valeur doit être un élément de l’énumération FontStyle ou le résultat d’un bit OR appliqué à deux ou plusieurs de ces éléments. Par exemple, FontStyleBold | FontStyleUnderline | FontStyleStrikeout définit le style en tant que combinaison des trois styles.

[in] emSize

Type : REAL

Nombre réel qui spécifie la taille des caractères de chaîne, en unités de monde.

[in, ref] layoutRect

Type : const Rect

Référence à un objet Rect qui spécifie, en unités de monde, le rectangle englobant de la chaîne.

[in] format

Type : const StringFormat*

Pointeur vers un objet StringFormat qui spécifie des informations de disposition (alignement, découpage, taquets de tabulation, etc.) pour 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 .

Remarques

Notez que GDI+ ne prend pas en charge les polices PostScript ou OpenType qui n’ont pas de contours TrueType.

Exemples

L’exemple suivant crée un chemin d’objet GraphicsPath, ajoute une chaîne terminée par NULL au chemin, puis dessine le chemin.

VOID Example_AddString(HDC hdc)
{
   Graphics graphics(hdc);
   FontFamily fontFamily(L"Times New Roman");
   GraphicsPath path;

   path.AddString(
      L"Hello World", 
      -1,                 // NULL-terminated string
      &fontFamily, 
      FontStyleRegular, 
      48, 
      Rect(50, 50, 150, 100),
      NULL);

   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}

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	gdipluspath.h (include Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll