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

Article
01/10/2024

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

Syntaxe

Status AddString(
  const WCHAR        *string,
  INT                length,
  const FontFamily   *family,
  INT                style,
  REAL               emSize,
  const PointF &     origin,
  const StringFormat *format
);

Paramètres

string

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

length

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.

family

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

style

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.

emSize

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

origin

Référence à un objet PointF qui spécifie, en unités mondiales, l’emplacement de la chaîne.

format

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 :Status

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, 
      PointF(50.0f, 50.0f),
      NULL);

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