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

Artikel
2024-01-10

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

Syntax

Status AddString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const FontFamily   *family,
  [in]      INT                style,
  [in]      REAL               emSize,
  [in, ref] const Point &      origin,
  [in]      const StringFormat *format
);

Parameter

[in] string

Typ: const WCHAR*

Zeiger auf eine Breitzeichenzeichenfolge.

[in] length

Typ: INT

Eine ganze Zahl, die die Anzahl der anzuzeigenden Zeichen angibt. Wenn der Zeichenfolgenparameter auf eine MIT NULL beendete Zeichenfolge zeigt, kann dieser Parameter auf –1 festgelegt werden.

[in] family

Typ: const FontFamily*

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

[in] style

Typ: INT

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

[in] emSize

Typ: REAL

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

[in, ref] origin

Typ: const Point

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

[in] format

Typ: const StringFormat*

Zeiger auf ein StringFormat-Objekt , das Layoutinformationen (Ausrichtung, Kürzung, 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, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

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

Beispiele

Im folgenden Beispiel wird ein GraphicsPath-Objektpfad erstellt, dem Pfad eine NULL-endende Zeichenfolge hinzugefügt und dann der Pfad zeichnet. zeichnet.

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, 
      Point(50, 50),
      NULL);

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdipluspath.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll