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)

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

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

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

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

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

Рисует указанный текст в указанном расположении с помощью указанного контекста устройства, шрифта и цвета.

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)

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

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

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

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

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

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

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 и вызовите 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 параметре. If fontили forecolorbackcolornullEmpty , соответственно, 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)

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

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

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

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

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

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

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 и вызовите 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 есть nullEmptyили, соответственно, DrawText метод рисует текст в шрифте или цвете, выбранном в контексте устройства, заданном.dc Если forecolor это Transparentтак, текст не будет вырисовываться.

Note

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

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

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

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

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

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

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

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

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 имеет значение set.

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

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

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

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

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

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

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

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

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 и вызовите 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 есть nullEmptyили, соответственно, DrawText метод рисует текст в шрифте или цвете, выбранном в контексте устройства, заданном.dc Если forecolor это Transparentтак, текст не будет вырисовываться.

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

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

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

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

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

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

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

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

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 и вызовите 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 или forecolornullEmpty, соответственно, DrawText метод рисует текст в шрифте или цвете, выбранном в контексте устройства, заданном.dc Если forecolor это Transparentтак, текст не будет вырисовываться.

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

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

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

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

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

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

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

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

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

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 и вызовите 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 есть nullColor.Emptyили, соответственно, DrawText метод рисует текст в шрифте или цвете, выбранном в контексте устройства, заданном.dc Если forecolor это Transparentтак, текст не будет вырисовываться.

Note

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

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

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

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

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

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

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

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

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 и вызовите 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 или forecolornullColor.Empty, соответственно, DrawText метод рисует текст в шрифте или цвете, выбранном в контексте устройства, заданном.dc Если forecolor это Transparentтак, текст не будет вырисовываться.

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

Note

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

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

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

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

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

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

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

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 имеет значение set.

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

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

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

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

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

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

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

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)

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

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

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

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

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

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 имеет значение set.

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

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

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

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

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

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

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

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)

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

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

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

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

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

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

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 и вызовите 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 есть nullColor.Emptyили, соответственно, DrawText метод рисует текст в шрифте или цвете, выбранном в контексте устройства, заданном.dc Если forecolor это Transparentтак, текст не будет вырисовываться.

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

IDeviceContext

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

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

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

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

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

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

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

Рисует указанный текст в указанном расположении с помощью указанного контекста устройства, шрифта и цвета.

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 и вызовите 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 естьforecolorColor.Empty, DrawText метод рисует текст в шрифте или цвете, выбранном в контексте устройства, заданном.dc Если forecolor это Transparentтак, текст не будет вырисовываться.

Note

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

IDeviceContext

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

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

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

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

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

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

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

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

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)

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

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

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

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

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

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 имеет значение set.

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

Обратная связь

Были ли сведения на этой странице полезными?

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)

Параметры