Freigeben über


Graphics.DrawString Methode

Definition

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten.

Überlädt

DrawString(String, Font, Brush, Single, Single, StringFormat)

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten mithilfe der Formatierungsattribute der angegebenen StringFormat.

DrawString(ReadOnlySpan<Char>, Font, Brush, Single, Single, StringFormat)

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten mithilfe der Formatierungsattribute der angegebenen StringFormat.

DrawString(String, Font, Brush, Single, Single)

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten.

DrawString(String, Font, Brush, RectangleF, StringFormat)

Zeichnet die angegebene Textzeichenfolge im angegebenen Rechteck mit den angegebenen Brush und Font Objekten mithilfe der Formatierungsattribute der angegebenen StringFormat.

DrawString(String, Font, Brush, PointF, StringFormat)

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten mithilfe der Formatierungsattribute der angegebenen StringFormat.

DrawString(ReadOnlySpan<Char>, Font, Brush, Single, Single)

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten.

DrawString(ReadOnlySpan<Char>, Font, Brush, PointF, StringFormat)

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten mithilfe der Formatierungsattribute der angegebenen StringFormat.

DrawString(String, Font, Brush, RectangleF)

Zeichnet die angegebene Textzeichenfolge im angegebenen Rechteck mit den angegebenen Brush und Font Objekten.

DrawString(String, Font, Brush, PointF)

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten.

DrawString(ReadOnlySpan<Char>, Font, Brush, RectangleF)

Zeichnet die angegebene Textzeichenfolge im angegebenen Rechteck mit den angegebenen Brush und Font Objekten.

DrawString(ReadOnlySpan<Char>, Font, Brush, PointF)

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten.

DrawString(ReadOnlySpan<Char>, Font, Brush, RectangleF, StringFormat)

Zeichnet die angegebene Textzeichenfolge im angegebenen Rechteck mit den angegebenen Brush und Font Objekten mithilfe der Formatierungsattribute der angegebenen StringFormat.

DrawString(String, Font, Brush, Single, Single, StringFormat)

Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten mithilfe der Formatierungsattribute der angegebenen StringFormat.

public:
 void DrawString(System::String ^ s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, float x, float y, System::Drawing::StringFormat ^ format);
public void DrawString (string? s, System.Drawing.Font font, System.Drawing.Brush brush, float x, float y, System.Drawing.StringFormat? format);
public void DrawString (string s, System.Drawing.Font font, System.Drawing.Brush brush, float x, float y, System.Drawing.StringFormat format);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * single * single * System.Drawing.StringFormat -> unit
Public Sub DrawString (s As String, font As Font, brush As Brush, x As Single, y As Single, format As StringFormat)

Parameter

s
String

Zu zeichnende Zeichenfolge.

font
Font

Font, die das Textformat der Zeichenfolge definiert.

brush
Brush

Brush, die die Farbe und Textur des gezeichneten Texts bestimmt.

x
Single

Die x-Koordinate der oberen linken Ecke des gezeichneten Texts.

y
Single

Die y-Koordinate der oberen linken Ecke des gezeichneten Texts.

format
StringFormat

StringFormat, die Formatierungsattribute wie Zeilenabstand und Ausrichtung angibt, die auf den gezeichneten Text angewendet werden.

Ausnahmen

brush ist null.

-oder-

s ist null.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

  • Erstellt eine zu zeichnende Textzeichenfolge.

  • Definiert die Schriftart als Arial (16 pt).

  • Erstellt einen einfarbigen, schwarzen Pinsel, mit dem gezeichnet werden soll.

  • Erstellt die Koordinaten eines Punkts für die obere linke Ecke, an der der Text gezeichnet werden soll.

  • Legt das Format der Zeichenfolge fest, die vertikal gezeichnet werden soll

  • Zeichnet die Zeichenfolge mithilfe der Schriftart, des Pinsels, des Zielpunkts und des Formats auf dem Bildschirm.

