Graphics.DrawString Methode

Definition

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

Überlädt

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

Zeichnet die angegebene Zeichenfolge an der angegebenen Position mit dem angegebenen Brush-Objekt und dem angegebenen Font-Objekt unter Verwendung der Formatierungsattribute vom angegebenen StringFormat.

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

Zeichnet die angegebene Zeichenfolge an der angegebenen Position mit dem angegebenen Brush-Objekt und dem angegebenen Font-Objekt unter Verwendung der Formatierungsattribute vom angegebenen StringFormat.

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

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

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

Zeichnet die angegebene Zeichenfolge im angegebenen Rechteck mit dem angegebenen Brush-Objekt und dem angegebenen Font-Objekt unter Verwendung der Formatierungsattribute vom angegebenen StringFormat.

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

Zeichnet die angegebene Zeichenfolge an der angegebenen Position mit dem angegebenen Brush-Objekt und dem angegebenen Font-Objekt unter Verwendung der Formatierungsattribute vom angegebenen StringFormat.

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

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

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

Zeichnet die angegebene Zeichenfolge an der angegebenen Position mit dem angegebenen Brush-Objekt und dem angegebenen Font-Objekt unter Verwendung der Formatierungsattribute vom angegebenen StringFormat.

DrawString(String, Font, Brush, RectangleF)

Zeichnet die angegebene Textzeichenfolge in dem angegebenen Rechteck mit dem angegebenen Brush-Objekt und dem angegebenen Font-Objekt.

DrawString(String, Font, Brush, PointF)

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

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

Zeichnet die angegebene Textzeichenfolge in dem angegebenen Rechteck mit dem angegebenen Brush-Objekt und dem angegebenen Font-Objekt.

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

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

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

Zeichnet die angegebene Zeichenfolge im angegebenen Rechteck mit dem angegebenen Brush-Objekt und dem angegebenen Font-Objekt unter Verwendung der Formatierungsattribute vom angegebenen StringFormat.

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

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

Zeichnet die angegebene Zeichenfolge an der angegebenen Position mit dem angegebenen Brush-Objekt und dem angegebenen Font-Objekt unter Verwendung der Formatierungsattribute vom 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, der die Farbe und Struktur 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, das die Formatierungsattribute angibt, die auf den gezeichneten Text angewendet werden, z. B. Zeilenabstand und Ausrichtung.

Ausnahmen

brush ist null.

- oder -

s ist null.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

  • Erstellt eine zu zeichnende Textzeichenfolge.

  • Definiert die Schriftart als Arial (16pt).

  • Erstellt einen durchgehenden schwarzen Pinsel zum Zeichnen.

  • 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 den 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

Zeichnet die angegebene Zeichenfolge an der angegebenen Position mit dem angegebenen Brush-Objekt und dem angegebenen Font-Objekt unter Verwendung der Formatierungsattribute vom 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, der die Farbe und Struktur 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, das die Formatierungsattribute angibt, die auf den gezeichneten Text angewendet werden, z. B. Zeilenabstand und Ausrichtung.

Gilt für:

