TextRenderer.DrawText Yöntem

Tanım

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

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

dc, null değeridir.

Şunlara uygulanır

Windows Desktop 9 ve diğer sürümler
Ürün Sürümler
Windows Desktop 5, 6, 7, 8, 9

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, 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);

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

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);
}

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 MeasureTextTextFormatFlags ve parametrelerini alan Size sürümlerini DrawText kullanmanız gerekir. Örnek için bkz. MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)

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.

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

Şunlara uygulanır

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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, 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);

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

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ı RenderText7 yapın.

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);
}

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.

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 MeasureTextTextFormatFlags ve parametrelerini alan Size sürümlerini DrawText kullanmanız gerekir. Örnek için bkz. MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)

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.

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

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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

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

dc, null değeridir.

Şunlara uygulanır

Windows Desktop 9 ve diğer sürümler
Ürün Sürümler
Windows Desktop 5, 6, 7, 8, 9

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, 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);

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

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ı RenderText6 yapın.

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);
}

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 SizeTextFormatFlags parametresini alır. Örnek için bkz. MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)

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.

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

Şunlara uygulanır

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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, 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);

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

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ı RenderText4 yapın.

private void RenderText4(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text.", this.Font,
        new Rectangle(10, 10, 70, 70), SystemColors.ControlText, 
        SystemColors.ControlDark);
}

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.

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.

Şunlara uygulanır

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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, 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);

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

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ı RenderText5 yapın.

private void RenderText5(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Some text.",
        this.Font, new Point(10, 10), SystemColors.ControlText, TextFormatFlags.Bottom);
}

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

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.

ç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

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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, 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);

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

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ı RenderText3 yapın.

private void RenderText3(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text", this.Font,
        new Point(10, 10), Color.Red, Color.PowderBlue);
}

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.

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.

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

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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

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

dc, null değeridir.

Şunlara uygulanır

Windows Desktop 9 ve diğer sürümler
Ürün Sürümler
Windows Desktop 5, 6, 7, 8, 9

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

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

dc, null değeridir.

Şunlara uygulanır

Windows Desktop 9 ve diğer sürümler
Ürün Sürümler
Windows Desktop 5, 6, 7, 8, 9

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

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

dc, null değeridir.

Şunlara uygulanır

Windows Desktop 9 ve diğer sürümler
Ürün Sürümler
Windows Desktop 5, 6, 7, 8, 9

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

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

dc, null değeridir.

Şunlara uygulanır

Windows Desktop 9 ve diğer sürümler
Ürün Sürümler
Windows Desktop 5, 6, 7, 8, 9

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, 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);

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

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ı RenderText2 yapın.

private void RenderText2(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text", this.Font,
        new Rectangle(10, 10, 100, 100), SystemColors.ControlText);
}

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.

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.

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.

Ayrıca bkz.

Şunlara uygulanır

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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, 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);

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

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ı RenderText1 yapın.

private void RenderText1(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text", this.Font, 
        new Point(10, 10), SystemColors.ControlText);
}

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.

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.

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.

Ayrıca bkz.

Şunlara uygulanır

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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

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

dc, null değeridir.

Şunlara uygulanır

Windows Desktop 9 ve diğer sürümler
Ürün Sürümler
Windows Desktop 5, 6, 7, 8, 9

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

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.

flags
TextFormatFlags

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

Özel durumlar

dc, null değeridir.

Şunlara uygulanır

Windows Desktop 9 ve diğer sürümler
Ürün Sürümler
Windows Desktop 5, 6, 7, 8, 9