Sdílet prostřednictvím


TextRenderer.DrawText Metoda

Definice

Nakreslí zadaný text na zadaném místě pomocí zadaného kontextu zařízení, barvy a písma.

Přetížení

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

Nakreslí zadaný text v zadaném umístění pomocí zadaného kontextu zařízení, písma a barvy.

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

Nakreslí zadaný text v zadaných mezích pomocí zadaného kontextu zařízení, písma, barvy, barvy pozadí a pokynů pro formátování.

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

Nakreslí zadaný text v zadaném umístění pomocí zadaného kontextu zařízení, písma, barvy, barvy pozadí a pokynů k formátování.

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

Nakreslí zadaný text v zadaném umístění pomocí zadaného kontextu zařízení, písma, barvy, barvy pozadí a pokynů k formátování.

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

Nakreslí zadaný text v zadaných mezích pomocí zadaného kontextu zařízení, písma, barvy a pokynů k formátování.

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

Vykreslí zadaný text v zadaných mezích pomocí zadaného kontextu zařízení, písma, barvy a barvy pozadí.

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

Vykreslí zadaný text v zadaném umístění pomocí zadaného kontextu zařízení, písma, barvy a pokynů k formátování.

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

Nakreslí zadaný text v zadaném umístění pomocí zadaného kontextu zařízení, písma, barvy a barvy pozadí.

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

Nakreslí zadaný text v zadaných mezích pomocí zadaného kontextu zařízení, písma, barvy, barvy pozadí a pokynů pro formátování.

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

Vykreslí zadaný text v zadaných mezích pomocí zadaného kontextu zařízení, písma, barvy a barvy pozadí.

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

Vykreslí zadaný text v zadaném umístění pomocí zadaného kontextu zařízení, písma, barvy a pokynů k formátování.

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

Nakreslí zadaný text v zadaném umístění pomocí zadaného kontextu zařízení, písma, barvy a barvy pozadí.

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

Nakreslí zadaný text v zadaných mezích pomocí zadaného kontextu zařízení, písma a barvy.

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

Nakreslí zadaný text v zadaném umístění pomocí zadaného kontextu zařízení, písma a barvy.

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

Nakreslí zadaný text v zadaných mezích pomocí zadaného kontextu zařízení, písma a barvy.

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

Nakreslí zadaný text v zadaných mezích pomocí zadaného kontextu zařízení, písma, barvy a pokynů k formátování.

Poznámky

Vykreslování textu nabízené TextRenderer třídou je založeno na vykreslování textu GDI a není podporováno pro tisk z model Windows Forms. Místo toho použijte DrawString metody Graphics třídy .

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

Nakreslí zadaný text v zadaném umístění pomocí zadaného kontextu zařízení, písma a barvy.

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)

Parametry

dc
IDeviceContext

Kontext zařízení, ve kterém se má text nakreslit.

text
ReadOnlySpan<Char>

Text, který chcete nakreslit.

font
Font

Použije Font se pro nakreslený text.

pt
Point

Představuje Point levý horní roh nakresleného textu.

foreColor
Color

Použije Color se pro nakreslený text.

Výjimky

dc je null.

Platí pro

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

Nakreslí zadaný text v zadaných mezích pomocí zadaného kontextu zařízení, písma, barvy, barvy pozadí a pokynů pro formátování.

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)

Parametry

dc
IDeviceContext

Kontext zařízení, ve kterém se má text nakreslit.

text
String

Text, který chcete nakreslit.

font
Font

Použije Font se pro nakreslený text.

bounds
Rectangle

Představuje Rectangle hranice textu.

foreColor
Color

Použije Color se na text.

backColor
Color

Použije Color se pro oblast reprezentovanou hodnotou bounds.

flags
TextFormatFlags

Bitové kombinace TextFormatFlags hodnot.

Výjimky

dc je null.

Příklady

Následující příklad kódu ukazuje, jak použít metodu DrawText . Pokud chcete spustit tento příklad, vložte kód do formuláře Windows Form a zavolejte RenderText8 ho z obslužné rutiny Paint události formuláře a předejte e ho jako 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

Poznámky

Parametr backcolor se použije na oblast v parametru.bounds If font, forecolor nebo backcolor is null nebo , Emptyv uvedeném pořadí. DrawText Metoda nakreslí text v písmu nebo barvě aktuálně vybraném v kontextu zařízení určeném nástrojem dc. Pokud forecolor je Transparent, text se nevykreslí.

Pomocí jednoho z DrawText přetížení, které přebírá TextFormatFlags parametr, můžete pracovat s tím, jak je text nakreslen. Například výchozím chováním objektu TextRenderer je přidání odsazení do ohraničujícího obdélníku nakresleného textu, aby se přizpůsobilo převislým glyfům. Pokud potřebujete nakreslit čáru textu bez těchto nadbytečných mezer, měli byste použít verze DrawText a MeasureText , které mají Size parametr a TextFormatFlags . Příklad naleznete v tématu MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

Vykreslování textu nabízené TextRenderer třídou je založeno na vykreslování textu GDI a není podporováno pro tisk z model Windows Forms. Místo toho použijte DrawString metody Graphics třídy .

Nástroj TextRenderer nepodporuje přidávání zarážek tabulátoru k nakreslený text, i když existující zarážky tabulátoru můžete rozbalit pomocí příznaku ExpandTabs .

Platí pro

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

Nakreslí zadaný text v zadaném umístění pomocí zadaného kontextu zařízení, písma, barvy, barvy pozadí a pokynů k formátování.

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)

Parametry

dc
IDeviceContext

Kontext zařízení, ve kterém se má text nakreslit.

text
String

Text, který chcete nakreslit.

font
Font

Použije Font se pro nakreslený text.

pt
Point

Představuje Point levý horní roh nakresleného textu.

foreColor
Color

Použije Color se na text.

backColor
Color

Použije Color se pro oblast pozadí nakresleného textu.

flags
TextFormatFlags

Bitové kombinace TextFormatFlags hodnot.

Výjimky

dc je null.

Příklady

Následující příklad kódu ukazuje, jak použít metodu DrawText . Pokud chcete spustit tento příklad, vložte kód do formuláře Windows Form a zavolejte RenderText7 ho z obslužné rutiny Paint události formuláře a předejte e ho jako 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

Poznámky

Parametr backcolor se použije v obdélníkové oblasti obsahující nakreslený text. Pokud font nebo forecolor je null nebo Empty, DrawText metoda nakreslí text v písmu nebo barvě aktuálně vybraném v kontextu zařízení určeném nástrojem dc. Pokud forecolor je Transparent, text se nevykreslí.

Pomocí jednoho z DrawText přetížení, které přebírá TextFormatFlags parametr, můžete pracovat s tím, jak je text nakreslen. Například výchozím chováním objektu TextRenderer je přidání odsazení do ohraničujícího obdélníku nakresleného textu, aby se přizpůsobilo převislým glyfům. Pokud potřebujete nakreslit čáru textu bez těchto nadbytečných mezer, měli byste použít verze DrawText a MeasureText , které mají Size parametr a TextFormatFlags . Příklad naleznete v tématu MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

Vykreslování textu nabízené TextRenderer třídou je založeno na vykreslování textu GDI a není podporováno pro tisk z model Windows Forms. Místo toho použijte DrawString metody Graphics třídy .

Nástroj TextRenderer nepodporuje přidávání zarážek tabulátoru k nakreslený text, i když existující zarážky tabulátoru můžete rozbalit pomocí příznaku ExpandTabs .

Poznámka

Metody DrawText , které určují Point jako levý horní roh nakresleného textu, se v systému Windows 2000 nevykreslí správně. Pokud je vaše aplikace určena pro použití na počítačích se systémem Windows 2000, měli byste použít jednu z DrawText metod, které určují Rectangle hranice nakresleného textu.

Platí pro

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

Nakreslí zadaný text v zadaném umístění pomocí zadaného kontextu zařízení, písma, barvy, barvy pozadí a pokynů k formátování.

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)

Parametry

dc
IDeviceContext

Kontext zařízení, ve kterém se má text nakreslit.

text
ReadOnlySpan<Char>

Text, který chcete nakreslit.

font
Font

Použije Font se pro nakreslený text.

pt
Point

Představuje Point levý horní roh nakresleného textu.

foreColor
Color

Použije Color se pro nakreslený text.

backColor
Color

Použije Color se pro oblast pozadí nakresleného textu.

flags
TextFormatFlags

Bitové kombinace TextFormatFlags hodnot.

Výjimky

dc je null.

Platí pro

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

Nakreslí zadaný text v rámci zadaných hranic pomocí zadaného kontextu zařízení, písma, barvy a pokynů pro formátování.

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)

Parametry

dc
IDeviceContext

Kontext zařízení, ve kterém se má text nakreslit.

text
String

Text, který chcete nakreslit.

font
Font

Použije Font se na nakreslený text.

bounds
Rectangle

Hodnota Rectangle , která představuje hranice textu.

foreColor
Color

Použije Color se na nakreslený text.

flags
TextFormatFlags

Bitové kombinace TextFormatFlags hodnot.

Výjimky

dc je null.

Příklady

Následující příklad kódu ukazuje, jak použít metodu DrawText . Pokud chcete spustit tento příklad, vložte kód do formuláře Windows Form a zavolejte RenderText6 ho z obslužné rutiny Paint události formuláře a předejte e ho jako 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

Poznámky

Pokud font nebo color je null nebo Empty, DrawText metoda nakreslí text v písmu nebo barvě aktuálně vybrané v kontextu zařízení určeném parametrem dc. Pokud forecolor je Transparent, text se nevykreslí.

S vykreslením textu můžete manipulovat pomocí jednoho z DrawText přetížení, které přebírá TextFormatFlags parametr. Například výchozím chováním objektu TextRenderer je přidání odsazení do ohraničujícího obdélníku nakresleného textu, aby bylo možné přizpůsobit převislé glyfy. Pokud potřebujete nakreslit čáru textu bez těchto nadbytečných mezer, měli byste použít verze DrawText a MeasureText , které mají Size parametr a TextFormatFlags . Příklad naleznete v tématu MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

Vykreslování textu nabízené TextRenderer třídou je založeno na vykreslování textu GDI a není podporováno pro tisk z model Windows Forms. Místo toho použijte DrawString metody Graphics třídy .

Nástroj TextRenderer nepodporuje přidávání zarážek tabulátoru k nakreslený text, i když existující zarážky tabulátoru můžete rozbalit pomocí příznaku ExpandTabs .

Platí pro

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

Nakreslí zadaný text v rámci zadaných hranic pomocí zadaného kontextu zařízení, písma, barvy a barvy pozadí.

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)

Parametry

dc
IDeviceContext

Kontext zařízení, ve kterém chcete nakreslit text.

text
String

Text, který chcete nakreslit.

font
Font

Použije Font se na nakreslený text.

bounds
Rectangle

Hodnota Rectangle , která představuje hranice textu.

foreColor
Color

Použije Color se na nakreslený text.

backColor
Color

Použije Color se na oblast reprezentovanou hodnotou bounds.

Výjimky

dc je null.

Příklady

Následující příklad kódu ukazuje, jak použít metodu DrawText . Tento příklad spustíte tak, že kód vložíte do formuláře Windows Form a zavoláte RenderText4 ho z obslužné rutiny Paint události formuláře a předáte e ho jako 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

Poznámky

Parametr se backColor použije na oblast v parametru bounds . Pokud font, backcolor nebo forecolor je null nebo Empty, DrawText metoda nakreslí text v písmu nebo barvě aktuálně vybrané v kontextu zařízení určeném parametrem dc. Pokud forecolor je Transparent, text se nevykreslí.

Výsledkem této metody bude text, který je vodorovně a svisle zarovnaný na střed v obdélníku určeném parametrem bounds . Pokud chcete změnit způsob vykreslení textu, použijte verzi , DrawText která přebírá typ parametru TextFormatFlags .

Vykreslování textu nabízené TextRenderer třídou je založeno na vykreslování textu GDI a není podporováno pro tisk z model Windows Forms. Místo toho použijte DrawString metody Graphics třídy .

Platí pro

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

Nakreslí zadaný text na zadaném místě pomocí zadaného kontextu zařízení, písma, barvy a pokynů pro formátování.

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)

Parametry

dc
IDeviceContext

Kontext zařízení, ve kterém chcete nakreslit text.

text
String

Text, který chcete nakreslit.

font
Font

Použije Font se na nakreslený text.

pt
Point

Představuje Point levý horní roh nakresleného textu.

foreColor
Color

Použije Color se na nakreslený text.

flags
TextFormatFlags

Bitové kombinace TextFormatFlags hodnot.

Výjimky

dc je null.

Příklady

Následující příklad kódu ukazuje, jak použít metodu DrawText . Tento příklad spustíte tak, že kód vložíte do formuláře Windows Form a zavoláte RenderText5 ho z obslužné rutiny Paint události formuláře a předáte e ho jako 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

Poznámky

S vykreslením textu můžete manipulovat pomocí jednoho z DrawText přetížení, které přebírá TextFormatFlags parametr. Například výchozím chováním objektu TextRenderer je přidání odsazení do ohraničujícího obdélníku nakresleného textu, aby bylo možné přizpůsobit převislé glyfy. Pokud potřebujete nakreslit čáru textu bez těchto nadbytečných mezer, měli byste použít verze DrawText a MeasureText , které mají Size parametr a TextFormatFlags . Příklad naleznete v tématu MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

Parametr se backColor použije na oblast v parametru bounds . Pokud font nebo forecolor je null nebo Color.Empty, DrawText metoda nakreslí text v písmu nebo barvě aktuálně vybrané v kontextu zařízení určeném parametrem dc. Pokud forecolor je Transparent, text se nevykreslí.

Vykreslování textu nabízené TextRenderer třídou je založeno na vykreslování textu GDI a není podporováno pro tisk z model Windows Forms. Místo toho použijte DrawString metody Graphics třídy .

Nástroj TextRenderer nepodporuje přidávání zarážek tabulátoru k nakreslený text, i když existující zarážky tabulátoru můžete rozbalit pomocí příznaku ExpandTabs .

Poznámka

Metody DrawText , které určují Point jako levý horní roh nakresleného textu, se v systému Windows 2000 nevykreslují správně. Pokud je aplikace určena pro použití na počítačích se systémem Windows 2000, měli byste použít jednu z DrawText metod, které určují Rectangle hranice vykresleného textu.

Platí pro

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

Nakreslí zadaný text na zadaném místě pomocí zadaného kontextu zařízení, písma, barvy a barvy pozadí.

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)

Parametry

dc
IDeviceContext

Kontext zařízení, ve kterém chcete nakreslit text.

text
String

Text, který chcete nakreslit.

font
Font

Použije Font se na nakreslený text.

pt
Point

Představuje Point levý horní roh nakresleného textu.

foreColor
Color

Použije Color se na nakreslený text.

backColor
Color

Použije Color se pro oblast pozadí nakresleného textu.

Výjimky

dc je null.

Příklady

Následující příklad kódu ukazuje, jak použít metodu DrawText . Tento příklad spustíte tak, že kód vložíte do formuláře Windows Form a zavoláte RenderText3 ho z obslužné rutiny Paint události formuláře a předáte e ho jako 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

Poznámky

Parametr se backColor použije na obdélníkovou oblast obsahující nakreslený text. Pokud font, backcolor nebo forecolor je null nebo Color.Empty, DrawText metoda nakreslí text v písmu nebo barvě aktuálně vybrané v kontextu zařízení určeném parametrem dc. Pokud forecolor je Transparent, text se nevykreslí.

S vykreslením textu můžete manipulovat pomocí jednoho z DrawText přetížení, které přebírá TextFormatFlags parametr.

Vykreslování textu nabízené TextRenderer třídou je založeno na vykreslování textu GDI a není podporováno pro tisk z model Windows Forms. Místo toho použijte DrawString metody Graphics třídy .

Poznámka

Metody DrawText , které určují Point jako levý horní roh nakresleného textu, se v systému Windows 2000 nevykreslují správně. Pokud je aplikace určena pro použití na počítačích se systémem Windows 2000, měli byste použít jednu z DrawText metod, které určují Rectangle hranice vykresleného textu.

Platí pro

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

Nakreslí zadaný text v rámci zadaných hranic pomocí zadaného kontextu zařízení, písma, barvy, barvy pozadí a pokynů pro formátování.

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)

Parametry

dc
IDeviceContext

Kontext zařízení, ve kterém chcete nakreslit text.

text
ReadOnlySpan<Char>

Text, který chcete nakreslit.

font
Font

Použije Font se na nakreslený text.

bounds
Rectangle

Hodnota Rectangle , která představuje hranice textu.

foreColor
Color

Použije Color se na nakreslený text.

backColor
Color

Použije Color se pro oblast pozadí nakresleného textu.

flags
TextFormatFlags

Bitové kombinace TextFormatFlags hodnot.

Výjimky

dc je null.

Platí pro

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

Nakreslí zadaný text v rámci zadaných hranic pomocí zadaného kontextu zařízení, písma, barvy a barvy pozadí.

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)

Parametry

dc
IDeviceContext

Kontext zařízení, ve kterém chcete nakreslit text.

text
ReadOnlySpan<Char>

Text, který chcete nakreslit.

font
Font

Použije Font se na nakreslený text.

bounds
Rectangle

Hodnota Rectangle , která představuje hranice textu.

foreColor
Color

Použije Color se na nakreslený text.

backColor
Color

Použije Color se pro oblast pozadí nakresleného textu.

Výjimky

dc je null.

Platí pro

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

Vykreslí zadaný text v zadaném umístění pomocí zadaného kontextu zařízení, písma, barvy a pokynů k formátování.

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)

Parametry

dc
IDeviceContext

Kontext zařízení, ve kterém chcete nakreslit text.

text
ReadOnlySpan<Char>

Text, který chcete nakreslit.

font
Font

Použije Font se na nakreslený text.

pt
Point

Představuje Point levý horní roh nakresleného textu.

foreColor
Color

Použije Color se na nakreslený text.

flags
TextFormatFlags

Bitové kombinace TextFormatFlags hodnot.

Výjimky

dc je null.

Platí pro

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

Nakreslí zadaný text v zadaném umístění pomocí zadaného kontextu zařízení, písma, barvy a barvy pozadí.

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)

Parametry

dc
IDeviceContext

Kontext zařízení, ve kterém se má text nakreslit.

text
ReadOnlySpan<Char>

Text, který chcete nakreslit.

font
Font

Použije Font se pro nakreslený text.

pt
Point

Představuje Point levý horní roh nakresleného textu.

foreColor
Color

Použije Color se pro nakreslený text.

backColor
Color

Použije Color se pro oblast pozadí nakresleného textu.

Výjimky

dc je null.

Platí pro

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

Nakreslí zadaný text v zadaných mezích pomocí zadaného kontextu zařízení, písma a barvy.

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)

Parametry

dc
IDeviceContext

Kontext zařízení, ve kterém se má text nakreslit.

text
String

Text, který chcete nakreslit.

font
Font

Použije Font se pro nakreslený text.

bounds
Rectangle

Představuje Rectangle hranice textu.

foreColor
Color

Použije Color se pro nakreslený text.

Výjimky

dc je null.

Příklady

Následující příklad kódu ukazuje, jak použít metodu DrawText . Pokud chcete spustit tento příklad, vložte kód do formuláře Windows Form a zavolejte RenderText2 ho z obslužné rutiny Paint události formuláře a předejte e ho jako 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

Poznámky

Pokud font nebo forecolor je null nebo Color.Empty, DrawText metoda nakreslí text v písmu nebo barvě aktuálně vybraném v kontextu zařízení určeném nástrojem dc. Pokud forecolor je Transparent, text se nevykreslí.

Výsledkem této metody bude text, který je vodorovně a svisle zarovnaný na střed v obdélníku určeném parametrem bounds . Pokud chcete změnit způsob kreslení textu, použijte verzi, DrawText která přebírá typ parametru TextFormatFlags .

Vykreslování textu nabízené TextRenderer třídou je založeno na vykreslování textu GDI a není podporováno pro tisk z model Windows Forms. Místo toho použijte DrawString metody Graphics třídy .

Viz také

Platí pro

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

Nakreslí zadaný text v zadaném umístění pomocí zadaného kontextu zařízení, písma a barvy.

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)

Parametry

dc
IDeviceContext

Kontext zařízení, ve kterém se má text nakreslit.

text
String

Text, který chcete nakreslit.

font
Font

Použije Font se pro nakreslený text.

pt
Point

Představuje Point levý horní roh nakresleného textu.

foreColor
Color

Použije Color se pro nakreslený text.

Výjimky

dc je null.

Příklady

Následující příklad kódu ukazuje, jak použít metodu DrawText . Pokud chcete spustit tento příklad, vložte kód do formuláře Windows Form a zavolejte RenderText1 ho z obslužné rutiny Paint události formuláře a předejte e ho jako 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

Poznámky

Pomocí jednoho z DrawText přetížení, které přebírá TextFormatFlags parametr, můžete pracovat s tím, jak je text nakreslen.

Pokud font je null nebo forecolor je Color.Empty, DrawText metoda nakreslí text v písmu nebo barvě aktuálně vybraném v kontextu zařízení určeném nástrojem dc. Pokud forecolor je Transparent, text se nevykreslí.

Vykreslování textu nabízené TextRenderer třídou je založeno na vykreslování textu GDI a není podporováno pro tisk z model Windows Forms. Místo toho použijte DrawString metody Graphics třídy .

Poznámka

Metody DrawText , které určují Point jako levý horní roh nakresleného textu, se v systému Windows 2000 nevykreslí správně. Pokud je vaše aplikace určena pro použití na počítačích se systémem Windows 2000, měli byste použít jednu z DrawText metod, které určují Rectangle hranice nakresleného textu.

Viz také

Platí pro

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

Nakreslí zadaný text v zadaných mezích pomocí zadaného kontextu zařízení, písma a barvy.

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)

Parametry

dc
IDeviceContext

Kontext zařízení, ve kterém se má text nakreslit.

text
ReadOnlySpan<Char>

Text, který chcete nakreslit.

font
Font

Použije Font se pro nakreslený text.

bounds
Rectangle

Představuje Rectangle hranice textu.

foreColor
Color

Použije Color se pro nakreslený text.

Výjimky

dc je null.

Platí pro

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

Nakreslí zadaný text v zadaných mezích pomocí zadaného kontextu zařízení, písma, barvy a pokynů k formátování.

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)

Parametry

dc
IDeviceContext

Kontext zařízení, ve kterém se má text nakreslit.

text
ReadOnlySpan<Char>

Text, který chcete nakreslit.

font
Font

Použije Font se pro nakreslený text.

bounds
Rectangle

Představuje Rectangle hranice textu.

foreColor
Color

Použije Color se pro nakreslený text.

flags
TextFormatFlags

Bitové kombinace TextFormatFlags hodnot.

Výjimky

dc je null.

Platí pro