public:
   void DrawStringFloatFormat( PaintEventArgs^ e )
   {
      // Create string to draw.
      String^ drawString = "Sample Text";

      // Create font and brush.
      System::Drawing::Font^ drawFont = gcnew System::Drawing::Font( "Arial",16 );
      SolidBrush^ drawBrush = gcnew SolidBrush( Color::Black );

      // Create point for upper-left corner of drawing.
      float x = 150.0F;
      float y = 50.0F;

      // Set format of string.
      StringFormat^ drawFormat = gcnew StringFormat;
      drawFormat->FormatFlags = StringFormatFlags::DirectionVertical;

      // Draw string to screen.
      e->Graphics->DrawString( drawString, drawFont, drawBrush, x, y, drawFormat );
   }
public void DrawStringFloatFormat(PaintEventArgs e)
{
             
    // Create string to draw.
    String drawString = "Sample Text";
             
    // Create font and brush.
    Font drawFont = new Font("Arial", 16);
    SolidBrush drawBrush = new SolidBrush(Color.Black);
             
    // Create point for upper-left corner of drawing.
    float x = 150.0F;
    float y =  50.0F;
             
    // Set format of string.
    StringFormat drawFormat = new StringFormat();
    drawFormat.FormatFlags = StringFormatFlags.DirectionVertical;
             
    // Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, x, y, drawFormat);
}
Public Sub DrawStringFloatFormat(ByVal e As PaintEventArgs)

    ' Create string to draw.
    Dim drawString As [String] = "Sample Text"

    ' Create font and brush.
    Dim drawFont As New Font("Arial", 16)
    Dim drawBrush As New SolidBrush(Color.Black)

    ' Create point for upper-left corner of drawing.
    Dim x As Single = 150.0F
    Dim y As Single = 50.0F

    ' Set format of string.
    Dim drawFormat As New StringFormat
    drawFormat.FormatFlags = StringFormatFlags.DirectionVertical

    ' Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, _
    x, y, drawFormat)
End Sub

Weitere Informationen

Gilt für:

DrawString(ReadOnlySpan<Char>, Font, Brush, Single, Single, StringFormat)

Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten mithilfe der Formatierungsattribute der angegebenen StringFormat.

public:
 void DrawString(ReadOnlySpan<char> s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, float x, float y, System::Drawing::StringFormat ^ format);
public void DrawString (ReadOnlySpan<char> s, System.Drawing.Font font, System.Drawing.Brush brush, float x, float y, System.Drawing.StringFormat? format);
member this.DrawString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Brush * single * single * System.Drawing.StringFormat -> unit
Public Sub DrawString (s As ReadOnlySpan(Of Char), font As Font, brush As Brush, x As Single, y As Single, format As StringFormat)

Parameter

s
ReadOnlySpan<Char>

Zu zeichnende Zeichenfolge.

font
Font

Font, die das Textformat der Zeichenfolge definiert.

brush
Brush

Brush, die die Farbe und Textur des gezeichneten Texts bestimmt.

x
Single

Die x-Koordinate der oberen linken Ecke des gezeichneten Texts.

y
Single

Die y-Koordinate der oberen linken Ecke des gezeichneten Texts.

format
StringFormat

StringFormat, die Formatierungsattribute wie Zeilenabstand und Ausrichtung angibt, die auf den gezeichneten Text angewendet werden.

Gilt für:

DrawString(String, Font, Brush, Single, Single)

Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten.

public:
 void DrawString(System::String ^ s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, float x, float y);
public void DrawString (string? s, System.Drawing.Font font, System.Drawing.Brush brush, float x, float y);
public void DrawString (string s, System.Drawing.Font font, System.Drawing.Brush brush, float x, float y);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * single * single -> unit
Public Sub DrawString (s As String, font As Font, brush As Brush, x As Single, y As Single)

Parameter

s
String

Zu zeichnende Zeichenfolge.

font
Font

Font, die das Textformat der Zeichenfolge definiert.

brush
Brush

Brush, die die Farbe und Textur des gezeichneten Texts bestimmt.

x
Single

Die x-Koordinate der oberen linken Ecke des gezeichneten Texts.

y
Single

Die y-Koordinate der oberen linken Ecke des gezeichneten Texts.

Ausnahmen

brush ist null.

-oder-

s ist null.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

  • Erstellt eine zu zeichnende Textzeichenfolge.

  • Definiert die Schriftart als Arial (16 pt).

  • Erstellt einen einfarbigen schwarzen Pinsel, mit dem gezeichnet werden soll.

  • Erstellt einen Punkt für die obere linke Ecke, an der der Text gezeichnet werden soll.

  • Zeichnet die Zeichenfolge mithilfe der Schriftart, des Pinsels und des Zielpunkts auf den Bildschirm.

public:
   void DrawStringFloat( PaintEventArgs^ e )
   {
      // Create string to draw.
      String^ drawString = "Sample Text";

      // Create font and brush.
      System::Drawing::Font^ drawFont = gcnew System::Drawing::Font( "Arial",16 );
      SolidBrush^ drawBrush = gcnew SolidBrush( Color::Black );

      // Create point for upper-left corner of drawing.
      float x = 150.0F;
      float y = 150.0F;

      // Draw string to screen.
      e->Graphics->DrawString( drawString, drawFont, drawBrush, x, y );
   }
public void DrawStringFloat(PaintEventArgs e)
{
             
    // Create string to draw.
    String drawString = "Sample Text";
             
    // Create font and brush.
    Font drawFont = new Font("Arial", 16);
    SolidBrush drawBrush = new SolidBrush(Color.Black);
             
    // Create point for upper-left corner of drawing.
    float x = 150.0F;
    float y = 150.0F;
             
    // Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, x, y);
}
Public Sub DrawStringFloat(ByVal e As PaintEventArgs)

    ' Create string to draw.
    Dim drawString As [String] = "Sample Text"

    ' Create font and brush.
    Dim drawFont As New Font("Arial", 16)
    Dim drawBrush As New SolidBrush(Color.Black)

    ' Create point for upper-left corner of drawing.
    Dim x As Single = 150.0F
    Dim y As Single = 150.0F

    ' Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, x, y)
End Sub

Weitere Informationen

Gilt für:

DrawString(String, Font, Brush, RectangleF, StringFormat)

Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs

Zeichnet die angegebene Textzeichenfolge im angegebenen Rechteck mit den angegebenen Brush und Font Objekten mithilfe der Formatierungsattribute der angegebenen StringFormat.

public:
 void DrawString(System::String ^ s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, System::Drawing::RectangleF layoutRectangle, System::Drawing::StringFormat ^ format);
public void DrawString (string? s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.RectangleF layoutRectangle, System.Drawing.StringFormat? format);
public void DrawString (string s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.RectangleF layoutRectangle, System.Drawing.StringFormat format);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * System.Drawing.RectangleF * System.Drawing.StringFormat -> unit
Public Sub DrawString (s As String, font As Font, brush As Brush, layoutRectangle As RectangleF, format As StringFormat)

Parameter

s
String

Zu zeichnende Zeichenfolge.

font
Font

Font, die das Textformat der Zeichenfolge definiert.

brush
Brush

Brush, die die Farbe und Textur des gezeichneten Texts bestimmt.

layoutRectangle
RectangleF

RectangleF Struktur, die die Position des gezeichneten Texts angibt.

format
StringFormat

StringFormat, die Formatierungsattribute wie Zeilenabstand und Ausrichtung angibt, die auf den gezeichneten Text angewendet werden.

Ausnahmen

brush ist null.

-oder-

s ist null.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

  • Erstellt eine zu zeichnende Textzeichenfolge.

  • Definiert die Schriftart als Arial (16 pt).

  • Erstellt einen einfarbigen, schwarzen Pinsel, mit dem gezeichnet werden soll.

  • Erstellt ein Rechteck, in dem der Text gezeichnet werden soll.

  • Zeichnet das Rechteck auf den Bildschirm.

  • Legt das Format der Zeichenfolge fest, um sie innerhalb des Rechtecks zu zentrieren.

  • Zeichnet die Zeichenfolge mithilfe der Schriftart, des Pinsels und des Zielrechtecks auf den Bildschirm.

public:
   void DrawStringRectangleFFormat( PaintEventArgs^ e )
   {
      // Create string to draw.
      String^ drawString = "Sample Text";

      // Create font and brush.
      System::Drawing::Font^ drawFont = gcnew System::Drawing::Font( "Arial",16 );
      SolidBrush^ drawBrush = gcnew SolidBrush( Color::Black );

      // Create rectangle for drawing.
      float x = 150.0F;
      float y = 150.0F;
      float width = 200.0F;
      float height = 50.0F;
      RectangleF drawRect = RectangleF(x,y,width,height);

      // Draw rectangle to screen.
      Pen^ blackPen = gcnew Pen( Color::Black );
      e->Graphics->DrawRectangle( blackPen, x, y, width, height );

      // Set format of string.
      StringFormat^ drawFormat = gcnew StringFormat;
      drawFormat->Alignment = StringAlignment::Center;

      // Draw string to screen.
      e->Graphics->DrawString( drawString, drawFont, drawBrush, drawRect, drawFormat );
   }
public void DrawStringRectangleFFormat(PaintEventArgs e)
{
             
    // Create string to draw.
    String drawString = "Sample Text";
             
    // Create font and brush.
    Font drawFont = new Font("Arial", 16);
    SolidBrush drawBrush = new SolidBrush(Color.Black);
             
    // Create rectangle for drawing.
    float x = 150.0F;
    float y = 150.0F;
    float width = 200.0F;
    float height = 50.0F;
    RectangleF drawRect = new RectangleF(x, y, width, height);
             
    // Draw rectangle to screen.
    Pen blackPen = new Pen(Color.Black);
    e.Graphics.DrawRectangle(blackPen, x, y, width, height);
             
    // Set format of string.
    StringFormat drawFormat = new StringFormat();
    drawFormat.Alignment = StringAlignment.Center;
             
    // Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, drawRect, drawFormat);
}
Public Sub DrawStringRectangleFFormat(ByVal e As PaintEventArgs)

    ' Create string to draw.
    Dim drawString As [String] = "Sample Text"

    ' Create font and brush.
    Dim drawFont As New Font("Arial", 16)
    Dim drawBrush As New SolidBrush(Color.Black)

    ' Create rectangle for drawing.
    Dim x As Single = 150.0F
    Dim y As Single = 150.0F
    Dim width As Single = 200.0F
    Dim height As Single = 50.0F
    Dim drawRect As New RectangleF(x, y, width, height)

    ' Draw rectangle to screen.
    Dim blackPen As New Pen(Color.Black)
    e.Graphics.DrawRectangle(blackPen, x, y, width, height)

    ' Set format of string.
    Dim drawFormat As New StringFormat
    drawFormat.Alignment = StringAlignment.Center

    ' Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, _
    drawRect, drawFormat)
End Sub

Hinweise

Der durch den parameter s dargestellte Text wird innerhalb des durch den parameter layoutRectangle dargestellten Rechtecks gezeichnet. Wenn der Text nicht in das Rechteck passt, wird er am nächsten Wort abgeschnitten, es sei denn, er wird mit dem parameter format anders angegeben.

Weitere Informationen

Gilt für:

DrawString(String, Font, Brush, PointF, StringFormat)

Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten mithilfe der Formatierungsattribute der angegebenen StringFormat.

public:
 void DrawString(System::String ^ s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, System::Drawing::PointF point, System::Drawing::StringFormat ^ format);
public void DrawString (string? s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.PointF point, System.Drawing.StringFormat? format);
public void DrawString (string s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.PointF point, System.Drawing.StringFormat format);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * System.Drawing.PointF * System.Drawing.StringFormat -> unit
Public Sub DrawString (s As String, font As Font, brush As Brush, point As PointF, format As StringFormat)

Parameter

s
String

Zu zeichnende Zeichenfolge.

font
Font

Font, die das Textformat der Zeichenfolge definiert.

brush
Brush

