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

Article
07/16/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 de chaîne pointe vers une chaîne NULL-terminated, ce paramètre peut être défini sur –1.

family

Pointeur vers un objet FontFamily qui spécifie la famille de polices pour 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 du résultat d’une OU appliquée à deux ou plusieurs de ces éléments. Par exemple, FontStyleBold | FontStyleUnderline | FontStyleStrikeout définit le style comme combinaison des trois styles.

emSize

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

origin

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

format

Pointeur vers un StringFormat objet qui spécifie les informations de disposition (alignement, découpage, taquets de tabulation et similaires) pour la chaîne.

Valeur de retour

type : d’é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 les polices OpenType qui n’ont pas 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);
}