Graphics.DrawString Метод

Определение

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font.

Перегрузки

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

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font, используя атрибуты форматирования заданного формата StringFormat.

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

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font, используя атрибуты форматирования заданного формата StringFormat.

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

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font.

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

Создает заданную текстовую строку в указанном прямоугольнике с помощью заданных объектов Brush и Font, используя атрибуты форматирования заданного формата StringFormat.

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

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font, используя атрибуты форматирования заданного формата StringFormat.

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

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font.

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

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font, используя атрибуты форматирования заданного формата StringFormat.

DrawString(String, Font, Brush, RectangleF)

Создает заданную текстовую строку в указанном прямоугольнике с помощью заданных объектов Brush и Font.

DrawString(String, Font, Brush, PointF)

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font.

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

Создает заданную текстовую строку в указанном прямоугольнике с помощью заданных объектов Brush и Font.

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

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font.

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

Создает заданную текстовую строку в указанном прямоугольнике с помощью заданных объектов Brush и Font, используя атрибуты форматирования заданного формата StringFormat.

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

Исходный код:
Graphics.cs
Исходный код:
Graphics.cs
Исходный код:
Graphics.cs

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font, используя атрибуты форматирования заданного формата 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)

Параметры

s
String

Строка для рисования.

font
Font

Объект Font, определяющий формат текста строки.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.

x
Single

Координата X верхнего левого угла отображаемого текста.

y
Single

Координата Y верхнего левого угла отображаемого текста.

format
StringFormat

Объект StringFormat, определяющий атрибуты форматирования, такие как межстрочный интервал и выравнивание, которые применяются к создаваемому тексту.

Исключения

brush имеет значение null.

-или-

s имеет значение null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика Paint событий. Код выполняет следующие действия.

  • Создает текстовую строку для рисования.

  • Определяет шрифт как Arial (16 пт).

  • Создает сплошную черную кисть для рисования.

  • Создает координаты точки для левого верхнего угла, в котором будет рисовать текст.

  • Задает формат строки для вертикального рисования

  • Рисует строку на экране с помощью шрифта, кисти, конечной точки и формата.

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

См. также раздел

Применяется к

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

Исходный код:
Graphics.cs
Исходный код:
Graphics.cs

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font, используя атрибуты форматирования заданного формата 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)

Параметры

s
ReadOnlySpan<Char>

Строка для рисования.

font
Font

Объект Font, определяющий формат текста строки.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.

x
Single

Координата X верхнего левого угла отображаемого текста.

y
Single

Координата Y верхнего левого угла отображаемого текста.

format
StringFormat

Объект StringFormat, определяющий атрибуты форматирования, такие как межстрочный интервал и выравнивание, которые применяются к создаваемому тексту.

Применяется к

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

Исходный код:
Graphics.cs
Исходный код:
Graphics.cs
Исходный код:
Graphics.cs

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font.

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)

Параметры

s
String

Строка для рисования.

font
Font

Объект Font, определяющий формат текста строки.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.

x
Single

Координата X верхнего левого угла отображаемого текста.

y
Single

Координата Y верхнего левого угла отображаемого текста.

Исключения

brush имеет значение null.

-или-

s имеет значение null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика Paint событий. Код выполняет следующие действия.

  • Создает текстовую строку для рисования.

  • Определяет шрифт как Arial (16 пт).

  • Создает сплошную черную кисть для рисования.

  • Создает точку для левого верхнего угла, в котором будет рисовать текст.

  • Рисует строку на экране с помощью шрифта, кисти и конечной точки.

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

См. также раздел

Применяется к

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

Исходный код:
Graphics.cs
Исходный код:
Graphics.cs
Исходный код:
Graphics.cs

Создает заданную текстовую строку в указанном прямоугольнике с помощью заданных объектов Brush и Font, используя атрибуты форматирования заданного формата 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)

Параметры

s
String

Строка для рисования.

font
Font

Объект Font, определяющий формат текста строки.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.

layoutRectangle
RectangleF

Структура RectangleF, которая задает расположение создаваемого текста.

format
StringFormat

Объект StringFormat, определяющий атрибуты форматирования, такие как межстрочный интервал и выравнивание, которые применяются к создаваемому тексту.

Исключения

brush имеет значение null.

-или-

s имеет значение null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика Paint событий. Код выполняет следующие действия.

  • Создает текстовую строку для рисования.

  • Определяет шрифт как Arial (16 пт).

  • Создает сплошную черную кисть для рисования.

  • Создает прямоугольник для рисования текста.

  • Рисует прямоугольник на экране.

  • Задает формат строки для выравнивания по центру в прямоугольнике.

  • Рисует строку на экране с помощью шрифта, кисти и прямоугольника назначения.

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

Комментарии

Текст, представленный параметром s , рисуется внутри прямоугольника, представленного параметром layoutRectangle . Если текст не помещается внутри прямоугольника, он усекается в ближайшем слове, если не указано иное с параметром format .

См. также раздел

Применяется к

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

Исходный код:
Graphics.cs
Исходный код:
Graphics.cs
Исходный код:
Graphics.cs

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font, используя атрибуты форматирования заданного формата 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)

Параметры

s
String

Строка для рисования.

font
Font

Объект Font, определяющий формат текста строки.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.

point
PointF

Структура PointF, задающая верхний левый угол создаваемого текста.

format
StringFormat

Объект StringFormat, определяющий атрибуты форматирования, такие как межстрочный интервал и выравнивание, которые применяются к создаваемому тексту.

