TextRenderer.DrawText Метод

Ссылка

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Прорисовывает указываемый текст в заданном месте, используя задаваемые значения контекста устройства, цвета и шрифта.

Перегрузки

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)	Прорисовывает указываемый текст в заданном месте, используя задаваемые значения контекста устройства, шрифта и цвета.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)	Прорисовывает указываемый текст в заданных границах, используя задаваемые значения контекста устройства, шрифта, цвета, цвета фона и инструкции форматирования.
DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)	Отрисовывает указанный текст в заданном месте, используя указанные контекст устройства, шрифт, цвет, цвет фона и инструкции по форматированию.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)	Отрисовывает указанный текст в заданном месте, используя указанные контекст устройства, шрифт, цвет, цвет фона и инструкции по форматированию.
DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)	Прорисовывает указываемый текст в заданных границах, используя задаваемые значения контекста устройства, шрифта, цвета и инструкции форматирования.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)	Прорисовывает указываемый текст в заданных границах, используя задаваемые значения контекста устройства, шрифта, цвета и цвета фона.
DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)	Прорисовывает указываемый текст в заданном месте, используя задаваемые значения контекста устройства, шрифта, цвета и инструкции форматирования.
DrawText(IDeviceContext, String, Font, Point, Color, Color)	Прорисовывает указываемый текст в заданном месте, используя задаваемые значения контекста устройства, шрифта, цвета и цвета фона.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)	Прорисовывает указываемый текст в заданных границах, используя задаваемые значения контекста устройства, шрифта, цвета, цвета фона и инструкции форматирования.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)	Прорисовывает указываемый текст в заданных границах, используя задаваемые значения контекста устройства, шрифта, цвета и цвета фона.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)	Прорисовывает указываемый текст в заданном месте, используя задаваемые значения контекста устройства, шрифта, цвета и инструкции форматирования.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)	Прорисовывает указываемый текст в заданном месте, используя задаваемые значения контекста устройства, шрифта, цвета и цвета фона.
DrawText(IDeviceContext, String, Font, Rectangle, Color)	Прорисовывает указываемый текст в заданных границах, используя задаваемые значения контекста устройства, шрифта и цвета.
DrawText(IDeviceContext, String, Font, Point, Color)	Прорисовывает указываемый текст в заданном месте, используя задаваемые значения контекста устройства, шрифта и цвета.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)	Прорисовывает указываемый текст в заданных границах, используя задаваемые значения контекста устройства, шрифта и цвета.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, TextFormatFlags)	Прорисовывает указываемый текст в заданных границах, используя задаваемые значения контекста устройства, шрифта, цвета и инструкции форматирования.

Отрисовка текста, предлагаемая классом TextRenderer , основана на отрисовке текста GDI и не поддерживается для печати из Windows Forms. Вместо этого используйте DrawString методы Graphics класса .

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)

Прорисовывает указываемый текст в заданном месте, используя задаваемые значения контекста устройства, шрифта и цвета.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, pt As Point, foreColor As Color)

Параметры

dc: IDeviceContext

Контекст устройства, в котором следует отобразить текст.

text: ReadOnlySpan<Char>

Текст для отрисовки.

font: Font

Объект Font для применения к отображаемому тексту.

pt: Point

Объект Point, представляющий верхний левый угол отображаемого текста.

foreColor: Color

Объект Color для применения к отображаемому тексту.

Исключения

ArgumentNullException

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

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

DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)

Прорисовывает указываемый текст в заданных границах, используя задаваемые значения контекста устройства, шрифта, цвета, цвета фона и инструкции форматирования.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, bounds As Rectangle, foreColor As Color, backColor As Color, flags As TextFormatFlags)

Параметры

dc: IDeviceContext

Контекст устройства, в котором следует отобразить текст.

text: String

Текст для отрисовки.

font: Font

Объект Font для применения к отображаемому тексту.

bounds: Rectangle

Объект Rectangle, представляющий границы текста.

foreColor: Color

Объект Color, применяемый к тексту.

backColor: Color

Объект Color для применения к области, представленной параметром bounds.

flags: TextFormatFlags

Поразрядное сочетание значений TextFormatFlags.

Исключения

ArgumentNullException

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

Примеры

В следующем примере кода показано, как использовать метод DrawText. Чтобы выполнить этот пример, вставьте код в Форму Windows Form и вызовите RenderText8 из обработчика Paint событий формы, передавая e как PaintEventArgs.

