Graphics.DrawString Метод

Определение

Создает указываемую текстовую строку в заданном месте с помощью определяемых объектов Brush и Font.Draws the specified text string at the specified location with the specified Brush and Font objects.

Перегрузки

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

Рисует заданную текстовую строку в заданном месте с помощью определяемых объектов Brush и Font, используя атрибуты форматирования заданного формата StringFormat.Draws the specified text string at the specified location with the specified Brush and Font objects using the formatting attributes of the specified StringFormat.

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

Рисует заданную текстовую строку в заданном прямоугольнике с помощью определяемых объектов Brush и Font, используя атрибуты форматирования заданного формата StringFormat.Draws the specified text string in the specified rectangle with the specified Brush and Font objects using the formatting attributes of the specified StringFormat.

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

Создает указываемую текстовую строку в заданном месте с помощью определяемых объектов Brush и Font.Draws the specified text string at the specified location with the specified Brush and Font objects.

DrawString(String, Font, Brush, RectangleF)

Рисует заданную текстовую строку в указанном прямоугольнике с помощью определяемых объектов Brush и Font.Draws the specified text string in the specified rectangle with the specified Brush and Font objects.

DrawString(String, Font, Brush, PointF)

Создает указываемую текстовую строку в заданном месте с помощью определяемых объектов Brush и Font.Draws the specified text string at the specified location with the specified Brush and Font objects.

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

Рисует заданную текстовую строку в заданном месте с помощью определяемых объектов Brush и Font, используя атрибуты форматирования заданного формата StringFormat.Draws the specified text string at the specified location with the specified Brush and Font objects using the formatting attributes of the specified StringFormat.

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

Рисует заданную текстовую строку в заданном месте с помощью определяемых объектов Brush и Font, используя атрибуты форматирования заданного формата StringFormat.Draws the specified text string at the specified location with the specified Brush and Font objects using the formatting attributes of the specified 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);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * single * single * System.Drawing.StringFormat -> unit

Параметры

s
String

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

font
Font

Объект Font, определяющий формат текстовой строки.Font that defines the text format of the string.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.Brush that determines the color and texture of the drawn text.

x
Single

Координата X верхнего левого угла отображаемого текста.The x-coordinate of the upper-left corner of the drawn text.

y
Single

Координата Y верхнего левого угла отображаемого текста.The y-coordinate of the upper-left corner of the drawn text.

format
StringFormat

Объект StringFormat, определяющий атрибуты форматирования, такие как междустрочный интервал и выравнивание, которые применяются к создаваемому тексту.StringFormat that specifies formatting attributes, such as line spacing and alignment, that are applied to the drawn text.

Исключения

Свойство brush имеет значение null.brush is null.

- или --or- snull.s is null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgs e, что Paint является параметром обработчика событий.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает текстовую строку для рисования.Creates a text string to draw.

  • Определяет шрифт как Arial (16pt).Defines the font as Arial (16pt).

  • Создает сплошную черную кисть для рисования.Creates a solid, black brush to draw with.

  • Создает координаты точки для левого верхнего угла рисования текста.Creates the coordinates of a point for the upper-left corner at which to draw the text.

  • Задает формат строки для вертикального рисованияSets the format of the string to draw vertically

  • Отображает строку на экране, используя шрифт, кисть, конечную точку и формат.Draws the string to the screen using the font, brush, destination point, and format.

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(String, Font, Brush, RectangleF, StringFormat)

Рисует заданную текстовую строку в заданном прямоугольнике с помощью определяемых объектов Brush и Font, используя атрибуты форматирования заданного формата StringFormat.Draws the specified text string in the specified rectangle with the specified Brush and Font objects using the formatting attributes of the specified 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);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * System.Drawing.RectangleF * System.Drawing.StringFormat -> unit

Параметры

s
String

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

font
Font

Объект Font, определяющий формат текстовой строки.Font that defines the text format of the string.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.Brush that determines the color and texture of the drawn text.

layoutRectangle
RectangleF

Структура RectangleF, которая задает место расположения создаваемого текста.RectangleF structure that specifies the location of the drawn text.

format
StringFormat

Объект StringFormat, определяющий атрибуты форматирования, такие как междустрочный интервал и выравнивание, которые применяются к создаваемому тексту.StringFormat that specifies formatting attributes, such as line spacing and alignment, that are applied to the drawn text.

Исключения

brushnull.brush is null.

-или--or- Свойство s имеет значение null.s is null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgs e, что Paint является параметром обработчика событий.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает текстовую строку для рисования.Creates a text string to draw.

  • Определяет шрифт как Arial (16pt).Defines the font as Arial (16pt).

  • Создает сплошную черную кисть для рисования.Creates a solid, black brush to draw with.

  • Создает прямоугольник, в котором будет нарисован текст.Creates a rectangle in which to draw the text.

  • Отображает прямоугольник на экране.Draws the rectangle to the screen.

  • Задает формат строки для ее центрирования внутри прямоугольника.Sets the format of the string to center it within the rectangle.

  • Отображает строку на экране с помощью шрифта, кисти и прямоугольника назначения.Draws the string to the screen using the font, brush, and destination rectangle.

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 параметром.The text represented by the s parameter is drawn inside the rectangle represented by the layoutRectangle parameter. Если текст не умещается внутри прямоугольника, он усекается в ближайшее слово, если не указано иное с помощью format параметра.If the text does not fit inside the rectangle, it is truncated at the nearest word, unless otherwise specified with the format parameter.

Дополнительно

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

Создает указываемую текстовую строку в заданном месте с помощью определяемых объектов Brush и Font.Draws the specified text string at the specified location with the specified Brush and Font objects.

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);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * single * single -> unit

Параметры

s
String

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

font
Font

Объект Font, определяющий формат текстовой строки.Font that defines the text format of the string.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.Brush that determines the color and texture of the drawn text.

x
Single

Координата X верхнего левого угла отображаемого текста.The x-coordinate of the upper-left corner of the drawn text.

y
Single

Координата Y верхнего левого угла отображаемого текста.The y-coordinate of the upper-left corner of the drawn text.

Исключения

Свойство brush имеет значение null.brush is null.

- или --or- Свойство s имеет значение null.s is null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgs e, что Paint является параметром обработчика событий.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает текстовую строку для рисования.Creates a text string to draw.

  • Определяет шрифт как Arial (16pt).Defines the font as Arial (16pt).

  • Создает сплошную черную кисть для рисования.Creates a solid black brush to draw with.

  • Создает точку для левого верхнего угла рисования текста.Creates a point for the upper-left corner at which to draw the text.

  • Отображает строку на экране, используя шрифт, кисть и конечную точку.Draws the string to the screen using the font, brush, and destination point.

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)

Рисует заданную текстовую строку в указанном прямоугольнике с помощью определяемых объектов Brush и Font.Draws the specified text string in the specified rectangle with the specified Brush and Font objects.

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);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * System.Drawing.RectangleF -> unit

Параметры

s
String

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

font
Font

Объект Font, определяющий формат текстовой строки.Font that defines the text format of the string.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.Brush that determines the color and texture of the drawn text.

layoutRectangle
RectangleF

Структура RectangleF, которая задает место расположения создаваемого текста.RectangleF structure that specifies the location of the drawn text.

Исключения

Свойство brush имеет значение null.brush is null.

- или --or- Свойство s имеет значение null.s is null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgs e, что Paint является параметром обработчика событий.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает текстовую строку для рисования.Creates a text string to draw.

  • Определяет шрифт как Arial (16pt).Defines the font as Arial (16pt).

  • Создает сплошную черную кисть для рисования.Creates a solid, black brush to draw with.

  • Создает прямоугольник, в котором будет нарисован текст.Creates a rectangle in which to draw the text.

  • Отображает прямоугольник на экране.Draws the rectangle to the screen.

  • Отображает строку на экране с помощью шрифта, кисти и прямоугольника назначения.Draws the string to the screen using the font, brush, and destination rectangle.

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 параметром.The text represented by the s parameter is drawn inside the rectangle represented by the layoutRectangle parameter. Если текст не умещается внутри прямоугольника, он усекается в ближайшее слово.If the text does not fit inside the rectangle, it is truncated at the nearest word. Для дальнейшего управления отображением строки внутри прямоугольника используйте DrawString перегрузку, которая StringFormatпринимает.To further manipulate how the string is drawn inside the rectangle use the DrawString overload that takes a StringFormat.

Дополнительно

DrawString(String, Font, Brush, PointF)

Создает указываемую текстовую строку в заданном месте с помощью определяемых объектов Brush и Font.Draws the specified text string at the specified location with the specified Brush and Font objects.

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);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * System.Drawing.PointF -> unit

Параметры

s
String

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

font
Font

Объект Font, определяющий формат текстовой строки.Font that defines the text format of the string.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.Brush that determines the color and texture of the drawn text.

point
PointF

Структура PointF, задающая верхний левый угол создаваемого текста.PointF structure that specifies the upper-left corner of the drawn text.

Исключения

brushnull.brush is null.

- или --or- snull.s is null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgs e, что Paint является параметром обработчика событий.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает текстовую строку для рисования.Creates a text string to draw.

  • Определяет шрифт как Arial (16pt).Defines the font as Arial (16pt).

  • Создает сплошную черную кисть для рисования.Creates a solid, black brush to draw with.

  • Создает точку для левого верхнего угла рисования текста.Creates a point for the upper-left corner at which to draw the text.

  • Отображает строку на экране, используя шрифт, кисть и конечную точку.Draws the string to the screen using the font, brush, and destination point.

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(String, Font, Brush, PointF, StringFormat)

Рисует заданную текстовую строку в заданном месте с помощью определяемых объектов Brush и Font, используя атрибуты форматирования заданного формата StringFormat.Draws the specified text string at the specified location with the specified Brush and Font objects using the formatting attributes of the specified 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);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * System.Drawing.PointF * System.Drawing.StringFormat -> unit

Параметры

s
String

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

font
Font

Объект Font, определяющий формат текстовой строки.Font that defines the text format of the string.

brush
Brush

Объект Brush, определяющий цвет и текстуру создаваемого текста.Brush that determines the color and texture of the drawn text.

point
PointF

Структура PointF, задающая верхний левый угол создаваемого текста.PointF structure that specifies the upper-left corner of the drawn text.

format
StringFormat

Объект StringFormat, определяющий атрибуты форматирования, такие как междустрочный интервал и выравнивание, которые применяются к создаваемому тексту.StringFormat that specifies formatting attributes, such as line spacing and alignment, that are applied to the drawn text.

Исключения

Свойство brush имеет значение null.brush is null.

-или--or- Свойство s имеет значение null.s is null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgs e, что Paint является параметром обработчика событий.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает текстовую строку для рисования.Creates a text string to draw.

  • Определяет шрифт как Arial (16pt).Defines the font as Arial (16pt).

  • Создает сплошную черную кисть для рисования.Creates a solid, black brush to draw with.

  • Создает точку для левого верхнего угла рисования текста.Creates a point for the upper-left corner at which to draw the text.

  • Задает формат строки для вертикального рисования.Sets the format of the string to draw vertically.

  • Отображает строку на экране, используя шрифт, кисть, конечную точку и формат.Draws the string to the screen using the font, brush, destination point, and format.

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

Дополнительно

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