TextRenderer.DrawText Metode

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menggambar teks yang ditentukan di lokasi yang ditentukan, menggunakan konteks, warna, dan font perangkat yang ditentukan.

Overload

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)	Gambar teks yang ditentukan di lokasi yang ditentukan menggunakan konteks perangkat, font, dan warna yang ditentukan.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)	Menggambar teks yang ditentukan dalam batas yang ditentukan menggunakan konteks perangkat, font, warna, warna, warna belakang, dan instruksi pemformatan yang ditentukan.
DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)	Menggambar teks yang ditentukan di lokasi yang ditentukan menggunakan konteks perangkat, font, warna, warna belakang, dan instruksi pemformatan yang ditentukan.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)	Menggambar teks yang ditentukan di lokasi yang ditentukan menggunakan konteks perangkat, font, warna, warna belakang, dan instruksi pemformatan yang ditentukan.
DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)	Menggambar teks yang ditentukan dalam batas yang ditentukan menggunakan konteks perangkat, font, warna, dan instruksi pemformatan yang ditentukan.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)	Menggambar teks yang ditentukan dalam batas yang ditentukan menggunakan konteks perangkat, font, warna, dan warna belakang yang ditentukan.
DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)	Gambar teks yang ditentukan di lokasi yang ditentukan menggunakan konteks perangkat, font, warna, dan instruksi pemformatan yang ditentukan.
DrawText(IDeviceContext, String, Font, Point, Color, Color)	Menggambar teks yang ditentukan pada lokasi yang ditentukan, menggunakan konteks perangkat, font, warna, dan warna belakang yang ditentukan.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)	Menggambar teks yang ditentukan dalam batas yang ditentukan menggunakan konteks perangkat, font, warna, warna, warna belakang, dan instruksi pemformatan yang ditentukan.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)	Menggambar teks yang ditentukan dalam batas yang ditentukan menggunakan konteks perangkat, font, warna, dan warna belakang yang ditentukan.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)	Gambar teks yang ditentukan di lokasi yang ditentukan menggunakan konteks perangkat, font, warna, dan instruksi pemformatan yang ditentukan.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)	Menggambar teks yang ditentukan pada lokasi yang ditentukan, menggunakan konteks perangkat, font, warna, dan warna belakang yang ditentukan.
DrawText(IDeviceContext, String, Font, Rectangle, Color)	Menggambar teks yang ditentukan dalam batas yang ditentukan, menggunakan konteks perangkat, font, dan warna yang ditentukan.
DrawText(IDeviceContext, String, Font, Point, Color)	Gambar teks yang ditentukan di lokasi yang ditentukan menggunakan konteks perangkat, font, dan warna yang ditentukan.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)	Menggambar teks yang ditentukan dalam batas yang ditentukan, menggunakan konteks perangkat, font, dan warna yang ditentukan.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, TextFormatFlags)	Menggambar teks yang ditentukan dalam batas yang ditentukan menggunakan konteks perangkat, font, warna, dan instruksi pemformatan yang ditentukan.

Keterangan

Penyajian teks yang ditawarkan oleh TextRenderer kelas didasarkan pada penyajian teks GDI dan tidak didukung untuk pencetakan dari Formulir Windows. Sebagai gantinya DrawString , gunakan metode Graphics kelas .

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

Gambar teks yang ditentukan di lokasi yang ditentukan menggunakan konteks perangkat, font, dan warna yang ditentukan.

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)

Parameter

dc: IDeviceContext

Konteks perangkat untuk menggambar teks.

text: ReadOnlySpan<Char>

Teks yang akan digambar.

font: Font

Font untuk diterapkan ke teks yang digambar.

pt: Point

Point yang mewakili sudut kiri atas teks yang digambar.

foreColor: Color

Color untuk diterapkan ke teks yang digambar.

Pengecualian

ArgumentNullException

dcadalah null.

Berlaku untuk

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

Menggambar teks yang ditentukan dalam batas yang ditentukan menggunakan konteks perangkat, font, warna, warna, warna belakang, dan instruksi pemformatan yang ditentukan.

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)

Parameter

dc: IDeviceContext

Konteks perangkat untuk menggambar teks.

text: String

Teks yang akan digambar.

font: Font

Font untuk diterapkan ke teks yang digambar.

bounds: Rectangle

Rectangle yang mewakili batas teks.

foreColor: Color

Color untuk diterapkan ke teks.

backColor: Color

Color untuk diterapkan ke area yang diwakili oleh bounds.

flags: TextFormatFlags

Kombinasi bitwise dari TextFormatFlags nilai.

Pengecualian

ArgumentNullException

dcadalah null.

Contoh

Contoh kode berikut menunjukkan cara menggunakan DrawText metode . Untuk menjalankan contoh ini, tempelkan kode ke dalam Formulir Windows dan panggil RenderText8 dari penanganan aktivitas formulir Paint , meneruskan e sebagai 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

Keterangan

Parameter backcolor diterapkan ke area dalam bounds parameter. Jika font, forecolor atau adalah atau backcolorEmptynull , masing-masing; DrawText metode akan menggambar teks dalam font atau warna yang saat ini dipilih dalam konteks perangkat yang ditentukan oleh .dc Jika forecolor adalah Transparent, teks tidak akan digambar.

Anda dapat memanipulasi bagaimana teks digambar dengan menggunakan salah DrawText satu kelebihan beban yang mengambil TextFormatFlags parameter. Misalnya, perilaku default adalah TextRenderer menambahkan padding ke persegi panjang pembatas teks yang digambar untuk mengakomodasi glyph yang membantai. Jika Anda perlu menggambar baris teks tanpa spasi tambahan ini, Anda harus menggunakan versi DrawText dan yang mengambil Size parameter dan TextFormatFlags MeasureText . Misalnya, lihat MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

TextRenderer tidak mendukung penambahan perhentian tab ke teks yang digambar, meskipun Anda dapat memperluas perhentian tab yang ada menggunakan ExpandTabs bendera .

Berlaku untuk

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

Menggambar teks yang ditentukan di lokasi yang ditentukan menggunakan konteks perangkat, font, warna, warna belakang, dan instruksi pemformatan yang ditentukan.

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)

Parameter

dc: IDeviceContext

Konteks perangkat untuk menggambar teks.

text: String

Teks yang akan digambar.

font: Font

Font untuk diterapkan ke teks yang digambar.

pt: Point

Point yang mewakili sudut kiri atas teks yang digambar.

foreColor: Color

Color untuk diterapkan ke teks.

backColor: Color

Color untuk diterapkan ke area latar belakang teks yang digambar.

flags: TextFormatFlags

Kombinasi bitwise dari TextFormatFlags nilai.

Pengecualian

ArgumentNullException

dcadalah null.

Contoh

Contoh kode berikut menunjukkan cara menggunakan DrawText metode . Untuk menjalankan contoh ini, tempelkan kode ke dalam Formulir Windows dan panggil RenderText7 dari penanganan aktivitas formulir Paint , meneruskan e sebagai 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

Keterangan

Parameter backcolor diterapkan area persegi panjang yang berisi teks yang digambar. Jika font atau forecolor adalah null atau Empty, masing-masing; DrawText metode akan menggambar teks dalam font atau warna yang saat ini dipilih dalam konteks perangkat yang ditentukan oleh dc. Jika forecolor adalah Transparent, teks tidak akan digambar.

TextRenderer tidak mendukung penambahan perhentian tab ke teks yang digambar, meskipun Anda dapat memperluas perhentian tab yang ada menggunakan ExpandTabs bendera .

Catatan

Metode DrawText yang menentukan Point sebagai sudut kiri atas teks yang digambar tidak dirender dengan benar pada Windows 2000. Jika aplikasi Anda ditujukan untuk digunakan pada komputer yang menjalankan Windows 2000, Anda harus menggunakan salah DrawText satu metode yang menentukan Rectangle untuk batas teks yang digambar.