DrawString(String, 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-Objekt und dem angegebenen Font-Objekt.

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, der die Farbe und Struktur 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 ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

  • Erstellt eine zu zeichnende Textzeichenfolge.

  • Definiert die Schriftart als Arial (16pt).

  • Erstellt einen schwarzen Pinsel zum Zeichnen.

  • 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

Zeichnet die angegebene Zeichenfolge im angegebenen Rechteck mit dem angegebenen Brush-Objekt und dem angegebenen Font-Objekt unter Verwendung der Formatierungsattribute vom 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, der die Farbe und Struktur des gezeichneten Texts bestimmt.

layoutRectangle
RectangleF

RectangleF-Struktur, die die Position des gezeichneten Textes angibt.

format
StringFormat

StringFormat, das die Formatierungsattribute angibt, die auf den gezeichneten Text angewendet werden, z. B. Zeilenabstand und Ausrichtung.

Ausnahmen

brush ist null.

- oder -

s ist null.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

  • Erstellt eine zu zeichnende Textzeichenfolge.

  • Definiert die Schriftart als Arial (16pt).

  • Erstellt einen durchgehenden schwarzen Pinsel zum Zeichnen.

  • 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 s Parameter dargestellte Text wird innerhalb des Rechtecks gezeichnet, das durch den layoutRectangle Parameter dargestellt wird. Wenn der Text nicht in das Rechteck passt, wird er am nächsten Wort abgeschnitten, sofern nicht anders mit dem format Parameter angegeben.

Weitere Informationen

Gilt für:

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

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

Zeichnet die angegebene Zeichenfolge an der angegebenen Position mit dem angegebenen Brush-Objekt und dem angegebenen Font-Objekt unter Verwendung der Formatierungsattribute vom 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, der die Farbe und Struktur des gezeichneten Texts bestimmt.

point
PointF

PointF-Struktur, die die obere linke Ecke des gezeichneten Textes angibt.

format
StringFormat

StringFormat, das die Formatierungsattribute angibt, die auf den gezeichneten Text angewendet werden, z. B. Zeilenabstand und Ausrichtung.

Ausnahmen

brush ist null.

- oder -

s ist null.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

  • Erstellt eine zu zeichnende Textzeichenfolge.

  • Definiert die Schriftart als Arial (16pt).

  • Erstellt einen durchgehenden schwarzen Pinsel zum Zeichnen.

  • 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 den 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

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

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, der die Farbe und Struktur 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

Zeichnet die angegebene Zeichenfolge an der angegebenen Position mit dem angegebenen Brush-Objekt und dem angegebenen Font-Objekt unter Verwendung der Formatierungsattribute vom 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, der die Farbe und Struktur des gezeichneten Texts bestimmt.

point
PointF

PointF-Struktur, die die obere linke Ecke des gezeichneten Textes angibt.

format
StringFormat

StringFormat, das die Formatierungsattribute angibt, die auf den gezeichneten Text angewendet werden, z. B. Zeilenabstand und Ausrichtung.

Gilt für:

DrawString(String, Font, Brush, RectangleF)

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

Zeichnet die angegebene Textzeichenfolge in dem angegebenen Rechteck mit dem angegebenen Brush-Objekt und dem angegebenen Font-Objekt.

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, der die Farbe und Struktur des gezeichneten Texts bestimmt.

layoutRectangle
RectangleF

RectangleF-Struktur, die die Position des gezeichneten Textes angibt.

Ausnahmen

brush ist null.

- oder -

s ist null.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

  • Erstellt eine zu zeichnende Textzeichenfolge.

  • Definiert die Schriftart als Arial (16pt).

  • Erstellt einen durchgehenden schwarzen Pinsel zum Zeichnen.

  • 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 s Parameter dargestellte Text wird innerhalb des Rechtecks gezeichnet, das durch den layoutRectangle Parameter dargestellt wird. Wenn der Text nicht in das Rechteck passt, wird er beim nächsten Wort abgeschnitten. Um die Zeichenfolge im Rechteck weiter zu bearbeiten, verwenden Sie die Überladung, die DrawString einen StringFormatbenötigt.

Weitere Informationen

Gilt für:

DrawString(String, Font, Brush, PointF)

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

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

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, der die Farbe und Struktur des gezeichneten Texts bestimmt.

point
PointF

PointF-Struktur, die die obere linke Ecke des gezeichneten Textes angibt.

Ausnahmen

brush ist null.

- oder -

s ist null.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

  • Erstellt eine zu zeichnende Textzeichenfolge.

  • Definiert die Schriftart als Arial (16pt).

  • Erstellt einen durchgehenden schwarzen Pinsel zum Zeichnen.

  • 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

Zeichnet die angegebene Textzeichenfolge in dem angegebenen Rechteck mit dem angegebenen Brush-Objekt und dem angegebenen Font-Objekt.

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, der die Farbe und Struktur des gezeichneten Texts bestimmt.

layoutRectangle
RectangleF

RectangleF-Struktur, die die Position des gezeichneten Textes angibt.

Hinweise

Der durch den s Parameter dargestellte Text wird innerhalb des Rechtecks gezeichnet, das durch den layoutRectangle Parameter dargestellt wird. Wenn der Text nicht in das Rechteck passt, wird er beim nächsten Wort abgeschnitten. Um die Zeichenfolge im Rechteck weiter zu bearbeiten, verwenden Sie die Überladung, die DrawString(ReadOnlySpan<Char>, Font, Brush, RectangleF, StringFormat) einen StringFormatbenötigt.

Gilt für:

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

Quelle:
Graphics.cs
Quelle:
Graphics.cs

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

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, der die Farbe und Struktur des gezeichneten Texts bestimmt.

point
PointF

PointF-Struktur, die die obere linke Ecke des gezeichneten Textes angibt.

Gilt für:

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

Quelle:
Graphics.cs
Quelle:
Graphics.cs

Zeichnet die angegebene Zeichenfolge im angegebenen Rechteck mit dem angegebenen Brush-Objekt und dem angegebenen Font-Objekt unter Verwendung der Formatierungsattribute vom 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, der die Farbe und Struktur des gezeichneten Texts bestimmt.

layoutRectangle
RectangleF

RectangleF-Struktur, die die Position des gezeichneten Textes angibt.

format
StringFormat

StringFormat, das die Formatierungsattribute angibt, die auf den gezeichneten Text angewendet werden, z. B. Zeilenabstand und Ausrichtung.

Gilt für: