Udostępnij za pośrednictwem


TextRenderer.DrawText Metoda

Definicja

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

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

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

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 .

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

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.

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

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 .

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

dc to null.

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

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 DrawTextMeasureText , 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

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

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 .

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

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

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 DrawTextMeasureText , które przyjmują Size parametr i TextFormatFlags . Aby zapoznać się z przykładem, zobacz MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

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.

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 .

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 tekstu rysowanego.

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

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.

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 .

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 tekstu rysowanego.

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

dc to null.

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

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

dc to null.

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

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

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

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 .

Zobacz też

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

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.

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 .

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.

Zobacz też

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

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)

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.

flags
TextFormatFlags

Bitowa kombinacja TextFormatFlags wartości.

Wyjątki

dc to null.

Dotyczy