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

Article
08/24/2023

La méthode GraphicsPath ::AddString ajoute les contours 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 Point &      origin,
  [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] origin

Type : const Point

Référence à un objet Point qui spécifie, en unités mondiales, l’emplacement 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, 
      Point(50, 50),
      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 (include Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll