GraphicsPath ::AddString(constWCHAR,INT,constFontFamily,INT,REAL,constRectF&,constStringFormat*) (gdipluspath.h)

Article
01/10/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 RectF &      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 de chaîne 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 de type. Cette valeur doit être un élément de l’énumération FontStyle ou le résultat d’une OR au niveau du bit appliquée à 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 em, en unités mondiales, des caractères de chaîne.

[in, ref] layoutRect

Type : const RectF

Référence à un objet RectF qui spécifie, en unités mondiales, 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, 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’accès à l’objet GraphicsPath, ajoute une chaîne terminée par NULL au chemin d’accès, 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, 
      RectF(50.0f, 50.0f, 150.0f, 100.0f),
      NULL);

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

Configuration requise


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