Исключения

brush имеет значение null.

-или-

s имеет значение null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика Paint событий. Код выполняет следующие действия.

  • Создает текстовую строку для рисования.

  • Определяет шрифт как Arial (16 пт).

  • Создает сплошную черную кисть для рисования.

  • Создает точку для левого верхнего угла, в котором будет рисовать текст.

  • Задает формат строки для вертикального рисования.

  • Рисует строку на экране, используя шрифт, кисть, точку назначения и формат.

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

См. также раздел

Применяется к

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

Исходный код:
Graphics.cs
Исходный код:
Graphics.cs

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font.

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)

Параметры

s
ReadOnlySpan<Char>

Строка для рисования.

font
Font

Объект Font, определяющий формат текста строки.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.

x
Single

Координата X верхнего левого угла отображаемого текста.

y
Single

Координата Y верхнего левого угла отображаемого текста.

Применяется к

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

Исходный код:
Graphics.cs
Исходный код:
Graphics.cs

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font, используя атрибуты форматирования заданного формата 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)

Параметры

s
ReadOnlySpan<Char>

Строка для рисования.

font
Font

Объект Font, определяющий формат текста строки.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.

point
PointF

Структура PointF, задающая верхний левый угол создаваемого текста.

format
StringFormat

Объект StringFormat, определяющий атрибуты форматирования, такие как межстрочный интервал и выравнивание, которые применяются к создаваемому тексту.

Применяется к

DrawString(String, Font, Brush, RectangleF)

Исходный код:
Graphics.cs
Исходный код:
Graphics.cs
Исходный код:
Graphics.cs

Создает заданную текстовую строку в указанном прямоугольнике с помощью заданных объектов Brush и Font.

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)

Параметры

s
String

Строка для рисования.

font
Font

Объект Font, определяющий формат текста строки.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.

layoutRectangle
RectangleF

Структура RectangleF, которая задает расположение создаваемого текста.

Исключения

brush имеет значение null.

-или-

s имеет значение null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика Paint событий. Код выполняет следующие действия.

  • Создает текстовую строку для рисования.

  • Определяет шрифт Arial (16pt).

  • Создает сплошную черную кисть для рисования.

  • Создает прямоугольник для рисования текста.

  • Рисует прямоугольник на экране.

  • Рисует строку на экране с помощью шрифта, кисти и прямоугольника назначения.

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

Комментарии

Текст, представленный параметром , s рисуется внутри прямоугольника, представленного параметром layoutRectangle . Если текст не помещается внутри прямоугольника, он усекается в ближайшем слове. Для дальнейшего управления тем, как строка рисуется внутри прямоугольника, используйте перегрузкуDrawString, которая принимает .StringFormat

См. также раздел

Применяется к

DrawString(String, Font, Brush, PointF)

Исходный код:
Graphics.cs
Исходный код:
Graphics.cs
Исходный код:
Graphics.cs

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font.

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)

Параметры

s
String

Строка для рисования.

font
Font

Объект Font, определяющий формат текста строки.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.

point
PointF

Структура PointF, задающая верхний левый угол создаваемого текста.

Исключения

brush имеет значение null.

-или-

s имеет значение null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика Paint событий. Код выполняет следующие действия.

  • Создает текстовую строку для рисования.

  • Определяет шрифт Arial (16pt).

  • Создает сплошную черную кисть для рисования.

  • Создает точку для левого верхнего угла, в котором будет рисовать текст.

  • Рисует строку на экране с помощью шрифта, кисти и точки назначения.

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

См. также раздел

Применяется к

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

Исходный код:
Graphics.cs
Исходный код:
Graphics.cs

Создает заданную текстовую строку в указанном прямоугольнике с помощью заданных объектов Brush и Font.

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)

Параметры

s
ReadOnlySpan<Char>

Строка для рисования.

font
Font

Объект Font, определяющий формат текста строки.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.

layoutRectangle
RectangleF

Структура RectangleF, которая задает расположение создаваемого текста.

Комментарии

Текст, представленный параметром , s рисуется внутри прямоугольника, представленного параметром layoutRectangle . Если текст не помещается внутри прямоугольника, он усекается в ближайшем слове. Для дальнейшего управления тем, как строка рисуется внутри прямоугольника, используйте перегрузкуDrawString(ReadOnlySpan<Char>, Font, Brush, RectangleF, StringFormat), которая принимает .StringFormat

Применяется к

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

Исходный код:
Graphics.cs
Исходный код:
Graphics.cs

Создает заданную текстовую строку в указанном месте с помощью заданных объектов Brush и Font.

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)

Параметры

s
ReadOnlySpan<Char>

Строка для рисования.

font
Font

Объект Font, определяющий формат текста строки.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.

point
PointF

Структура PointF, задающая верхний левый угол создаваемого текста.

Применяется к

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

Исходный код:
Graphics.cs
Исходный код:
Graphics.cs

Создает заданную текстовую строку в указанном прямоугольнике с помощью заданных объектов Brush и Font, используя атрибуты форматирования заданного формата 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)

Параметры

s
ReadOnlySpan<Char>

Строка для рисования.

font
Font

Объект Font, определяющий формат текста строки.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.

layoutRectangle
RectangleF

Структура RectangleF, которая задает расположение создаваемого текста.

format
StringFormat

Объект StringFormat, определяющий атрибуты форматирования, такие как межстрочный интервал и выравнивание, которые применяются к создаваемому тексту.

Применяется к