Brush, die die Farbe und Textur des gezeichneten Texts bestimmt.

point
PointF

PointF Struktur, die die obere linke Ecke des gezeichneten Texts angibt.

format
StringFormat

StringFormat, die Formatierungsattribute wie Zeilenabstand und Ausrichtung angibt, die auf den gezeichneten Text angewendet werden.

Ausnahmen

brush ist null.

-oder-

s ist null.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

  • Erstellt eine zu zeichnende Textzeichenfolge.

  • Definiert die Schriftart als Arial (16 pt).

  • Erstellt einen einfarbigen, schwarzen Pinsel, mit dem gezeichnet werden soll.

  • Erstellt einen Punkt für die obere linke Ecke, an der der Text gezeichnet werden soll.

  • Legt das Format der Zeichenfolge fest, die vertikal gezeichnet werden soll.

  • Zeichnet die Zeichenfolge mithilfe der Schriftart, des Pinsels, des Zielpunkts und des Formats auf dem Bildschirm.

public:
   void DrawStringPointFFormat( PaintEventArgs^ e )
   {
      // Create string to draw.
      String^ drawString = "Sample Text";

      // Create font and brush.
      System::Drawing::Font^ drawFont = gcnew System::Drawing::Font( "Arial",16 );
      SolidBrush^ drawBrush = gcnew SolidBrush( Color::Black );

      // Create point for upper-left corner of drawing.
      PointF drawPoint = PointF(150.0F,50.0F);

      // Set format of string.
      StringFormat^ drawFormat = gcnew StringFormat;
      drawFormat->FormatFlags = StringFormatFlags::DirectionVertical;

      // Draw string to screen.
      e->Graphics->DrawString( drawString, drawFont, drawBrush, drawPoint, drawFormat );
   }
public void DrawStringPointFFormat(PaintEventArgs e)
{
             
    // Create string to draw.
    String drawString = "Sample Text";
             
    // Create font and brush.
    Font drawFont = new Font("Arial", 16);
    SolidBrush drawBrush = new SolidBrush(Color.Black);
             
    // Create point for upper-left corner of drawing.
    PointF drawPoint = new PointF(150.0F, 50.0F);
             
    // Set format of string.
    StringFormat drawFormat = new StringFormat();
    drawFormat.FormatFlags = StringFormatFlags.DirectionVertical;
             
    // Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, drawPoint, drawFormat);
}
Public Sub DrawStringPointFFormat(ByVal e As PaintEventArgs)

    ' Create string to draw.
    Dim drawString As [String] = "Sample Text"

    ' Create font and brush.
    Dim drawFont As New Font("Arial", 16)
    Dim drawBrush As New SolidBrush(Color.Black)

    ' Create point for upper-left corner of drawing.
    Dim drawPoint As New PointF(150.0F, 50.0F)

    ' Set format of string.
    Dim drawFormat As New StringFormat
    drawFormat.FormatFlags = StringFormatFlags.DirectionVertical

    ' Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, _
    drawPoint, drawFormat)
End Sub

Weitere Informationen

Gilt für:

DrawString(ReadOnlySpan<Char>, Font, Brush, Single, Single)

Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten.

public:
 void DrawString(ReadOnlySpan<char> s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, float x, float y);
public void DrawString (ReadOnlySpan<char> s, System.Drawing.Font font, System.Drawing.Brush brush, float x, float y);
member this.DrawString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Brush * single * single -> unit
Public Sub DrawString (s As ReadOnlySpan(Of Char), font As Font, brush As Brush, x As Single, y As Single)

Parameter

s
ReadOnlySpan<Char>

Zu zeichnende Zeichenfolge.

font
Font

Font, die das Textformat der Zeichenfolge definiert.

brush
Brush

Brush, die die Farbe und Textur des gezeichneten Texts bestimmt.

x
Single

Die x-Koordinate der oberen linken Ecke des gezeichneten Texts.

y
Single

Die y-Koordinate der oberen linken Ecke des gezeichneten Texts.

Gilt für:

