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

Artikel
01/10/2024

Die GraphicsPath::AddString-Methode fügt diesem Pfad die Gliederung einer Zeichenfolge 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 Breitzeichenzeichenfolge.

length

Ganzzahl, die die Anzahl der anzuzeigenden Zeichen angibt. Wenn der Zeichenfolgenparameter auf eine NULL-beendete Zeichenfolge verweist, kann dieser Parameter auf –1 festgelegt werden.

family

Zeiger auf ein FontFamily-Objekt , das die Schriftfamilie für die Zeichenfolge angibt.

style

Ganzzahl, die den Stil der Schriftart angibt. Dieser Wert muss ein Element der FontStyle-Enumeration oder das Ergebnis eines bitweisen OR sein, das auf zwei oder mehr dieser Elemente angewendet wird. Legt beispielsweise FontStyleBold | FontStyleUnderline | FontStyleStrikeout den Stil als Kombination der drei Stile fest.

emSize

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

origin

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

format

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

Rückgabewert

Typ:Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Beachten Sie, dass GDI+ keine PostScript- oder OpenType-Schriftarten unterstützt, die keine TrueType-Gliederungen aufweisen.

Beispiele

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

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