Berlaku untuk

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

Menggambar teks yang ditentukan di lokasi yang ditentukan menggunakan konteks perangkat, font, warna, warna belakang, dan instruksi pemformatan yang ditentukan.

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)

Parameter

dc: IDeviceContext

Konteks perangkat untuk menggambar teks.

text: ReadOnlySpan<Char>

Teks yang akan digambar.

font: Font

Font untuk diterapkan ke teks yang digambar.

pt: Point

Point yang mewakili sudut kiri atas teks yang digambar.

foreColor: Color

Color untuk diterapkan ke teks yang digambar.

backColor: Color

Color untuk diterapkan ke area latar belakang teks yang digambar.

flags: TextFormatFlags

Kombinasi bitwise dari TextFormatFlags nilai.

Pengecualian

ArgumentNullException

dcadalah null.

ArgumentOutOfRangeException

ModifyString diatur.

Berlaku untuk

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

Menggambar teks yang ditentukan dalam batas yang ditentukan menggunakan konteks perangkat, font, warna, dan instruksi pemformatan yang ditentukan.

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)

Parameter

dc: IDeviceContext

Konteks perangkat untuk menggambar teks.

text: String

Teks yang akan digambar.

font: Font

Font untuk diterapkan ke teks yang digambar.

bounds: Rectangle

Rectangle yang mewakili batas teks.

foreColor: Color

Color untuk diterapkan ke teks yang digambar.

flags: TextFormatFlags

Kombinasi bitwise dari TextFormatFlags nilai.

Pengecualian

ArgumentNullException

dcadalah null.

Contoh

Contoh kode berikut menunjukkan cara menggunakan DrawText metode . Untuk menjalankan contoh ini, tempelkan kode ke dalam Formulir Windows dan panggil RenderText6 dari penanganan aktivitas formulir Paint , meneruskan e sebagai 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

Keterangan

Jika font atau colornull adalah atau Empty, masing-masing; DrawText metode akan menggambar teks dalam font atau warna yang saat ini dipilih dalam konteks perangkat yang ditentukan oleh dc. Jika forecolor adalah Transparent, teks tidak akan digambar.

Anda dapat memanipulasi bagaimana teks digambar dengan menggunakan salah DrawText satu kelebihan beban yang mengambil TextFormatFlags parameter. Misalnya, perilaku default adalah TextRenderer menambahkan padding ke persegi panjang pembatas teks yang digambar untuk mengakomodasi glyph yang berlebihan. Jika Anda perlu menggambar baris teks tanpa spasi tambahan ini, Anda harus menggunakan versi DrawText dan yang mengambil Size parameter dan TextFormatFlags MeasureText . Misalnya, lihat MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

TextRenderer tidak mendukung penambahan perhentian tab untuk teks yang digambar, meskipun Anda dapat memperluas perhentian tab yang ada menggunakan ExpandTabs bendera .

Berlaku untuk

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

Menggambar teks yang ditentukan dalam batas yang ditentukan menggunakan konteks perangkat, font, warna, dan warna belakang yang ditentukan.

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)

Parameter

dc: IDeviceContext

Konteks perangkat untuk menggambar teks.

text: String

Teks yang akan digambar.

font: Font

Font untuk diterapkan ke teks yang digambar.

bounds: Rectangle

Rectangle yang mewakili batas teks.

foreColor: Color

Color untuk diterapkan ke teks yang digambar.

backColor: Color

Color untuk diterapkan ke area yang diwakili oleh bounds.

Pengecualian

ArgumentNullException

dcadalah null.

Contoh

Contoh kode berikut menunjukkan cara menggunakan DrawText metode . Untuk menjalankan contoh ini, tempelkan kode ke dalam Formulir Windows dan panggil RenderText4 dari penanganan aktivitas formulir Paint , meneruskan e sebagai 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

Keterangan

Parameter backColor diterapkan ke area dalam bounds parameter . Jika font, backcolor atau forecolor adalah null atau Empty, masing-masing; DrawText metode akan menggambar teks dalam font atau warna yang saat ini dipilih dalam konteks perangkat yang ditentukan oleh dc. Jika forecolor adalah Transparent, teks tidak akan digambar.

Metode ini akan menghasilkan teks yang dipusatkan secara horizontal dan vertikal dalam persegi panjang yang ditentukan oleh bounds parameter . Untuk mengubah cara teks digambar, gunakan versi DrawText yang mengambil TextFormatFlags jenis parameter.

Berlaku untuk

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

Menggambar teks yang ditentukan di lokasi yang ditentukan menggunakan konteks perangkat, font, warna, dan instruksi pemformatan yang ditentukan.

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)

Parameter

dc: IDeviceContext

Konteks perangkat untuk menggambar teks.

text: String

Teks yang akan digambar.

font: Font

Font untuk diterapkan ke teks yang digambar.

pt: Point

Point yang mewakili sudut kiri atas teks yang digambar.

foreColor: Color

Color untuk diterapkan ke teks yang digambar.

flags: TextFormatFlags

Kombinasi bitwise dari TextFormatFlags nilai.

Pengecualian

ArgumentNullException

dcadalah null.

Contoh

Contoh kode berikut menunjukkan cara menggunakan DrawText metode . Untuk menjalankan contoh ini, tempelkan kode ke dalam Formulir Windows dan panggil RenderText5 dari penanganan aktivitas formulir Paint , meneruskan e sebagai 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

Keterangan

Anda dapat memanipulasi bagaimana teks digambar dengan menggunakan salah DrawText satu kelebihan beban yang mengambil TextFormatFlags parameter. Misalnya, perilaku default adalah TextRenderer menambahkan padding ke persegi panjang pembatas teks yang digambar untuk mengakomodasi glyph yang berlebihan. Jika Anda perlu menggambar baris teks tanpa spasi tambahan ini, Anda harus menggunakan versi DrawText dan yang mengambil Size parameter dan TextFormatFlags MeasureText . Misalnya, lihat MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

Parameter backColor diterapkan ke area dalam bounds parameter . Jika font atau forecolornull adalah atau Color.Empty, masing-masing; DrawText metode akan menggambar teks dalam font atau warna yang saat ini dipilih dalam konteks perangkat yang ditentukan oleh dc. Jika forecolor adalah Transparent, teks tidak akan digambar.

TextRenderer tidak mendukung penambahan perhentian tab untuk teks yang digambar, meskipun Anda dapat memperluas perhentian tab yang ada menggunakan ExpandTabs bendera .

Catatan

Berlaku untuk

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

Menggambar teks yang ditentukan di lokasi yang ditentukan, menggunakan konteks perangkat, font, warna, dan warna belakang yang ditentukan.

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)

Parameter

dc: IDeviceContext

Konteks perangkat untuk menggambar teks.

text: String

Teks yang akan digambar.

font: Font

Font untuk diterapkan ke teks yang digambar.

pt: Point

Point yang mewakili sudut kiri atas teks yang digambar.

foreColor: Color

Color untuk diterapkan ke teks yang digambar.

backColor: Color

Color untuk diterapkan ke area latar belakang teks yang digambar.

Pengecualian

ArgumentNullException

dcadalah null.

Contoh

Contoh kode berikut menunjukkan cara menggunakan DrawText metode . Untuk menjalankan contoh ini, tempelkan kode ke dalam Formulir Windows dan panggil RenderText3 dari penanganan aktivitas formulir Paint , meneruskan e sebagai 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

Keterangan

Parameter backColor diterapkan ke area persegi panjang yang berisi teks yang digambar. Jika font, backcolor atau forecolor adalah null atau Color.Empty, masing-masing; DrawText metode akan menggambar teks dalam font atau warna yang saat ini dipilih dalam konteks perangkat yang ditentukan oleh dc. Jika forecolor adalah Transparent, teks tidak akan digambar.

Anda dapat memanipulasi bagaimana teks digambar dengan menggunakan salah DrawText satu kelebihan beban yang mengambil TextFormatFlags parameter.

Catatan

Berlaku untuk

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

Menggambar teks yang ditentukan dalam batas yang ditentukan menggunakan konteks perangkat, font, warna, warna, warna belakang, dan instruksi pemformatan yang ditentukan.

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)

Parameter

dc: IDeviceContext

Konteks perangkat untuk menggambar teks.

text: ReadOnlySpan<Char>

Teks yang akan digambar.

font: Font

Font untuk diterapkan ke teks yang digambar.

bounds: Rectangle

Rectangle yang mewakili batas teks.

foreColor: Color

Color untuk diterapkan ke teks yang digambar.

backColor: Color

Color untuk diterapkan ke area latar belakang teks yang digambar.

flags: TextFormatFlags

Kombinasi bitwise dari TextFormatFlags nilai.

Pengecualian

ArgumentNullException

dcadalah null.

ArgumentOutOfRangeException

ModifyString diatur.

Berlaku untuk

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

Menggambar teks yang ditentukan dalam batas yang ditentukan menggunakan konteks perangkat, font, warna, dan warna belakang yang ditentukan.

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)

Parameter

dc: IDeviceContext

Konteks perangkat untuk menggambar teks.

text: ReadOnlySpan<Char>

Teks yang akan digambar.

font: Font

Font untuk diterapkan ke teks yang digambar.

bounds: Rectangle

Rectangle yang mewakili batas teks.

foreColor: Color

Color untuk diterapkan ke teks yang digambar.

backColor: Color

Color untuk diterapkan ke area latar belakang teks yang digambar.

Pengecualian

ArgumentNullException

dcadalah null.

Berlaku untuk

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

Menggambar teks yang ditentukan di lokasi yang ditentukan menggunakan konteks perangkat, font, warna, dan instruksi pemformatan yang ditentukan.

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)

Parameter

dc: IDeviceContext

Konteks perangkat untuk menggambar teks.

text: ReadOnlySpan<Char>

Teks yang akan digambar.

font: Font

Font untuk diterapkan ke teks yang digambar.

pt: Point

Point yang mewakili sudut kiri atas teks yang digambar.

foreColor: Color

Color untuk diterapkan ke teks yang digambar.

flags: TextFormatFlags

Kombinasi bitwise dari TextFormatFlags nilai.

Pengecualian

ArgumentNullException

dcadalah null.

ArgumentOutOfRangeException

ModifyString diatur.

Berlaku untuk

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

Menggambar teks yang ditentukan di lokasi yang ditentukan, menggunakan konteks perangkat, font, warna, dan warna belakang yang ditentukan.

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)

Parameter

dc: IDeviceContext

Konteks perangkat untuk menggambar teks.

text: ReadOnlySpan<Char>

Teks yang akan digambar.

font: Font

Font untuk diterapkan ke teks yang digambar.

pt: Point

Point yang mewakili sudut kiri atas teks yang digambar.

foreColor: Color

Color untuk diterapkan ke teks yang digambar.

backColor: Color

Color untuk diterapkan ke area latar belakang teks yang digambar.

Pengecualian

ArgumentNullException

dcadalah null.

Berlaku untuk

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

Menggambar teks yang ditentukan dalam batas yang ditentukan, menggunakan konteks perangkat, font, dan warna yang ditentukan.

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)

Parameter

dc: IDeviceContext

Konteks perangkat untuk menggambar teks.

text: String

Teks yang akan digambar.

font: Font

Font untuk diterapkan ke teks yang digambar.

bounds: Rectangle

Rectangle yang mewakili batas teks.

