Graphics.TextRenderingHint Property
.NET Framework 2.0
Gets or sets the rendering mode for text associated with this Graphics.
Namespace: System.Drawing
Assembly: System.Drawing (in system.drawing.dll)
Assembly: System.Drawing (in system.drawing.dll)
public: property TextRenderingHint TextRenderingHint { TextRenderingHint get (); void set (TextRenderingHint value); }
/** @property */ public TextRenderingHint get_TextRenderingHint () /** @property */ public void set_TextRenderingHint (TextRenderingHint value)
public function get TextRenderingHint () : TextRenderingHint public function set TextRenderingHint (value : TextRenderingHint)
Not applicable.
Property Value
One of the TextRenderingHint values.The following code example demonstrates the use of the TextRenderingHint and TextContrast properties.
This example is designed to be used with Windows Forms. Paste the code into a form and call the ChangeTextRenderingHintAndTextContrast method when handling the form's Paint event, passing e as PaintEventArgs.
private: void ChangeTextRenderingHintAndTextContrast( PaintEventArgs^ e ) { // Retrieve the graphics object. Graphics^ formGraphics = e->Graphics; // Declare a new font. System::Drawing::Font^ myFont = gcnew System::Drawing::Font( FontFamily::GenericSansSerif,20,FontStyle::Regular ); // Set the TextRenderingHint property. formGraphics->TextRenderingHint = System::Drawing::Text::TextRenderingHint::SingleBitPerPixel; // Draw the string. formGraphics->DrawString( "Hello World", myFont, Brushes::Firebrick, 20.0F, 20.0F ); // Change the TextRenderingHint property. formGraphics->TextRenderingHint = System::Drawing::Text::TextRenderingHint::AntiAliasGridFit; // Draw the string again. formGraphics->DrawString( "Hello World", myFont, Brushes::Firebrick, 20.0F, 60.0F ); // Set the text contrast to a high-contrast setting. formGraphics->TextContrast = 0; // Draw the string. formGraphics->DrawString( "Hello World", myFont, Brushes::DodgerBlue, 20.0F, 100.0F ); // Set the text contrast to a low-contrast setting. formGraphics->TextContrast = 12; // Draw the string again. formGraphics->DrawString( "Hello World", myFont, Brushes::DodgerBlue, 20.0F, 140.0F ); // Dispose of the font object. delete myFont; }
private void ChangeTextRenderingHintAndTextContrast(PaintEventArgs e)
{
// Retrieve the graphics object.
Graphics formGraphics = e.get_Graphics();
// Declare a new font.
Font myFont = new Font(FontFamily.get_GenericSansSerif(),
20, FontStyle.Regular);
// Set the TextRenderingHint property.
formGraphics.set_TextRenderingHint(System.Drawing.Text.
TextRenderingHint.SingleBitPerPixel);
// Draw the string.
formGraphics.DrawString("Hello World", myFont,
Brushes.get_Firebrick(), 20, 20);
// Change the TextRenderingHint property.
formGraphics.set_TextRenderingHint(System.Drawing.Text.
TextRenderingHint.AntiAliasGridFit);
// Draw the string again.
formGraphics.DrawString("Hello World", myFont,
Brushes.get_Firebrick(), 20, 60);
// Set the text contrast to a high-contrast setting.
formGraphics.set_TextContrast(0);
// Draw the string.
formGraphics.DrawString("Hello World", myFont,
Brushes.get_DodgerBlue(), 20, 100);
// Set the text contrast to a low-contrast setting.
formGraphics.set_TextContrast(12);
// Draw the string again.
formGraphics.DrawString("Hello World", myFont,
Brushes.get_DodgerBlue(), 20, 140);
// Dispose of the font object.
myFont.Dispose();
} //ChangeTextRenderingHintAndTextContrast
Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.Community Additions
ADD
Show: