Поделиться через


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)

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

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 для применения к отображаемому тексту.

Исключения

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.

Исключения

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 , основана на отрисовке текста GDI и не поддерживается для печати из Windows Forms. Вместо этого используйте DrawString методы Graphics класса .

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.

Исключения

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

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

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

Примечание

Методы 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.

Исключения

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

Свойство 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.

Исключения

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

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

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

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

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.

Исключения

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 тип параметра.

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

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

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.

Исключения

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

Комментарии

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

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

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

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

Примечание

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

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

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 для применения к области фона прорисовываемого текста.

Исключения

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.

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

Примечание

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

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

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.

Исключения

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

Свойство 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 для применения к области фона прорисовываемого текста.

Исключения

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.

Исключения

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

Свойство 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 для применения к области фона прорисовываемого текста.

Исключения

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 для применения к отображаемому тексту.

Исключения

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, текст не будет нарисован.

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

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

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

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

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 для применения к отображаемому тексту.

Исключения

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

Комментарии

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

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

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

Примечание

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

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

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

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 для применения к отображаемому тексту.

Исключения

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.

Исключения

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

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

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