TextRenderer.DrawText Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, koloru i czcionki.

Przeciążenia

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)	Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, czcionki i koloru.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)	Rysuje określony tekst w określonych granicach przy użyciu określonego kontekstu urządzenia, czcionki, koloru, koloru pleców i instrukcji formatowania.
DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)	Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, czcionki, koloru, koloru pleców i instrukcji formatowania.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)	Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, czcionki, koloru, koloru pleców i instrukcji formatowania.
DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)	Rysuje określony tekst w określonych granicach przy użyciu określonego kontekstu urządzenia, czcionki, koloru i instrukcji formatowania.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)	Rysuje określony tekst w określonych granicach przy użyciu określonego kontekstu urządzenia, czcionki, koloru i koloru tła.
DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)	Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, czcionki, koloru i instrukcji formatowania.
DrawText(IDeviceContext, String, Font, Point, Color, Color)	Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, czcionki, koloru i koloru tła.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)	Rysuje określony tekst w określonych granicach przy użyciu określonego kontekstu urządzenia, czcionki, koloru, koloru pleców i instrukcji formatowania.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)	Rysuje określony tekst w określonych granicach przy użyciu określonego kontekstu urządzenia, czcionki, koloru i koloru tła.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)	Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, czcionki, koloru i instrukcji formatowania.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)	Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, czcionki, koloru i koloru tła.
DrawText(IDeviceContext, String, Font, Rectangle, Color)	Rysuje określony tekst w określonych granicach przy użyciu określonego kontekstu urządzenia, czcionki i koloru.
DrawText(IDeviceContext, String, Font, Point, Color)	Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, czcionki i koloru.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)	Rysuje określony tekst w określonych granicach przy użyciu określonego kontekstu urządzenia, czcionki i koloru.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, TextFormatFlags)	Rysuje określony tekst w określonych granicach przy użyciu określonego kontekstu urządzenia, czcionki, koloru i instrukcji formatowania.

Uwagi

Renderowanie tekstu oferowane przez klasę jest oparte na renderowaniu TextRenderer tekstu GDI i nie jest obsługiwane do drukowania z Windows Forms. Zamiast tego należy użyć DrawString metod Graphics klasy .

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

Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, czcionki i koloru.

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

Kontekst urządzenia, w którym ma być rysowanie tekstu.

text: ReadOnlySpan<Char>

Tekst do rysowania.

font: Font

Element Font do zastosowania do tekstu narysowanego.

pt: Point

Element Point reprezentujący lewy górny róg tekstu narysowanego.

foreColor: Color

Element Color do zastosowania do tekstu narysowanego.

Wyjątki

ArgumentNullException

dc to null.

Dotyczy

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

Rysuje określony tekst w określonych granicach przy użyciu określonego kontekstu urządzenia, czcionki, koloru, koloru pleców i instrukcji formatowania.

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

Kontekst urządzenia, w którym ma być rysowanie tekstu.

text: String

Tekst do rysowania.

font: Font

Element Font do zastosowania do tekstu narysowanego.

bounds: Rectangle

Element Rectangle reprezentujący granice tekstu.

foreColor: Color

Element Color do zastosowania do tekstu.

backColor: Color

Element Color do zastosowania do obszaru reprezentowanego przez element bounds.

flags: TextFormatFlags

Bitowa kombinacja TextFormatFlags wartości.

Wyjątki

ArgumentNullException

dc to null.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać DrawText metody . Aby uruchomić ten przykład, wklej kod do formularza Windows i wywołaj RenderText8 go z procedury obsługi zdarzeń formularzaPaint, przekazując e 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

Uwagi

Parametr backcolor jest stosowany do obszaru w parametrze. bounds If forecolor fontlub lub null Emptybackcolor , odpowiednio; DrawText metoda narysuje tekst w czcionki lub kolorze aktualnie wybranym w kontekście urządzenia określonym przez .dc Jeśli forecolor jest to Transparent, tekst nie zostanie narysowany.

Możesz manipulować sposobem narysowania tekstu przy użyciu jednego z DrawText przeciążeń, które przyjmuje TextFormatFlags parametr. Na przykład domyślnym zachowaniem elementu TextRenderer jest dodanie dopełnienia do prostokąta ograniczenia rysowanego tekstu, aby pomieścić zwisające glyphs. Jeśli musisz narysować wiersz tekstu bez tych dodatkowych spacji, należy użyć wersji i DrawText MeasureText , które przyjmują Size parametr i TextFormatFlags . Aby zapoznać się z przykładem, zobacz MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

Element nie obsługuje dodawania TextRenderer tabulatorów do tekstu narysowanego, chociaż można rozwinąć istniejącą kartę przestaje używać flagi ExpandTabs .

Dotyczy

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

Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, czcionki, koloru, koloru pleców i instrukcji formatowania.

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

Kontekst urządzenia, w którym ma być rysowanie tekstu.

text: String

Tekst do rysowania.

font: Font

Element Font do zastosowania do tekstu narysowanego.

pt: Point

Element Point reprezentujący lewy górny róg tekstu narysowanego.

foreColor: Color

Element Color do zastosowania do tekstu.

backColor: Color

Element Color do zastosowania do obszaru tła tekstu narysowanego.

flags: TextFormatFlags

Bitowa kombinacja TextFormatFlags wartości.

Wyjątki

ArgumentNullException

dc to null.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać DrawText metody . Aby uruchomić ten przykład, wklej kod do formularza Windows i wywołaj RenderText7 go z procedury obsługi zdarzeń formularzaPaint, przekazując e 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

Uwagi

Parametr backcolor jest stosowany prostokątny obszar zawierający tekst narysowany. Jeśli font lub jest null Emptylub forecolor , odpowiednio, DrawText metoda narysuje tekst w czcionki lub kolorze aktualnie wybranym w kontekście urządzenia określonym przez dc. Jeśli forecolor jest to Transparent, tekst nie zostanie narysowany.

Element nie obsługuje dodawania TextRenderer tabulatorów do tekstu narysowanego, chociaż można rozwinąć istniejącą kartę przestaje używać flagi ExpandTabs .

Uwaga

MetodyDrawText, które określają jako Point lewy górny róg rysowanego tekstu, nie są poprawnie renderowane w Windows 2000. Jeśli aplikacja jest przeznaczona do użycia na maszynach z systemem Windows 2000, należy użyć jednej z DrawText metod określających Rectangle granice tekstu rysowanego.

Dotyczy

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

Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, czcionki, koloru, koloru pleców i instrukcji formatowania.

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

Kontekst urządzenia, w którym ma być rysowanie tekstu.

text: ReadOnlySpan<Char>

Tekst do rysowania.

font: Font

Element Font do zastosowania do tekstu narysowanego.

pt: Point

Element Point reprezentujący lewy górny róg tekstu narysowanego.

foreColor: Color

Element Color do zastosowania do tekstu narysowanego.

backColor: Color

Element Color do zastosowania do obszaru tła tekstu narysowanego.

flags: TextFormatFlags

Bitowa kombinacja TextFormatFlags wartości.

Wyjątki

ArgumentNullException

dc to null.

ArgumentOutOfRangeException

ModifyString jest ustawiona.

Dotyczy

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

Rysuje określony tekst w określonych granicach przy użyciu określonego kontekstu urządzenia, czcionki, koloru i instrukcji formatowania.

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

Kontekst urządzenia, w którym ma być rysowanie tekstu.

text: String

Tekst do rysowania.

font: Font

Element Font do zastosowania do tekstu narysowanego.

bounds: Rectangle

Element Rectangle reprezentujący granice tekstu.

foreColor: Color

Element Color do zastosowania do tekstu narysowanego.

flags: TextFormatFlags

Bitowa kombinacja TextFormatFlags wartości.

Wyjątki

ArgumentNullException

dc to null.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać DrawText metody . Aby uruchomić ten przykład, wklej kod do formularza Windows i wywołaj RenderText6 go z procedury obsługi zdarzeń formularzaPaint, przekazując e 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

Uwagi

Jeśli font lub jest null Emptylub color , odpowiednio, DrawText metoda narysuje tekst w czcionki lub kolorze aktualnie wybranym w kontekście urządzenia określonym przez dc. Jeśli forecolor jest to Transparent, tekst nie zostanie narysowany.

Element nie obsługuje dodawania TextRenderer tabulatorów do tekstu narysowanego, chociaż można rozwinąć istniejącą kartę przestaje używać flagi ExpandTabs .

Dotyczy

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

Rysuje określony tekst w określonych granicach przy użyciu określonego kontekstu urządzenia, czcionki, koloru i koloru tła.

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

Kontekst urządzenia, w którym ma być rysowanie tekstu.

text: String

Tekst do rysowania.

font: Font

Element Font do zastosowania do tekstu narysowanego.

bounds: Rectangle

Element Rectangle reprezentujący granice tekstu.

foreColor: Color

Element Color do zastosowania do tekstu narysowanego.

backColor: Color

Element Color do zastosowania do obszaru reprezentowanego przez element bounds.

Wyjątki

ArgumentNullException

dc to null.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać DrawText metody . Aby uruchomić ten przykład, wklej kod do formularza Windows i wywołaj RenderText4 go z procedury obsługi zdarzeń formularzaPaint, przekazując e 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

Uwagi

Parametr backColor jest stosowany do obszaru w parametrze bounds . Jeśli font, backcolor lub forecolor null Emptyjest lub , odpowiednio, DrawText metoda narysuje tekst w czcionki lub kolorze aktualnie wybranym w kontekście urządzenia określonym przez .dc Jeśli forecolor jest to Transparent, tekst nie zostanie narysowany.

Ta metoda spowoduje wyświetlenie tekstu w poziomie i w pionie wyśrodkowanego w prostokątze bounds określonym przez parametr . Aby zmienić sposób rysowania tekstu, użyj wersji, która przyjmuje typ parametru DrawText TextFormatFlags .

Dotyczy

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

Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, czcionki, koloru i instrukcji formatowania.

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

Kontekst urządzenia, w którym ma być rysowanie tekstu.

text: String

Tekst do rysowania.

font: Font

Element Font do zastosowania do tekstu narysowanego.

pt: Point

Element Point reprezentujący lewy górny róg tekstu narysowanego.

foreColor: Color

Element Color do zastosowania do tekstu narysowanego.

flags: TextFormatFlags

Bitowa kombinacja TextFormatFlags wartości.

Wyjątki

ArgumentNullException

dc to null.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać DrawText metody . Aby uruchomić ten przykład, wklej kod do formularza Windows i wywołaj RenderText5 go z procedury obsługi zdarzeń formularzaPaint, przekazując e 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

Uwagi

Parametr backColor jest stosowany do obszaru w parametrze bounds . Jeśli font lub jest null Color.Emptylub forecolor , odpowiednio, DrawText metoda narysuje tekst w czcionki lub kolorze aktualnie wybranym w kontekście urządzenia określonym przez dc. Jeśli forecolor jest to Transparent, tekst nie zostanie narysowany.

Element nie obsługuje dodawania TextRenderer tabulatorów do tekstu narysowanego, chociaż można rozwinąć istniejącą kartę przestaje używać flagi ExpandTabs .

Uwaga

Dotyczy

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

Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, czcionki, koloru i koloru tła.

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

Kontekst urządzenia, w którym ma być rysowanie tekstu.

text: String

Tekst do rysowania.

font: Font

Element Font do zastosowania do tekstu narysowanego.

pt: Point

Element Point reprezentujący lewy górny róg tekstu narysowanego.

foreColor: Color

Element Color do zastosowania do tekstu narysowanego.

backColor: Color

Element Color do zastosowania do obszaru tła tekstu narysowanego.

Wyjątki

ArgumentNullException

dc to null.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać DrawText metody . Aby uruchomić ten przykład, wklej kod do formularza Windows i wywołaj RenderText3 go z procedury obsługi zdarzeń formularzaPaint, przekazując e 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

Uwagi

Parametr backColor jest stosowany do prostokątnego obszaru zawierającego narysowany tekst. Jeśli font, backcolor lub forecolor null Color.Emptyjest lub , odpowiednio, DrawText metoda narysuje tekst w czcionki lub kolorze aktualnie wybranym w kontekście urządzenia określonym przez .dc Jeśli forecolor jest to Transparent, tekst nie zostanie narysowany.

Możesz manipulować sposobem narysowania tekstu przy użyciu jednego z DrawText przeciążeń, które przyjmuje TextFormatFlags parametr.

Uwaga

Dotyczy

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

Rysuje określony tekst w określonych granicach przy użyciu określonego kontekstu urządzenia, czcionki, koloru, koloru pleców i instrukcji formatowania.

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

Kontekst urządzenia, w którym ma być rysowanie tekstu.

text: ReadOnlySpan<Char>

Tekst do rysowania.

font: Font

Element Font do zastosowania do tekstu narysowanego.

bounds: Rectangle

Element Rectangle reprezentujący granice tekstu.

foreColor: Color

Element Color do zastosowania do tekstu narysowanego.

backColor: Color

Element Color do zastosowania do obszaru tła tekstu narysowanego.

flags: TextFormatFlags

Bitowa kombinacja TextFormatFlags wartości.

Wyjątki

ArgumentNullException

dc to null.

ArgumentOutOfRangeException

ModifyString jest ustawiona.

Dotyczy

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

Rysuje określony tekst w określonych granicach przy użyciu określonego kontekstu urządzenia, czcionki, koloru i koloru tła.

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

Kontekst urządzenia, w którym ma być rysowanie tekstu.

text: ReadOnlySpan<Char>

Tekst do rysowania.

font: Font

Element Font do zastosowania do tekstu narysowanego.

bounds: Rectangle

Element Rectangle reprezentujący granice tekstu.

foreColor: Color

Element Color do zastosowania do tekstu narysowanego.

backColor: Color

Element Color do zastosowania do obszaru tła tekstu narysowanego.

Wyjątki

ArgumentNullException

dc to null.

Dotyczy

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

Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, czcionki, koloru i instrukcji formatowania.

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

Kontekst urządzenia, w którym ma być rysowanie tekstu.

text: ReadOnlySpan<Char>

Tekst do rysowania.

font: Font

Element Font do zastosowania do tekstu narysowanego.

pt: Point

Element Point reprezentujący lewy górny róg tekstu narysowanego.

foreColor: Color

Element Color do zastosowania do tekstu narysowanego.

flags: TextFormatFlags

Bitowa kombinacja TextFormatFlags wartości.

Wyjątki

ArgumentNullException

dc to null.

ArgumentOutOfRangeException

ModifyString jest ustawiona.

Dotyczy

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

Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, czcionki, koloru i koloru tła.

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

Kontekst urządzenia, w którym ma być rysowanie tekstu.

text: ReadOnlySpan<Char>

Tekst do rysowania.

font: Font

Element Font do zastosowania do tekstu narysowanego.

pt: Point

Element Point reprezentujący lewy górny róg tekstu narysowanego.

foreColor: Color

Element Color do zastosowania do tekstu narysowanego.

backColor: Color

Element Color do zastosowania do obszaru tła tekstu narysowanego.

Wyjątki

ArgumentNullException

dc to null.

Dotyczy

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

Rysuje określony tekst w określonych granicach przy użyciu określonego kontekstu urządzenia, czcionki i koloru.

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

Kontekst urządzenia, w którym ma być rysowanie tekstu.

text: String

Tekst do rysowania.

font: Font

Element Font do zastosowania do tekstu narysowanego.

bounds: Rectangle

Element Rectangle reprezentujący granice tekstu.

foreColor: Color

Element Color do zastosowania do tekstu narysowanego.

Wyjątki

ArgumentNullException

dc to null.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać DrawText metody . Aby uruchomić ten przykład, wklej kod do formularza Windows i wywołaj RenderText2 go z procedury obsługi zdarzeń formularzaPaint, przekazując e 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

Uwagi

Jeśli font lub jest null Color.Emptylub forecolor , odpowiednio, DrawText metoda narysuje tekst w czcionki lub kolorze aktualnie wybranym w kontekście urządzenia określonym przez dc. Jeśli forecolor jest to Transparent, tekst nie zostanie narysowany.

Zobacz też

IDeviceContext

Dotyczy

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

Rysuje określony tekst w określonej lokalizacji przy użyciu określonego kontekstu urządzenia, czcionki i koloru.

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

Kontekst urządzenia, w którym ma być rysowanie tekstu.

text: String

Tekst do rysowania.

font: Font

Element Font do zastosowania do tekstu narysowanego.

pt: Point

Element Point reprezentujący lewy górny róg tekstu narysowanego.

foreColor: Color

Element Color do zastosowania do tekstu narysowanego.

Wyjątki

ArgumentNullException

dc to null.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać DrawText metody . Aby uruchomić ten przykład, wklej kod do formularza Windows i wywołaj RenderText1 go z procedury obsługi zdarzeń formularzaPaint, przekazując e 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

Uwagi

Możesz manipulować sposobem narysowania tekstu przy użyciu jednego z DrawText przeciążeń, które przyjmuje TextFormatFlags parametr.

Jeśli font jest lub forecolor jest Color.Emptynull , DrawText metoda narysuje tekst w czcionki lub kolorze aktualnie wybranym w kontekście urządzenia określonym przez dc. Jeśli forecolor jest to Transparent, tekst nie zostanie narysowany.

Uwaga

Zobacz też

IDeviceContext

Dotyczy

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

Rysuje określony tekst w określonych granicach przy użyciu określonego kontekstu urządzenia, czcionki i koloru.

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

Kontekst urządzenia, w którym ma być rysowanie tekstu.

text: ReadOnlySpan<Char>

Tekst do rysowania.

font: Font

Element Font do zastosowania do tekstu narysowanego.

bounds: Rectangle

Element Rectangle reprezentujący granice tekstu.

foreColor: Color

Element Color do zastosowania do tekstu narysowanego.

Wyjątki

ArgumentNullException

dc to null.

Dotyczy

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

Rysuje określony tekst w określonych granicach przy użyciu określonego kontekstu urządzenia, czcionki, koloru i instrukcji formatowania.

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)