TextRenderingHint Enumerazione

Definizione

Spazio dei nomi:

System.Drawing.Text

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Origine:

TextRenderingHint.cs

Specifica la qualità di rendering del testo.

public enum class TextRenderingHint

public enum TextRenderingHint

type TextRenderingHint = 

Public Enum TextRenderingHint

Ereditarietà

Object

ValueType

Enum

TextRenderingHint

Campi

AntiAlias	4	Ogni carattere viene visualizzato utilizzando la relativa bitmap di glifo con anti-aliasing, senza funzionalità di hint. Migliore qualità dovuta alla funzionalità di antialias. Differenze nella larghezza delle aste possono essere evidenti a causa della disabilitazione della funzionalità di hint.
AntiAliasGridFit	3	Ogni carattere viene visualizzato utilizzando la relativa bitmap di glifo con anti-aliasing, con funzionalità di hint. Qualità notevolmente migliore, grazie alla funzionalità di antialias, ma riduzione delle prestazioni.
ClearTypeGridFit	5	Ogni carattere viene visualizzato utilizzando la relativa bitmap ClearType di glifo, con funzionalità di hint. Impostazione per la qualità più elevata. Utilizzata per sfruttare le funzionalità dei tipi di carattere ClearType.
SingleBitPerPixel	2	Ogni carattere viene visualizzato utilizzando la relativa bitmap di glifo. La funzionalità di hint non è utilizzata.
SingleBitPerPixelGridFit	1	Ogni carattere viene visualizzato utilizzando la relativa bitmap di glifo. La funzionalità di hint viene utilizzata per migliorare l'aspetto dei caratteri, per quanto concerne aste e curvatura.
SystemDefault	0	Ogni carattere viene visualizzato utilizzando la relativa bitmap di glifo, con l'hint di rendering predefinito del sistema. Il testo verrà visualizzato utilizzando le impostazioni di smussatura dei caratteri selezionate dall'utente per il sistema.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso delle TextRenderingHint proprietà e TextContrast e dell'enumerazione TextRenderingHint .

Questo esempio è progettato per essere usato con Windows Forms. Incollare il codice in una maschera e chiamare il metodo quando si gestisce l'evento ChangeTextRenderingHintAndTextContrast del Paint modulo, passando e come 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

Commenti

La qualità varia dal testo (prestazioni più veloci, ma di qualità più bassa) al testo antialiased (migliore qualità, ma prestazioni più lente) al testo ClearType (migliore qualità su uno schermo LCD).