private void RenderText8(PaintEventArgs e)
{
    TextFormatFlags flags = TextFormatFlags.Bottom | TextFormatFlags.WordBreak;
    TextRenderer.DrawText(e.Graphics, "This is some text that will display on multiple lines.", this.Font,
        new Rectangle(10, 10, 100, 50), SystemColors.ControlText, SystemColors.ControlDark, flags);
}

Private Sub RenderText8(ByVal e As PaintEventArgs)
    Dim flags As TextFormatFlags = _
        TextFormatFlags.Bottom Or TextFormatFlags.WordBreak
    TextRenderer.DrawText(e.Graphics, _
        "This is some text that will display on multiple lines.", _
        Me.Font, New Rectangle(10, 10, 100, 50), _
        SystemColors.ControlText, SystemColors.ControlDark, flags)

End Sub

Параметр backcolor применяется к области в параметре bounds. , если font, forecolor или backcolor имеет значение null или Emptyсоответственно; DrawText метод будет рисовать текст шрифтом или цветом, выбранным в настоящее время в контексте устройства, заданном параметром dc. Если forecolor имеет значение Transparent, текст не будет нарисован.

Управлять прорисовкой текста можно с помощью одной из перегрузок метода DrawText, принимающей параметр TextFormatFlags. Например, поведение класса TextRenderer по умолчанию предполагает добавление внутренних полей в ограничивающий прямоугольник отображаемого текста с целью вместить в этот прямоугольник части глифов, выступающие за его границы. Если требуется прорисовать строку текста без этих дополнительных областей, следует использовать версии методов DrawText и MeasureText, которые принимают объект Size и параметр TextFormatFlags. Пример см. в разделе MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

TextRenderer не поддерживает добавление позиций табуляции для рисуемого текста, однако существующие позиции табуляции можно расширить с помощью флага ExpandTabs.

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

DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)

Отрисовывает указанный текст в заданном месте, используя указанные контекст устройства, шрифт, цвет, цвет фона и инструкции по форматированию.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, pt As Point, foreColor As Color, backColor As Color, flags As TextFormatFlags)

Параметры

dc: IDeviceContext

Контекст устройства, в котором следует отобразить текст.

text: String

Текст для отрисовки.

font: Font

Объект Font для применения к отображаемому тексту.

pt: Point

Объект Point, представляющий верхний левый угол отображаемого текста.

foreColor: Color

Объект Color, применяемый к тексту.

backColor: Color

Объект Color для применения к области фона прорисовываемого текста.

flags: TextFormatFlags

Поразрядное сочетание значений TextFormatFlags.

Исключения

ArgumentNullException

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

Примеры

В следующем примере кода показано, как использовать метод DrawText. Чтобы выполнить этот пример, вставьте код в Форму Windows Form и вызовите RenderText7 из обработчика Paint событий формы, передавая e как PaintEventArgs.

private void RenderText7(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "This is some text.", this.Font,
        new Point(10, 10), Color.White, Color.SteelBlue, TextFormatFlags.Default);
}

Private Sub RenderText7(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "This is some text.", _
        Me.Font, New Point(10, 10), Color.White, Color.SteelBlue, _
        TextFormatFlags.Default)

End Sub

Параметр backcolor применяется к прямоугольной области, содержащей нарисованный текст. Если font или forecolor имеет значение null или Empty, соответственно, DrawText метод будет рисовать текст в шрифте или цвете, выбранном в настоящее время в контексте устройства, заданном параметром dc. Если forecolor имеет значение Transparent, текст не будет нарисован.

Примечание

Методы DrawText , указывающие в Point качестве левого верхнего угла нарисованного текста, неправильно отображаются в Windows 2000. Если приложение предназначено для использования на компьютерах под управлением Windows 2000, следует использовать один из DrawText методов, указывающих Rectangle для границ нарисованного текста.

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

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, pt As Point, foreColor As Color, backColor As Color, flags As TextFormatFlags)

Параметры

dc: IDeviceContext

Контекст устройства, в котором следует отобразить текст.

text: ReadOnlySpan<Char>

Текст для отрисовки.

font: Font

Объект Font для применения к отображаемому тексту.

pt: Point

Объект Point, представляющий верхний левый угол отображаемого текста.

foreColor: Color

Объект Color для применения к отображаемому тексту.

backColor: Color

Объект Color для применения к области фона прорисовываемого текста.

flags: TextFormatFlags

Поразрядное сочетание значений TextFormatFlags.

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

Свойство ModifyString задано.

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

DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)

Прорисовывает указываемый текст в заданных границах, используя задаваемые значения контекста устройства, шрифта, цвета и инструкции форматирования.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, bounds As Rectangle, foreColor As Color, flags As TextFormatFlags)

Параметры

dc: IDeviceContext

Контекст устройства, в котором следует отобразить текст.

text: String

Текст для отрисовки.

font: Font

Объект Font для применения к отображаемому тексту.

bounds: Rectangle

Объект Rectangle, представляющий границы текста.

foreColor: Color

Объект Color для применения к отображаемому тексту.

flags: TextFormatFlags

Поразрядное сочетание значений TextFormatFlags.

Исключения

ArgumentNullException

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

Примеры

В следующем примере кода показано, как использовать метод DrawText. Чтобы выполнить этот пример, вставьте код в Форму Windows Form и вызовите RenderText6 из обработчика Paint событий формы, передавая e как PaintEventArgs.

private void RenderText6(PaintEventArgs e)
{
    TextFormatFlags flags = TextFormatFlags.Bottom | TextFormatFlags.EndEllipsis;
    TextRenderer.DrawText(e.Graphics, "This is some text that will be clipped at the end.", this.Font,
        new Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags);
}

Private Sub RenderText6(ByVal e As PaintEventArgs)
    Dim flags As TextFormatFlags = TextFormatFlags.Bottom Or _
        TextFormatFlags.EndEllipsis
    TextRenderer.DrawText(e.Graphics, _
    "This is some text that will be clipped at the end.", _
    Me.Font, New Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags)

End Sub

Если font или color имеет значение null или Empty, соответственно, DrawText метод будет рисовать текст в шрифте или цвете, выбранном в настоящее время в контексте устройства, заданном параметром dc. Если forecolor имеет значение Transparent, текст не будет нарисован.

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

DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)

Прорисовывает указываемый текст в заданных границах, используя задаваемые значения контекста устройства, шрифта, цвета и цвета фона.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Drawing::Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, bounds As Rectangle, foreColor As Color, backColor As Color)

Параметры

dc: IDeviceContext

Контекст устройства, в котором следует отобразить текст.

text: String

Текст для отрисовки.

font: Font

Объект Font для применения к отображаемому тексту.

bounds: Rectangle

Объект Rectangle, представляющий границы текста.

foreColor: Color

Объект Color для применения к отображаемому тексту.

backColor: Color

Объект Color для применения к области, представленной параметром bounds.

Исключения

ArgumentNullException

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

Примеры

В следующем примере кода показано, как использовать метод DrawText. Чтобы выполнить этот пример, вставьте код в Форму Windows Form и вызовите RenderText4 из обработчика Paint событий формы, передавая e как PaintEventArgs.

private void RenderText4(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text.", this.Font,
        new Rectangle(10, 10, 70, 70), SystemColors.ControlText, 
        SystemColors.ControlDark);
}

Private Sub RenderText4(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Regular Text.", _
        Me.Font, New Rectangle(10, 10, 70, 70), _
        SystemColors.ControlText, SystemColors.ControlDark)

End Sub

Параметр backColor применяется к области в параметре bounds . Если font, backcolor или forecolor имеет значение null или Emptyсоответственно, DrawText метод будет рисовать текст шрифтом или цветом, выбранным в данный момент в контексте устройства, заданном параметром dc. Если forecolor имеет значение Transparent, текст не будет нарисован.

Этот метод возвращает текст, расположенный по горизонтали и вертикали по центру в прямоугольнике, заданном параметром bounds . Чтобы изменить способ рисования текста, используйте версию DrawText , которая принимает TextFormatFlags тип параметра.

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

DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)

Прорисовывает указываемый текст в заданном месте, используя задаваемые значения контекста устройства, шрифта, цвета и инструкции форматирования.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, pt As Point, foreColor As Color, flags As TextFormatFlags)

Параметры

dc: IDeviceContext

Контекст устройства, в котором следует отобразить текст.

text: String

Текст для отрисовки.

font: Font

Объект Font для применения к отображаемому тексту.

pt: Point

Объект Point, представляющий верхний левый угол отображаемого текста.

foreColor: Color

Объект Color для применения к отображаемому тексту.

flags: TextFormatFlags

Поразрядное сочетание значений TextFormatFlags.

Исключения

ArgumentNullException

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

Примеры

В следующем примере кода показано, как использовать метод DrawText. Чтобы выполнить этот пример, вставьте код в Форму Windows Form и вызовите RenderText5 из обработчика Paint событий формы, передавая e как PaintEventArgs.

private void RenderText5(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Some text.",
        this.Font, new Point(10, 10), SystemColors.ControlText, TextFormatFlags.Bottom);
}

Private Sub RenderText5(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Some text.", _
    Me.Font, New Point(10, 10), SystemColors.ControlText, _
    TextFormatFlags.Bottom)

End Sub

Параметр backColor применяется к области в параметре bounds . Если font или forecolor имеет значение null или Color.Empty, соответственно, DrawText метод будет рисовать текст в шрифте или цвете, выбранном в настоящее время в контексте устройства, заданном параметром dc. Если forecolor имеет значение Transparent, текст не будет нарисован.

Примечание

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

DrawText(IDeviceContext, String, Font, Point, Color, Color)

Прорисовывает указываемый текст в заданном месте, используя задаваемые значения контекста устройства, шрифта, цвета и цвета фона.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Drawing::Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, pt As Point, foreColor As Color, backColor As Color)

Параметры

dc: IDeviceContext

Контекст устройства, в котором следует отобразить текст.

text: String

Текст для отрисовки.

font: Font

Объект Font для применения к отображаемому тексту.

pt: Point

Объект Point, представляющий верхний левый угол отображаемого текста.

foreColor: Color

Объект Color для применения к отображаемому тексту.

backColor: Color

Объект Color для применения к области фона прорисовываемого текста.

Исключения

ArgumentNullException

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

Примеры

В следующем примере кода показано, как использовать метод DrawText. Чтобы выполнить этот пример, вставьте код в Форму Windows Form и вызовите RenderText3 из обработчика Paint событий формы, передавая e как PaintEventArgs.

private void RenderText3(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text", this.Font,
        new Point(10, 10), Color.Red, Color.PowderBlue);
}

Private Sub RenderText3(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Regular Text", Me.Font, _
        New Point(10, 10), Color.Red, Color.PowderBlue)

End Sub

Параметр backColor применяется к прямоугольной области, содержащей нарисованный текст. Если font, backcolor или forecolor имеет значение null или Color.Emptyсоответственно, DrawText метод будет рисовать текст шрифтом или цветом, выбранным в данный момент в контексте устройства, заданном параметром dc. Если forecolor имеет значение Transparent, текст не будет нарисован.

Управлять прорисовкой текста можно с помощью одной из перегрузок метода DrawText, принимающей параметр TextFormatFlags.

Примечание

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

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, bounds As Rectangle, foreColor As Color, backColor As Color, flags As TextFormatFlags)

Параметры

dc: IDeviceContext

Контекст устройства, в котором следует отобразить текст.

text: ReadOnlySpan<Char>

Текст для отрисовки.

font: Font

Объект Font для применения к отображаемому тексту.

bounds: Rectangle

Объект Rectangle, представляющий границы текста.

foreColor: Color

Объект Color для применения к отображаемому тексту.

backColor: Color

Объект Color для применения к области фона прорисовываемого текста.

flags: TextFormatFlags

Поразрядное сочетание значений TextFormatFlags.

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

Свойство ModifyString задано.

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

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Drawing::Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, bounds As Rectangle, foreColor As Color, backColor As Color)

Параметры

dc: IDeviceContext

Контекст устройства, в котором следует отобразить текст.

text: ReadOnlySpan<Char>

Текст для отрисовки.

font: Font

Объект Font для применения к отображаемому тексту.

bounds: Rectangle

Объект Rectangle, представляющий границы текста.

foreColor: Color

Объект Color для применения к отображаемому тексту.

backColor: Color

Объект Color для применения к области фона прорисовываемого текста.

Исключения

ArgumentNullException

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

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

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, pt As Point, foreColor As Color, flags As TextFormatFlags)

Параметры

dc: IDeviceContext

Контекст устройства, в котором следует отобразить текст.

text: ReadOnlySpan<Char>

Текст для отрисовки.

font: Font

Объект Font для применения к отображаемому тексту.

pt: Point

Объект Point, представляющий верхний левый угол отображаемого текста.

foreColor: Color

Объект Color для применения к отображаемому тексту.

flags: TextFormatFlags

Поразрядное сочетание значений TextFormatFlags.

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

Свойство ModifyString задано.

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

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Drawing::Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, pt As Point, foreColor As Color, backColor As Color)

Параметры

dc: IDeviceContext

Контекст устройства, в котором следует отобразить текст.

text: ReadOnlySpan<Char>

Текст для отрисовки.

font: Font

Объект Font для применения к отображаемому тексту.

pt: Point

Объект Point, представляющий верхний левый угол отображаемого текста.

foreColor: Color

Объект Color для применения к отображаемому тексту.

backColor: Color

Объект Color для применения к области фона прорисовываемого текста.

Исключения

ArgumentNullException

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

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

DrawText(IDeviceContext, String, Font, Rectangle, Color)

Прорисовывает указываемый текст в заданных границах, используя задаваемые значения контекста устройства, шрифта и цвета.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, bounds As Rectangle, foreColor As Color)

Параметры

dc: IDeviceContext

Контекст устройства, в котором следует отобразить текст.

text: String

Текст для отрисовки.

font: Font

Объект Font для применения к отображаемому тексту.

bounds: Rectangle

Объект Rectangle, представляющий границы текста.

foreColor: Color

Объект Color для применения к отображаемому тексту.

Исключения

ArgumentNullException

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

Примеры

В следующем примере кода показано, как использовать метод DrawText. Чтобы выполнить этот пример, вставьте код в Форму Windows Form и вызовите RenderText2 из обработчика Paint событий формы, передавая e как PaintEventArgs.

private void RenderText2(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text", this.Font,
        new Rectangle(10, 10, 100, 100), SystemColors.ControlText);
}

Private Sub RenderText2(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Regular Text", _
        Me.Font, New Rectangle(10, 10, 100, 100), _
        SystemColors.ControlText)

End Sub

Если font или forecolor имеет значение null или Color.Empty, соответственно, DrawText метод будет рисовать текст в шрифте или цвете, выбранном в настоящее время в контексте устройства, заданном параметром dc. Если forecolor имеет значение Transparent, текст не будет нарисован.

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

IDeviceContext

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

DrawText(IDeviceContext, String, Font, Point, Color)

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, pt As Point, foreColor As Color)

Параметры

dc: IDeviceContext

Контекст устройства, в котором следует отобразить текст.

text: String

Текст для отрисовки.

font: Font

Объект Font для применения к отображаемому тексту.

pt: Point

Объект Point, представляющий верхний левый угол отображаемого текста.

foreColor: Color

Объект Color для применения к отображаемому тексту.

Исключения

ArgumentNullException

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

Примеры

В следующем примере кода показано, как использовать метод DrawText. Чтобы выполнить этот пример, вставьте код в Форму Windows Form и вызовите RenderText1 из обработчика Paint событий формы, передавая e как PaintEventArgs.

private void RenderText1(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text", this.Font, 
        new Point(10, 10), SystemColors.ControlText);
}

Private Sub RenderText1(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Regular Text", _
        Me.Font, New Point(10, 10), SystemColors.ControlText)

End Sub

Если font имеет значение null или forecolor , Color.Empty DrawText метод будет рисовать текст шрифтом или цветом, выбранным в данный момент в контексте устройства, заданном параметром dc. Если forecolor имеет значение Transparent, текст не будет нарисован.

Примечание

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

IDeviceContext

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

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, bounds As Rectangle, foreColor As Color)

Параметры

dc: IDeviceContext

Контекст устройства, в котором следует отобразить текст.

text: ReadOnlySpan<Char>

Текст для отрисовки.

font: Font

Объект Font для применения к отображаемому тексту.

bounds: Rectangle

Объект Rectangle, представляющий границы текста.

foreColor: Color

Объект Color для применения к отображаемому тексту.

Исключения

ArgumentNullException

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

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

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, TextFormatFlags)

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, bounds As Rectangle, foreColor As Color, flags As TextFormatFlags)

Параметры

dc: IDeviceContext

Контекст устройства, в котором следует отобразить текст.

text: ReadOnlySpan<Char>

Текст для отрисовки.

font: Font

Объект Font для применения к отображаемому тексту.

bounds: Rectangle

Объект Rectangle, представляющий границы текста.

foreColor: Color

Объект Color для применения к отображаемому тексту.

flags: TextFormatFlags

Поразрядное сочетание значений TextFormatFlags.

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

Свойство ModifyString задано.

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

TextRenderer.DrawText Метод

Определение

Перегрузки

Комментарии

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)

Параметры

Исключения

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

DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)

Параметры

Исключения

Примеры

Комментарии

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

DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)

Параметры

Исключения

Примеры

Комментарии

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

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)

Параметры

Исключения

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

DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)

Параметры

Исключения

Примеры

Комментарии

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

DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)

Параметры

Исключения

Примеры

Комментарии

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

DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)

Параметры

Исключения

Примеры

Комментарии

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

DrawText(IDeviceContext, String, Font, Point, Color, Color)

Параметры

Исключения

Примеры

Комментарии

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

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)

Параметры

Исключения

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

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)

Параметры

Исключения

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

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)

Параметры

Исключения

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

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)

Параметры

Исключения

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

DrawText(IDeviceContext, String, Font, Rectangle, Color)

Параметры

Исключения

Примеры

Комментарии

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

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

DrawText(IDeviceContext, String, Font, Point, Color)

Параметры

Исключения

Примеры

Комментарии

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

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

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)

Параметры