Graphics.TextContrast Property
.NET Framework 3.0
Gets or sets the gamma correction value for rendering text.
Namespace: System.Drawing
Assembly: System.Drawing (in system.drawing.dll)
Assembly: System.Drawing (in system.drawing.dll)
/** @property */ public int get_TextContrast () /** @property */ public void set_TextContrast (int value)
public function get TextContrast () : int public function set TextContrast (value : int)
Not applicable.
Property Value
The gamma correction value used for rendering antialiased and ClearType text.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: