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 tła 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 tła 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 tła i instrukcji formatowania.
DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)	Rysuje określony tekst w określonych granicach przy użyciu określonych instrukcji dotyczących kontekstu urządzenia, czcionki, koloru i 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ślonych instrukcji dotyczących kontekstu urządzenia, czcionki, koloru i 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 tła 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ślonych instrukcji dotyczących kontekstu urządzenia, czcionki, koloru i 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ślonych instrukcji dotyczących kontekstu urządzenia, czcionki, koloru i formatowania.

Uwagi

Renderowanie tekstu oferowane przez klasę TextRenderer jest oparte na renderowaniu 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ć narysowyny tekst.

text: ReadOnlySpan<Char>

Tekst do rysowania.

font: Font

Element Font do zastosowania do narysowanego tekstu.

pt: Point

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

foreColor: Color

Element Color do zastosowania do narysowanego tekstu.

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 tła 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ć narysowyny tekst.

text: String

Tekst do rysowania.

font: Font

Element Font do zastosowania do narysowanego tekstu.

bounds: Rectangle

Obiekt Rectangle reprezentujący granice tekstu.

foreColor: Color

Element Color do zastosowania do tekstu.

backColor: Color

Element Color do zastosowania do obszaru reprezentowanego przez boundselement .

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 systemu Windows i wywołaj RenderText8 metodę z procedury obsługi zdarzeń formularza Paint , 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 Jeśli font, forecolor lub backcolor jest null lub Empty, odpowiednio; DrawText metoda narysuje tekst w czcionki lub kolorze aktualnie wybranym w kontekście urządzenia określonym przez dc. Jeśli forecolor parametr ma Transparentwartość , 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 obiektu TextRenderer jest dodanie wypełnienia do prostokąta ograniczenia rysowanego tekstu w celu uwzględnienia zwisających kropek. Jeśli musisz narysować wiersz tekstu bez tych dodatkowych spacji, należy użyć wersji DrawText i MeasureText , które przyjmują Size parametr i TextFormatFlags . Aby zapoznać się z przykładem, zobacz MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

Funkcja nie obsługuje dodawania TextRenderer tabulatorów do rysowanego tekstu, chociaż można rozwinąć istniejące tabulatory przy użyciu 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 tła 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ć narysowyny tekst.

text: String

Tekst do rysowania.

font: Font

Element Font do zastosowania do narysowanego tekstu.

pt: Point

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

foreColor: Color

Element Color do zastosowania do tekstu.

backColor: Color

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

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 systemu Windows i wywołaj RenderText7 metodę z procedury obsługi zdarzeń formularza Paint , 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 rysowany tekst. Jeśli font lub forecolor jest nullEmptylub , odpowiednio; DrawText metoda narysuje tekst w czcionki lub kolorze aktualnie wybranym w kontekście urządzenia określonym przez dc. Jeśli forecolor parametr ma Transparentwartość , tekst nie zostanie narysowany.

Funkcja nie obsługuje dodawania TextRenderer tabulatorów do rysowanego tekstu, chociaż można rozwinąć istniejące tabulatory przy użyciu flagi ExpandTabs .

Uwaga

DrawText Metody, które określają Point jako lewy górny róg rysowanego tekstu, nie są poprawnie renderowane w systemie 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 rysowanego tekstu.

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 tła 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ć narysowyny tekst.

text: ReadOnlySpan<Char>

Tekst do rysowania.

font: Font

Element Font do zastosowania do narysowanego tekstu.

pt: Point

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

foreColor: Color

Element Color do zastosowania do narysowanego tekstu.

backColor: Color

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

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ć narysowyny tekst.

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 systemu Windows i wywołaj RenderText6 metodę z procedury obsługi zdarzeń formularza Paint , 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 nullEmptylub 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.

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

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 .

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 systemu Windows i wywołaj RenderText4 go z procedury obsługi zdarzeń formularza Paint , 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 forecolornullEmptyjest 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 systemu Windows i wywołaj RenderText5 go z procedury obsługi zdarzeń formularza Paint , 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 nullColor.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 systemu Windows i wywołaj RenderText3 go z procedury obsługi zdarzeń formularza Paint , 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 forecolornullColor.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ślonych instrukcji dotyczących kontekstu urządzenia, czcionki, koloru i 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ć narysowyny tekst.

text: ReadOnlySpan<Char>

Tekst do rysowania.

font: Font

Element Font do zastosowania do narysowanego tekstu.

pt: Point

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

foreColor: Color

Element Color do zastosowania do narysowanego tekstu.

backColor: Color

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

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ć narysowyny tekst.

text: String

Tekst do rysowania.

font: Font

Element Font do zastosowania do narysowanego tekstu.

bounds: Rectangle

Obiekt Rectangle reprezentujący granice tekstu.

foreColor: Color

Element Color do zastosowania do narysowanego tekstu.

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 systemu Windows i wywołaj RenderText2 metodę z procedury obsługi zdarzeń formularza Paint , 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 forecolor jest nullColor.Emptylub , odpowiednio; DrawText metoda narysuje tekst w czcionki lub kolorze aktualnie wybranym w kontekście urządzenia określonym przez dc. Jeśli forecolor parametr ma Transparentwartość , tekst nie zostanie narysowany.

Ta metoda spowoduje wyświetlenie tekstu, który jest wyśrodkowany w poziomie i pionowo w prostokącie określonym przez bounds parametr . Aby zmienić sposób pisania tekstu, użyj wersji, która przyjmuje typ parametru DrawText TextFormatFlags .

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ć narysowyny tekst.

text: String

Tekst do rysowania.

font: Font

Element Font do zastosowania do narysowanego tekstu.

pt: Point

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

foreColor: Color

Element Color do zastosowania do narysowanego tekstu.

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 systemu Windows i wywołaj RenderText1 metodę z procedury obsługi zdarzeń formularza Paint , 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 parametr ma null wartość lub forecolor jest Color.Empty, DrawText metoda narysuje tekst w czcionki lub kolorze aktualnie wybranym w kontekście urządzenia określonym przez dc. Jeśli forecolor parametr ma Transparentwartość , 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ć narysowyny tekst.

text: ReadOnlySpan<Char>

Tekst do rysowania.

font: Font

Element Font do zastosowania do narysowanego tekstu.

bounds: Rectangle

Obiekt Rectangle reprezentujący granice tekstu.

foreColor: Color

Element Color do zastosowania do narysowanego tekstu.

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ślonych instrukcji dotyczących kontekstu urządzenia, czcionki, koloru i 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)