Graphics::D rawString(constWCHAR;INT,constFont,constPointF&,constStringFormat,constBrush)-Methode (gdiplusgraphics.h)

Artikel
01/10/2024

Die Graphics::D rawString-Methode zeichnet eine Zeichenfolge basierend auf einer Schriftart, einem Zeichenfolgenursprung und einem Format.

Syntax

Status DrawString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const Font         *font,
  [in, ref] const PointF &     origin,
  [in]      const StringFormat *stringFormat,
  [in]      const Brush        *brush
);

Parameter

[in] string

Typ: const WCHAR*

Zeiger auf eine Zeichenfolge, die gezeichnet werden soll.

[in] length

Typ: INT

Eine ganze Zahl, die die Anzahl der Zeichen im Zeichenfolgenarray angibt. Der length-Parameter kann auf –1 festgelegt werden, wenn die Zeichenfolge null beendet ist.

[in] font

Typ: const Font*

Zeiger auf ein Font-Objekt , das die zu verwendenden Schriftartattribute (den Familiennamen, die Größe und den Stil der Schriftart) angibt.

[in, ref] origin

Typ: const PointF

Verweis auf ein PointF-Objekt , das den Ausgangspunkt für die Zeichenfolge angibt.

[in] stringFormat

Typ: const StringFormat*

Zeiger auf ein StringFormat-Objekt , das Textlayoutinformationen und Anzeigebearbeitungen angibt, die auf die Zeichenfolge angewendet werden sollen.

[in] brush

Typ: const Brush*

Zeiger auf ein Brush-Objekt , das zum Füllen der Zeichenfolge verwendet wird.

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.

Wenn Sie die GDI+-API verwenden, dürfen Sie ihrer Anwendung nicht erlauben, beliebige Schriftarten aus nicht vertrauenswürdigen Quellen herunterzuladen. Das Betriebssystem erfordert erhöhte Berechtigungen, um sicherzustellen, dass alle installierten Schriftarten vertrauenswürdig sind.

Beispiele

Im folgenden Beispiel wird die angegebene Formatierung verwendet, um eine Zeichenfolge am angegebenen Ursprung zu zeichnen.

VOID Example_DrawString3(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a string.
   WCHAR string[] = L"Sample Text";
   
   // Initialize arguments.
   Font myFont(L"Arial", 16);
   PointF origin(0.0f, 0.0f);
   SolidBrush blackBrush(Color(255, 0, 0, 0));
   StringFormat format;
   format.SetAlignment(StringAlignmentCenter);

   // Draw string.
   graphics.DrawString(
   string,
   11,
   &myFont,
   origin,
   &format,
   &blackBrush);
}

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	gdiplusgraphics.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll