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

Artikel
03/04/2024

Die GraphicsPath::AddString-Methode fügt diesem Pfad die Gliederung 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 Rect &       layoutRect,
  [in]      const StringFormat *format
);

Parameter

[in] string

Typ: const WCHAR*

Zeiger auf eine Breitzeichenzeichenfolge.

[in] length

Typ: INT

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

[in] family

Typ: const FontFamily*

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

[in] style

Typ: INT

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.

[in] emSize

Typ: REAL

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

[in, ref] layoutRect

Typ: const Rect

Verweis auf ein Rect-Objekt , das in Welteinheiten das umgebende Rechteck für die Zeichenfolge angibt.

[in] format

Typ: const StringFormat*

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, 
      Rect(50, 50, 150, 100),
      NULL);

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

Anforderungen

Anforderung	Wert
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