Partager via


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

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

Voir aussi

Méthodes AddString

Découpage avec une région

Génération et dessin de tracés

Création d’un dégradé de chemin

Police

FontFamily

FontStyle

Graphicspath

RectF

StringFormat

Utilisation de texte et de polices