TextRenderingHint Enumeración
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica la calidad de representación de texto.
public enum class TextRenderingHintpublic enum TextRenderingHinttype TextRenderingHint = Public Enum TextRenderingHint- Herencia
Campos
| AntiAlias | 4 | Cada carácter se dibuja utilizando su mapa de bits de glifo con suavizado de contorno sin indicaciones. Debido al suavizado de contorno, la calidad es mejor. Las diferencias de ancho del pie pueden ser apreciables porque se han desactivado las indicaciones. |
| AntiAliasGridFit | 3 | Cada carácter se dibuja utilizando su mapa de bits de glifo con suavizado de contorno con indicaciones. Debido al suavizado de contorno, la calidad es mucho mejor, pero se produce un costo de rendimiento mayor. |
| ClearTypeGridFit | 5 | Cada carácter se dibuja utilizando su mapa de bits de glifo de ClearType con indicaciones. Configuración de mayor calidad. Se utiliza para beneficiarse de las características de fuente de ClearType. |
| SingleBitPerPixel | 2 | Cada carácter se dibuja utilizando su mapa de bits de glifo. No se utilizan indicaciones. |
| SingleBitPerPixelGridFit | 1 | Cada carácter se dibuja utilizando su mapa de bits de glifo. Se utilizan indicaciones para mejorar la apariencia de caracteres en los pies y la curvatura. |
| SystemDefault | 0 | Cada carácter se dibuja utilizando su mapa de bits de glifo, con la indicación de representación predeterminada del sistema. El texto se dibuja utilizando cualquier configuración de suavizado de fuente que el usuario haya seleccionado para el sistema. |
Ejemplos
En el ejemplo de código siguiente se muestra el uso de las TextRenderingHint propiedades y TextContrast y la TextRenderingHint enumeración .
Este ejemplo está diseñado para usarse con Windows Forms. Pegue el código en un formulario y llame al ChangeTextRenderingHintAndTextContrast método al controlar el evento del Paint formulario, pasando e como 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.Graphics;
// Declare a new font.
Font myFont = new 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.
myFont.Dispose();
}
Private Sub ChangeTextRenderingHintAndTextContrast(ByVal e As _
PaintEventArgs)
' Retrieve the graphics object.
Dim formGraphics As Graphics = e.Graphics
' Declare a new font.
Dim myFont As Font = New 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.
myFont.Dispose()
End Sub
Comentarios
La calidad va desde texto (rendimiento más rápido, pero calidad más baja) hasta texto suavizado (mejor calidad, pero rendimiento más lento) al texto ClearType (mejor calidad en una pantalla LCD).
