TextRenderer.DrawText Yöntem

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Belirtilen cihaz bağlamını, rengini ve yazı tipini kullanarak belirtilen konumda belirtilen metni çizer.

Aşırı Yüklemeler

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)	Belirtilen cihaz bağlamını, yazı tipini ve rengi kullanarak belirtilen konumda belirtilen metni çizer.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)	Belirtilen cihaz bağlamı, yazı tipi, renk, arka renk ve biçimlendirme yönergelerini kullanarak belirtilen sınırlar içinde belirtilen metni çizer.
DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)	Belirtilen cihaz bağlamı, yazı tipi, renk, arka renk ve biçimlendirme yönergelerini kullanarak belirtilen konumda belirtilen metni çizer.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)	Belirtilen cihaz bağlamı, yazı tipi, renk, arka renk ve biçimlendirme yönergelerini kullanarak belirtilen konumda belirtilen metni çizer.
DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)	Belirtilen cihaz bağlamı, yazı tipi, renk ve biçimlendirme yönergelerini kullanarak belirtilen sınırların içinde belirtilen metni çizer.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)	Belirtilen cihaz bağlamını, yazı tipini, rengini ve arka rengini kullanarak belirtilen sınırların içinde belirtilen metni çizer.
DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)	Belirtilen cihaz bağlamını, yazı tipini, rengini ve biçimlendirme yönergelerini kullanarak belirtilen konumda belirtilen metni çizer.
DrawText(IDeviceContext, String, Font, Point, Color, Color)	Belirtilen cihaz bağlamını, yazı tipini, rengini ve arka rengini kullanarak belirtilen konumda belirtilen metni çizer.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)	Belirtilen cihaz bağlamı, yazı tipi, renk, arka renk ve biçimlendirme yönergelerini kullanarak belirtilen sınırlar içinde belirtilen metni çizer.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)	Belirtilen cihaz bağlamını, yazı tipini, rengini ve arka rengini kullanarak belirtilen sınırların içinde belirtilen metni çizer.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)	Belirtilen cihaz bağlamını, yazı tipini, rengini ve biçimlendirme yönergelerini kullanarak belirtilen konumda belirtilen metni çizer.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)	Belirtilen cihaz bağlamını, yazı tipini, rengini ve arka rengini kullanarak belirtilen konumda belirtilen metni çizer.
DrawText(IDeviceContext, String, Font, Rectangle, Color)	Belirtilen cihaz bağlamını, yazı tipini ve rengi kullanarak belirtilen sınırların içinde belirtilen metni çizer.
DrawText(IDeviceContext, String, Font, Point, Color)	Belirtilen cihaz bağlamını, yazı tipini ve rengi kullanarak belirtilen konumda belirtilen metni çizer.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)	Belirtilen cihaz bağlamını, yazı tipini ve rengi kullanarak belirtilen sınırların içinde belirtilen metni çizer.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, TextFormatFlags)	Belirtilen cihaz bağlamı, yazı tipi, renk ve biçimlendirme yönergelerini kullanarak belirtilen sınırların içinde belirtilen metni çizer.

Açıklamalar

sınıfı tarafından TextRenderer sunulan metin işleme, GDI metin işlemeyi temel alır ve Windows Forms yazdırma için desteklenmez. Bunun yerine sınıfının yöntemlerini Graphics kullanınDrawString.

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

Belirtilen cihaz bağlamını, yazı tipini ve rengi kullanarak belirtilen konumda belirtilen metni çizer.

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)

Parametreler

dc: IDeviceContext

Metnin çizildiği cihaz bağlamı.

text: ReadOnlySpan<Char>

Çizecek metin.

font: Font

Font Çizilen metne uygulanacak olan.

pt: Point

Çizilen Point metnin sol üst köşesini temsil eden.

foreColor: Color

Color Çizilen metne uygulanacak olan.

Özel durumlar

ArgumentNullException

dc, null değeridir.

Şunlara uygulanır

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

Belirtilen cihaz bağlamı, yazı tipi, renk, arka renk ve biçimlendirme yönergelerini kullanarak belirtilen sınırlar içinde belirtilen metni çizer.

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)

Parametreler

dc: IDeviceContext

Metnin çizildiği cihaz bağlamı.

text: String

Çizecek metin.

font: Font

Font Çizilen metne uygulanacak olan.

bounds: Rectangle

Metnin Rectangle sınırlarını temsil eden.

foreColor: Color

Color metne uygulanacak olan.

backColor: Color

ile Colorboundstemsil edilen alana uygulanacaktır.

flags: TextFormatFlags

Değerlerin bit düzeyinde birleşimi TextFormatFlags .

Özel durumlar

ArgumentNullException

dc, null değeridir.

Örnekler

Aşağıdaki kod örneğinde yönteminin nasıl kullanılacağı gösterilmektedir DrawText . Bu örneği çalıştırmak için, kodu bir Windows Formuna yapıştırın ve olarak geçirerek ePaintEventArgsformun Paint olay işleyicisinden çağrısı RenderText8 yapın.

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

Açıklamalar

backcolor parametresi, sırasıyla veya nullbackcolorfontEmptyforecolor ise parametresinin.bounds içindeki alana uygulanır; DrawText yöntemi, tarafından dcbelirtilen cihaz bağlamında seçili durumdaki yazı tipinde veya renkteki metni çizer. ise forecolorTransparent, metin çizilmeyecektir.

Parametre alan TextFormatFlags aşırı yüklemelerden birini DrawText kullanarak metnin nasıl çizildiğini değiştirebilirsiniz. Örneğin, öğesinin TextRenderer varsayılan davranışı, köşeli karakter sayısını karşılamak için çizilen metnin sınırlayıcı dikdörtgenine doldurma eklemektir. Bu fazladan boşluklar olmadan bir metin satırı çizmeniz gerekiyorsa ve MeasureText TextFormatFlags ve parametrelerini alan Size sürümlerini DrawText kullanmanız gerekir. Örnek için bkz. MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)

TextRenderer çizilmiş metne sekme durakları eklemeyi desteklemez, ancak bayrağını kullanarak ExpandTabs mevcut sekme duraklarını genişletebilirsiniz.

Şunlara uygulanır

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

Belirtilen cihaz bağlamı, yazı tipi, renk, arka renk ve biçimlendirme yönergelerini kullanarak belirtilen konumda belirtilen metni çizer.

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)

Parametreler

dc: IDeviceContext

Metnin çizildiği cihaz bağlamı.

text: String

Çizecek metin.

font: Font

Font Çizilen metne uygulanacak olan.

pt: Point

Çizilen Point metnin sol üst köşesini temsil eden.

foreColor: Color

Color metne uygulanacak olan.

backColor: Color

Çizilen Color metnin arka plan alanına uygulanacak.

flags: TextFormatFlags

Değerlerin bit düzeyinde birleşimi TextFormatFlags .

Özel durumlar

ArgumentNullException

dc, null değeridir.

Örnekler

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

Açıklamalar

backcolor parametresi, çizilen metni içeren dikdörtgen alana uygulanır. veya sırasıyla veya Emptyforecolor ise fontnull, DrawText yöntemi metni tarafından dcbelirtilen cihaz bağlamında seçili durumdaki yazı tipine veya renge çizer. ise forecolorTransparent, metin çizilmeyecektir.

TextRenderer çizilmiş metne sekme durakları eklemeyi desteklemez, ancak bayrağını kullanarak ExpandTabs mevcut sekme duraklarını genişletebilirsiniz.

Not

DrawText Çizilen metnin sol üst köşesi olarak bir Point belirten yöntemler Windows 2000'de doğru şekilde işlenmez. Uygulamanız Windows 2000 çalıştıran makinelerde kullanılmak üzere tasarlandıysa, çizilen metnin sınırları için bir Rectangle belirten yöntemlerden birini DrawText kullanmanız gerekir.

Şunlara uygulanır

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

Belirtilen cihaz bağlamı, yazı tipi, renk, arka renk ve biçimlendirme yönergelerini kullanarak belirtilen konumda belirtilen metni çizer.

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)

Parametreler

dc: IDeviceContext

Metnin çizildiği cihaz bağlamı.

text: ReadOnlySpan<Char>

Çizecek metin.

font: Font

Font Çizilen metne uygulanacak olan.

pt: Point

Çizilen Point metnin sol üst köşesini temsil eden.

foreColor: Color

Color Çizilen metne uygulanacak olan.

backColor: Color

Çizilen Color metnin arka plan alanına uygulanacak.

flags: TextFormatFlags

Değerlerin bit düzeyinde birleşimi TextFormatFlags .

Özel durumlar

ArgumentNullException

dc, null değeridir.

ArgumentOutOfRangeException

ModifyString ayarlanır.

Şunlara uygulanır

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

Belirtilen cihaz bağlamını, yazı tipini, rengini ve biçimlendirme yönergelerini kullanarak belirtilen sınırların içinde belirtilen metni çizer.

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)

Parametreler

dc: IDeviceContext

Metnin çizildiği cihaz bağlamı.

text: String

Çizecek metin.

font: Font

Font Çizilen metne uygulanacak olan.

bounds: Rectangle

Metnin Rectangle sınırlarını temsil eden.

foreColor: Color

Color Çizilen metne uygulanacak olan.

flags: TextFormatFlags

Değerlerin bit düzeyinde birleşimi TextFormatFlags .

Özel durumlar

ArgumentNullException

dc, null değeridir.

Örnekler

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

Açıklamalar

veya color sırasıyla veya Emptyise nullfont, DrawText yöntemi metni tarafından dcbelirtilen cihaz bağlamında seçili olan yazı tipinde veya renkte çizer. ise forecolorTransparent, metin çizilmeyecektir.

Parametre alan TextFormatFlags aşırı yüklemelerden birini DrawText kullanarak metnin nasıl çizildiğini değiştirebilirsiniz. Örneğin, öğesinin TextRenderer varsayılan davranışı, çizilen metnin sınırlayıcı dikdörtgenine doldurma eklemektir. Bu fazladan boşluklar olmadan bir metin satırı çizmeniz gerekiyorsa ve MeasureText sürümlerini DrawText kullanmanız gerekir. Bu da ve Size TextFormatFlags parametresini alır. Örnek için bkz. MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)

çizilmiş TextRenderer metne sekme durakları eklemeyi desteklemez, ancak bayrağını ExpandTabs kullanarak mevcut sekme duraklarını genişletebilirsiniz.

Şunlara uygulanır

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

Belirtilen cihaz bağlamını, yazı tipini, rengini ve arka rengini kullanarak belirtilen sınırların içinde belirtilen metni çizer.

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)

Parametreler

dc: IDeviceContext

Metnin çizildiği cihaz bağlamı.

text: String

Çizecek metin.

font: Font

Font Çizilen metne uygulanacak olan.

bounds: Rectangle

Metnin Rectangle sınırlarını temsil eden.

foreColor: Color

Color Çizilen metne uygulanacak olan.

backColor: Color

ile Colorboundstemsil edilen alana uygulanacaktır.

Özel durumlar

ArgumentNullException

dc, null değeridir.

Örnekler

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

Açıklamalar

backColor parametresi, parametresi içindeki alana bounds uygulanır. backcolor sırasıyla fontveya forecolor veya Emptyisenull, DrawText yöntemi metni tarafından dcbelirtilen cihaz bağlamında seçili olan yazı tipinde veya renkte çizer. ise forecolorTransparent, metin çizilmeyecektir.

Bu yöntem, parametresi tarafından belirtilen dikdörtgende yatay ve dikey olarak ortalanmış metinle bounds sonuçlanır. Metnin nasıl çizildiğini değiştirmek için parametre türü alan bir TextFormatFlags sürümünü DrawText kullanın.

Şunlara uygulanır

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

Belirtilen cihaz bağlamını, yazı tipini, rengini ve biçimlendirme yönergelerini kullanarak belirtilen konumda belirtilen metni çizer.

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)

Parametreler

dc: IDeviceContext

Metnin çizildiği cihaz bağlamı.

text: String

Çizecek metin.

font: Font

Font Çizilen metne uygulanacak olan.

pt: Point

Point Çizilen metnin sol üst köşesini temsil eden.

foreColor: Color

Color Çizilen metne uygulanacak olan.

flags: TextFormatFlags

Değerlerin bit düzeyinde birleşimi TextFormatFlags .

Özel durumlar

ArgumentNullException

dc, null değeridir.

Örnekler

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

Açıklamalar

Parametre alan TextFormatFlags aşırı yüklemelerden birini DrawText kullanarak metnin nasıl çizildiğini değiştirebilirsiniz. Örneğin, öğesinin TextRenderer varsayılan davranışı, çizilen metnin sınırlayıcı dikdörtgenine doldurma eklemektir. Bu fazladan boşluklar olmadan bir metin satırı çizmeniz gerekiyorsa ve MeasureText sürümlerini DrawText kullanmanız gerekir. Bu da ve Size TextFormatFlags parametresini alır. Örnek için bkz. MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)

backColor parametresi, parametresi içindeki alana bounds uygulanır. veya forecolor sırasıyla veya Color.Emptyise nullfont, DrawText yöntemi metni tarafından dcbelirtilen cihaz bağlamında seçili olan yazı tipinde veya renkte çizer. ise forecolorTransparent, metin çizilmeyecektir.

çizilmiş TextRenderer metne sekme durakları eklemeyi desteklemez, ancak bayrağını ExpandTabs kullanarak mevcut sekme duraklarını genişletebilirsiniz.

Not

DrawText Çizilen metnin sol üst köşesi olarak bir Point belirten yöntemler Windows 2000'de doğru işlenmez. Uygulamanız Windows 2000 çalıştıran makinelerde kullanılmak üzere tasarlanmışsa, çizilen metnin sınırları için bir Rectangle belirten yöntemlerden birini DrawText kullanmanız gerekir.

Şunlara uygulanır

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

Belirtilen cihaz bağlamını, yazı tipini, rengini ve arka rengini kullanarak belirtilen konumda belirtilen metni çizer.

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)

Parametreler

dc: IDeviceContext

Metnin çizildiği cihaz bağlamı.

text: String

Çizecek metin.

font: Font

Font Çizilen metne uygulanacak olan.

pt: Point

Point Çizilen metnin sol üst köşesini temsil eden.

foreColor: Color

Color Çizilen metne uygulanacak olan.

backColor: Color

Çizilen Color metnin arka plan alanına uygulanacak.

Özel durumlar

ArgumentNullException

dc, null değeridir.

Örnekler

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

Açıklamalar

backColor parametresi, çizilen metni içeren dikdörtgen alana uygulanır. backcolor sırasıyla fontveya forecolor veya Color.Emptyisenull, DrawText yöntemi metni tarafından dcbelirtilen cihaz bağlamında seçili olan yazı tipinde veya renkte çizer. ise forecolorTransparent, metin çizilmeyecektir.

Parametre alan TextFormatFlags aşırı yüklemelerden birini DrawText kullanarak metnin nasıl çizildiğini değiştirebilirsiniz.

Not

Şunlara uygulanır

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

Belirtilen cihaz bağlamını, yazı tipini, rengi, arka rengi ve biçimlendirme yönergelerini kullanarak belirtilen sınırların içinde belirtilen metni çizer.

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)

Parametreler

dc: IDeviceContext

Metnin çizildiği cihaz bağlamı.

text: ReadOnlySpan<Char>

Çizecek metin.

font: Font

Font Çizilen metne uygulanacak olan.

bounds: Rectangle

Metnin Rectangle sınırlarını temsil eden.

foreColor: Color

Color Çizilen metne uygulanacak olan.

backColor: Color

Çizilen Color metnin arka plan alanına uygulanacak.

flags: TextFormatFlags

Değerlerin bit düzeyinde birleşimi TextFormatFlags .

Özel durumlar

ArgumentNullException

dc, null değeridir.

ArgumentOutOfRangeException

ModifyString ayarlanır.

Şunlara uygulanır

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

Belirtilen cihaz bağlamını, yazı tipini, rengini ve arka rengini kullanarak belirtilen sınırların içinde belirtilen metni çizer.

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)

Parametreler

dc: IDeviceContext

Metnin çizildiği cihaz bağlamı.

text: ReadOnlySpan<Char>

Çizecek metin.

font: Font

Font Çizilen metne uygulanacak olan.

bounds: Rectangle

Metnin Rectangle sınırlarını temsil eden.

foreColor: Color

Color Çizilen metne uygulanacak olan.

backColor: Color

Çizilen Color metnin arka plan alanına uygulanacak.

Özel durumlar

ArgumentNullException

dc, null değeridir.

Şunlara uygulanır

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