DrawString(ReadOnlySpan<Char>, Font, Brush, PointF, StringFormat)

Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten mithilfe der Formatierungsattribute der angegebenen StringFormat.

public:
 void DrawString(ReadOnlySpan<char> s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, System::Drawing::PointF point, System::Drawing::StringFormat ^ format);
public void DrawString (ReadOnlySpan<char> s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.PointF point, System.Drawing.StringFormat? format);
member this.DrawString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Brush * System.Drawing.PointF * System.Drawing.StringFormat -> unit
Public Sub DrawString (s As ReadOnlySpan(Of Char), font As Font, brush As Brush, point As PointF, format As StringFormat)

Parameter

s
ReadOnlySpan<Char>

Zu zeichnende Zeichenfolge.

font
Font

Font, die das Textformat der Zeichenfolge definiert.

brush
Brush

Brush, die die Farbe und Textur des gezeichneten Texts bestimmt.

point
PointF

PointF Struktur, die die obere linke Ecke des gezeichneten Texts angibt.

format
StringFormat

StringFormat, die Formatierungsattribute wie Zeilenabstand und Ausrichtung angibt, die auf den gezeichneten Text angewendet werden.

Gilt für:

DrawString(String, Font, Brush, RectangleF)

Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs

Zeichnet die angegebene Textzeichenfolge im angegebenen Rechteck mit den angegebenen Brush und Font Objekten.

public:
 void DrawString(System::String ^ s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, System::Drawing::RectangleF layoutRectangle);
public void DrawString (string? s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.RectangleF layoutRectangle);
public void DrawString (string s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.RectangleF layoutRectangle);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * System.Drawing.RectangleF -> unit
Public Sub DrawString (s As String, font As Font, brush As Brush, layoutRectangle As RectangleF)

Parameter

s
String

Zu zeichnende Zeichenfolge.

font
Font

Font, die das Textformat der Zeichenfolge definiert.

brush
Brush

Brush, die die Farbe und Textur des gezeichneten Texts bestimmt.

layoutRectangle
RectangleF

RectangleF Struktur, die die Position des gezeichneten Texts angibt.

Ausnahmen

brush ist null.

-oder-

s ist null.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

  • Erstellt eine zu zeichnende Textzeichenfolge.

  • Definiert die Schriftart als Arial (16 pt).

  • Erstellt einen einfarbigen, schwarzen Pinsel, mit dem gezeichnet werden soll.

  • Erstellt ein Rechteck, in dem der Text gezeichnet werden soll.

  • Zeichnet das Rechteck auf den Bildschirm.

  • Zeichnet die Zeichenfolge mithilfe der Schriftart, des Pinsels und des Zielrechtecks auf den Bildschirm.

public:
   void DrawStringRectangleF( PaintEventArgs^ e )
   {
      // Create string to draw.
      String^ drawString = "Sample Text";

      // Create font and brush.
      System::Drawing::Font^ drawFont = gcnew System::Drawing::Font( "Arial",16 );
      SolidBrush^ drawBrush = gcnew SolidBrush( Color::Black );

      // Create rectangle for drawing.
      float x = 150.0F;
      float y = 150.0F;
      float width = 200.0F;
      float height = 50.0F;
      RectangleF drawRect = RectangleF(x,y,width,height);

      // Draw rectangle to screen.
      Pen^ blackPen = gcnew Pen( Color::Black );
      e->Graphics->DrawRectangle( blackPen, x, y, width, height );

      // Draw string to screen.
      e->Graphics->DrawString( drawString, drawFont, drawBrush, drawRect );
   }