foreColor: Color

Color untuk diterapkan ke teks yang digambar.

Pengecualian

ArgumentNullException

dcadalah null.

Contoh

Contoh kode berikut menunjukkan cara menggunakan DrawText metode . Untuk menjalankan contoh ini, tempelkan kode ke dalam Formulir Windows dan panggil RenderText2 dari penanganan aktivitas formulir Paint , meneruskan e sebagai 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

Keterangan

Jika font atau forecolornull adalah atau Color.Empty, masing-masing; DrawText metode akan menggambar teks dalam font atau warna yang saat ini dipilih dalam konteks perangkat yang ditentukan oleh dc. Jika forecolor adalah Transparent, teks tidak akan digambar.

Lihat juga

IDeviceContext

Berlaku untuk

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

Menggambar teks yang ditentukan di lokasi yang ditentukan menggunakan konteks perangkat, font, dan warna yang ditentukan.

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)

Parameter

dc: IDeviceContext

Konteks perangkat untuk menggambar teks.

text: String

Teks yang akan digambar.

font: Font

Font untuk diterapkan ke teks yang digambar.

pt: Point

Point yang mewakili sudut kiri atas teks yang digambar.

foreColor: Color

Color untuk diterapkan ke teks yang digambar.

Pengecualian

ArgumentNullException

dcadalah null.

Contoh

Contoh kode berikut menunjukkan cara menggunakan DrawText metode . Untuk menjalankan contoh ini, tempelkan kode ke dalam Formulir Windows dan panggil RenderText1 dari penanganan aktivitas formulir Paint , meneruskan e sebagai 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

Keterangan

Anda dapat memanipulasi bagaimana teks digambar dengan menggunakan salah DrawText satu kelebihan beban yang mengambil TextFormatFlags parameter.

Jika font adalah null atau forecolor , Color.Empty DrawText metode akan menggambar teks dalam font atau warna yang saat ini dipilih dalam konteks perangkat yang ditentukan oleh dc. Jika forecolor adalah Transparent, teks tidak akan digambar.

Catatan

Lihat juga

IDeviceContext

Berlaku untuk

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

Menggambar teks yang ditentukan dalam batas yang ditentukan, menggunakan konteks perangkat, font, dan warna yang ditentukan.

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)

Parameter

dc: IDeviceContext

Konteks perangkat untuk menggambar teks.

text: ReadOnlySpan<Char>

Teks yang akan digambar.

font: Font

Font untuk diterapkan ke teks yang digambar.

bounds: Rectangle

Rectangle yang mewakili batas teks.

foreColor: Color

Color untuk diterapkan ke teks yang digambar.

Pengecualian

ArgumentNullException

dcadalah null.

Berlaku untuk

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

Menggambar teks yang ditentukan dalam batas yang ditentukan menggunakan konteks perangkat, font, warna, dan instruksi pemformatan yang ditentukan.

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)

Parameter

dc: IDeviceContext

Konteks perangkat untuk menggambar teks.

text: ReadOnlySpan<Char>

Teks yang akan digambar.

font: Font

Font untuk diterapkan ke teks yang digambar.

bounds: Rectangle

Rectangle yang mewakili batas teks.

foreColor: Color

Color untuk diterapkan ke teks yang digambar.

flags: TextFormatFlags

Kombinasi bitwise dari TextFormatFlags nilai.

Pengecualian

ArgumentNullException

dcadalah null.

ArgumentOutOfRangeException

ModifyString diatur.

Berlaku untuk

Bagikan melalui

TextRenderer.DrawText Metode

Definisi

Overload

Keterangan

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

Parameter

Pengecualian

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Berlaku untuk

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

Parameter

Pengecualian

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Berlaku untuk

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

Parameter

Pengecualian

Berlaku untuk

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

Parameter

Pengecualian

Berlaku untuk

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

Parameter

Pengecualian

Berlaku untuk

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

Parameter

Pengecualian

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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