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

Artikel
07/16/2024

Die GraphicsPath::AddString-Methode fügt die Gliederung einer Zeichenfolge zu diesem Pfad hinzu.

Syntax

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

Parameter

string

Zeiger auf eine breite Zeichenfolge.

length

Ganze Zahl, die die Anzahl der anzuzeigenden Zeichen angibt. Wenn der Zeichenfolgenparameter auf eine NULL--terminated string verweist, kann dieser Parameter auf -1 festgelegt werden.

family

Zeigen Sie auf ein FontFamily-Objekt, das die Schriftartfamilie für die Zeichenfolge angibt.

style

Ganze Zahl, die die Formatvorlage der Schriftart angibt. Dieser Wert muss ein Element der FontStyle- Enumeration oder das Ergebnis einer bitweisen ODER auf zwei oder mehr dieser Elemente angewendet werden. Beispielsweise legt FontStyleBold | FontStyleUnderline | FontStyleStrikeout die Formatvorlage als Kombination der drei Formatvorlagen fest.

emSize

Reelle Zahl, die die em Größe der Zeichenfolgenzeichen in Welteinheiten angibt.

origin

Verweisen Sie auf ein PointF--Objekt, das die Position der Zeichenfolge in Welteinheiten angibt.

format

Zeiger auf ein StringFormat--Objekt, das Layoutinformationen (Ausrichtung, Kürzen, Tabstopps und ähnliches) für die Zeichenfolge angibt.

Rückgabewert

Typ:Status

Wenn die Methode erfolgreich ist, wird Ok zurückgegeben, bei dem es sich um ein Element der Status Enumeration handelt.

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status Enumeration zurückgegeben.

Bemerkungen

Beachten Sie, dass GDI+ keine PostScript-Schriftarten oder OpenType-Schriftarten unterstützt, die nicht über TrueType- Gliederungen verfügen.

Beispiele

Im folgenden Beispiel wird ein GraphicsPath- Objektpfad erstellt, eine NULL-beendete Zeichenfolge zum Pfad hinzugefügt und dann der Pfad bezieht.

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);
}