public void DrawStringRectangleF(PaintEventArgs e)
{
             
    // Create string to draw.
    String drawString = "Sample Text";
             
    // Create font and brush.
    Font drawFont = new Font("Arial", 16);
    SolidBrush drawBrush = new SolidBrush(Color.Black);
             
    // Create rectangle for drawing.
    float x = 150.0F;
    float y = 150.0F;
    float width = 200.0F;
    float height = 50.0F;
    RectangleF drawRect = new RectangleF(x, y, width, height);
             
    // Draw rectangle to screen.
    Pen blackPen = new Pen(Color.Black);
    e.Graphics.DrawRectangle(blackPen, x, y, width, height);
             
    // Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, drawRect);
}
Public Sub DrawStringRectangleF(ByVal e As PaintEventArgs)

    ' Create string to draw.
    Dim drawString As [String] = "Sample Text"

    ' Create font and brush.
    Dim drawFont As New Font("Arial", 16)
    Dim drawBrush As New SolidBrush(Color.Black)

    ' Create rectangle for drawing.
    Dim x As Single = 150.0F
    Dim y As Single = 150.0F
    Dim width As Single = 200.0F
    Dim height As Single = 50.0F
    Dim drawRect As New RectangleF(x, y, width, height)

    ' Draw rectangle to screen.
    Dim blackPen As New Pen(Color.Black)
    e.Graphics.DrawRectangle(blackPen, x, y, width, height)

    ' Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, drawRect)
End Sub

Hinweise

Der durch den parameter s dargestellte Text wird innerhalb des durch den parameter layoutRectangle dargestellten Rechtecks gezeichnet. Wenn der Text nicht in das Rechteck passt, wird er am nächsten Wort abgeschnitten. Um weiter zu ändern, wie die Zeichenfolge innerhalb des Rechtecks gezeichnet wird, verwenden Sie die DrawString Überladung, die eine StringFormat.

Weitere Informationen

Gilt für:

DrawString(String, Font, Brush, PointF)

Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten.

public:
 void DrawString(System::String ^ s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, System::Drawing::PointF point);
public void DrawString (string? s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.PointF point);
public void DrawString (string s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.PointF point);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * System.Drawing.PointF -> unit
Public Sub DrawString (s As String, font As Font, brush As Brush, point As PointF)

Parameter

s
String

Zu zeichnende Zeichenfolge.

font
Font

Font, die das Textformat der Zeichenfolge definiert.

brush
Brush

Brush, die die Farbe und Textur des gezeichneten Texts bestimmt.

point
PointF

PointF Struktur, die die obere linke Ecke des gezeichneten Texts angibt.

Ausnahmen

brush ist null.

-oder-

s ist null.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

  • Erstellt eine zu zeichnende Textzeichenfolge.

  • Definiert die Schriftart als Arial (16 pt).

  • Erstellt einen einfarbigen, schwarzen Pinsel, mit dem gezeichnet werden soll.

  • Erstellt einen Punkt für die obere linke Ecke, an der der Text gezeichnet werden soll.

  • Zeichnet die Zeichenfolge mithilfe der Schriftart, des Pinsels und des Zielpunkts auf den Bildschirm.

public:
   void DrawStringPointF( PaintEventArgs^ e )
   {
      // Create string to draw.
      String^ drawString = "Sample Text";

      // Create font and brush.
      System::Drawing::Font^ drawFont = gcnew System::Drawing::Font( "Arial",16 );
      SolidBrush^ drawBrush = gcnew SolidBrush( Color::Black );

      // Create point for upper-left corner of drawing.
      PointF drawPoint = PointF(150.0F,150.0F);

      // Draw string to screen.
      e->Graphics->DrawString( drawString, drawFont, drawBrush, drawPoint );
   }
public void DrawStringPointF(PaintEventArgs e)
{
             
    // Create string to draw.
    String drawString = "Sample Text";
             
    // Create font and brush.
    Font drawFont = new Font("Arial", 16);
    SolidBrush drawBrush = new SolidBrush(Color.Black);
             
    // Create point for upper-left corner of drawing.
    PointF drawPoint = new PointF(150.0F, 150.0F);
             
    // Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, drawPoint);
}
Public Sub DrawStringPointF(ByVal e As PaintEventArgs)

    ' Create string to draw.
    Dim drawString As [String] = "Sample Text"

    ' Create font and brush.
    Dim drawFont As New Font("Arial", 16)
    Dim drawBrush As New SolidBrush(Color.Black)

    ' Create point for upper-left corner of drawing.
    Dim drawPoint As New PointF(150.0F, 150.0F)

    ' Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, drawPoint)
