TextRenderingHint Enumeración

Definición

Espacio de nombres:

System.Drawing.Text

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Source:

TextRenderingHint.cs

Especifica la calidad de representación de texto.

public enum class TextRenderingHint

public enum TextRenderingHint

type TextRenderingHint = 

Public Enum TextRenderingHint

Herencia

Object

ValueType

Enum

TextRenderingHint

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