Belirtilen cihaz bağlamını, yazı tipini, rengini ve biçimlendirme yönergelerini kullanarak belirtilen konumda belirtilen metni çizer.

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)

Parametreler

dc: IDeviceContext

Metnin çizildiği cihaz bağlamı.

text: ReadOnlySpan<Char>

Çizecek metin.

font: Font

Font Çizilen metne uygulanacak olan.

pt: Point

Point Çizilen metnin sol üst köşesini temsil eden.

foreColor: Color

Color Çizilen metne uygulanacak olan.

flags: TextFormatFlags

Değerlerin bit düzeyinde birleşimi TextFormatFlags .

Özel durumlar

ArgumentNullException

dc, null değeridir.

ArgumentOutOfRangeException

ModifyString ayarlanır.

Şunlara uygulanır

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

Belirtilen cihaz bağlamını, yazı tipini, rengini ve arka rengini kullanarak belirtilen konumda belirtilen metni çizer.

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)

Parametreler

dc: IDeviceContext

Metnin çizildiği cihaz bağlamı.

text: ReadOnlySpan<Char>

Çizecek metin.

font: Font

Font Çizilen metne uygulanacak olan.

pt: Point

Point Çizilen metnin sol üst köşesini temsil eden.

foreColor: Color

Color Çizilen metne uygulanacak olan.

backColor: Color

Çizilen Color metnin arka plan alanına uygulanacak.

Özel durumlar

ArgumentNullException

dc, null değeridir.

Şunlara uygulanır

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

Belirtilen cihaz bağlamını, yazı tipini ve rengi kullanarak belirtilen sınırların içinde belirtilen metni çizer.

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)

Parametreler

dc: IDeviceContext

Metnin çizildiği cihaz bağlamı.

text: String

Çizecek metin.

font: Font

Font Çizilen metne uygulanacak olan.

bounds: Rectangle

Metnin Rectangle sınırlarını temsil eden.

foreColor: Color

Color Çizilen metne uygulanacak olan.

Özel durumlar

ArgumentNullException

dc, null değeridir.

Örnekler

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

Açıklamalar

veya forecolor sırasıyla veya Color.Emptyise nullfont, DrawText yöntemi metni tarafından dcbelirtilen cihaz bağlamında seçili olan yazı tipinde veya renkte çizer. ise forecolorTransparent, metin çizilmeyecektir.

Ayrıca bkz.

IDeviceContext

Şunlara uygulanır

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

Belirtilen cihaz bağlamını, yazı tipini ve rengini kullanarak belirtilen konumda belirtilen metni çizer.

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)

Parametreler

dc: IDeviceContext

Metnin çizildiği cihaz bağlamı.

text: String

Çizecek metin.

font: Font

Font Çizilen metne uygulanacak olan.

pt: Point

Point Çizilen metnin sol üst köşesini temsil eden.

foreColor: Color

Color Çizilen metne uygulanacak olan.

Özel durumlar

ArgumentNullException

dc, null değeridir.

Örnekler

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

Açıklamalar

Parametre alan TextFormatFlags aşırı yüklemelerden birini DrawText kullanarak metnin nasıl çizildiğini değiştirebilirsiniz.

null veya fontforecolor ise Color.Emptyyöntemi, DrawText tarafından dcbelirtilen cihaz bağlamında seçili durumdaki yazı tipinde veya renkteki metni çizer. ise forecolorTransparent, metin çizilmeyecektir.

Not

Ayrıca bkz.

IDeviceContext

Şunlara uygulanır

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

Belirtilen cihaz bağlamını, yazı tipini ve rengi kullanarak belirtilen sınırların içinde belirtilen metni çizer.

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)

Parametreler

dc: IDeviceContext

Metnin çizildiği cihaz bağlamı.

text: ReadOnlySpan<Char>

Çizecek metin.

font: Font

Font Çizilen metne uygulanacak olan.

bounds: Rectangle

Metnin Rectangle sınırlarını temsil eden.

foreColor: Color

Color Çizilen metne uygulanacak olan.

Özel durumlar

ArgumentNullException

dc, null değeridir.

Şunlara uygulanır

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

Belirtilen cihaz bağlamını, yazı tipini, rengini ve biçimlendirme yönergelerini kullanarak belirtilen sınırların içinde belirtilen metni çizer.

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)