End Sub

Weitere Informationen

Gilt für:

DrawString(ReadOnlySpan<Char>, Font, Brush, RectangleF)

Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs

Zeichnet die angegebene Textzeichenfolge im angegebenen Rechteck mit den angegebenen Brush und Font Objekten.

public:
 void DrawString(ReadOnlySpan<char> s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, System::Drawing::RectangleF layoutRectangle);
public void DrawString (ReadOnlySpan<char> s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.RectangleF layoutRectangle);
member this.DrawString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Brush * System.Drawing.RectangleF -> unit
Public Sub DrawString (s As ReadOnlySpan(Of Char), font As Font, brush As Brush, layoutRectangle As RectangleF)

Parameter

s
ReadOnlySpan<Char>

Zu zeichnende Zeichenfolge.

font
Font

Font, die das Textformat der Zeichenfolge definiert.

brush
Brush

Brush, die die Farbe und Textur des gezeichneten Texts bestimmt.

layoutRectangle
RectangleF

RectangleF Struktur, die die Position des gezeichneten Texts angibt.

Hinweise

Der durch den parameter s dargestellte Text wird innerhalb des durch den parameter layoutRectangle dargestellten Rechtecks gezeichnet. Wenn der Text nicht in das Rechteck passt, wird er am nächsten Wort abgeschnitten. Um weiter zu ändern, wie die Zeichenfolge innerhalb des Rechtecks gezeichnet wird, verwenden Sie die DrawString(ReadOnlySpan<Char>, Font, Brush, RectangleF, StringFormat) Überladung, die eine StringFormat.

Gilt für:

DrawString(ReadOnlySpan<Char>, Font, Brush, PointF)

Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs

Zeichnet die angegebene Textzeichenfolge an der angegebenen Position mit dem angegebenen Brush und Font Objekten.

public:
 void DrawString(ReadOnlySpan<char> s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, System::Drawing::PointF point);
public void DrawString (ReadOnlySpan<char> s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.PointF point);
member this.DrawString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Brush * System.Drawing.PointF -> unit
Public Sub DrawString (s As ReadOnlySpan(Of Char), font As Font, brush As Brush, point As PointF)

Parameter

s
ReadOnlySpan<Char>

Zu zeichnende Zeichenfolge.

font
Font

Font, die das Textformat der Zeichenfolge definiert.

brush
Brush

Brush, die die Farbe und Textur des gezeichneten Texts bestimmt.

point
PointF

PointF Struktur, die die obere linke Ecke des gezeichneten Texts angibt.

Gilt für:

DrawString(ReadOnlySpan<Char>, Font, Brush, RectangleF, StringFormat)

Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs

Zeichnet die angegebene Textzeichenfolge im angegebenen Rechteck mit den angegebenen Brush und Font Objekten mithilfe der Formatierungsattribute der angegebenen StringFormat.

public:
 void DrawString(ReadOnlySpan<char> s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, System::Drawing::RectangleF layoutRectangle, System::Drawing::StringFormat ^ format);
public void DrawString (ReadOnlySpan<char> s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.RectangleF layoutRectangle, System.Drawing.StringFormat? format);
member this.DrawString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Brush * System.Drawing.RectangleF * System.Drawing.StringFormat -> unit
Public Sub DrawString (s As ReadOnlySpan(Of Char), font As Font, brush As Brush, layoutRectangle As RectangleF, format As StringFormat)

Parameter

s
ReadOnlySpan<Char>

Zu zeichnende Zeichenfolge.

font
Font

Font, die das Textformat der Zeichenfolge definiert.

brush
Brush

Brush, die die Farbe und Textur des gezeichneten Texts bestimmt.

layoutRectangle
RectangleF

RectangleF Struktur, die die Position des gezeichneten Texts angibt.

format
StringFormat

StringFormat, die Formatierungsattribute wie Zeilenabstand und Ausrichtung angibt, die auf den gezeichneten Text angewendet werden.

Gilt für: