TextRenderer.DrawText Metoda

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

ArgumentNullException

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

ArgumentNullException

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).

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

ArgumentNullException

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í.

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

ArgumentNullException

dc je null.

ArgumentOutOfRangeException

ModifyString je nastavená.

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

ArgumentNullException

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).

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

ArgumentNullException

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 .

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

ArgumentNullException

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

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í.

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

ArgumentNullException

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.

Poznámka

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

ArgumentNullException

dc je null.

ArgumentOutOfRangeException

ModifyString je nastavená.

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

ArgumentNullException

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

ArgumentNullException

dc je null.

ArgumentOutOfRangeException

ModifyString je nastavená.

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

ArgumentNullException

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

ArgumentNullException

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 .

Viz také

IDeviceContext

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

ArgumentNullException

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í.

Poznámka

Viz také

IDeviceContext

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

ArgumentNullException

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)