TextRenderingHint TextRenderingHint TextRenderingHint TextRenderingHint Enum

Definizione

Specifica la qualità di rendering del testo.Specifies the quality of text rendering.

public enum class TextRenderingHint
public enum TextRenderingHint
type TextRenderingHint = 
Public Enum TextRenderingHint
Ereditarietà
TextRenderingHintTextRenderingHintTextRenderingHintTextRenderingHint

Campi

AntiAlias AntiAlias AntiAlias AntiAlias 4

Ogni carattere viene visualizzato utilizzando la relativa bitmap di glifo con anti-aliasing, senza funzionalità di hint.Each character is drawn using its antialiased glyph bitmap without hinting. Migliore qualità dovuta alla funzionalità di antialias.Better quality due to antialiasing. Differenze nella larghezza delle aste possono essere evidenti a causa della disabilitazione della funzionalità di hint.Stem width differences may be noticeable because hinting is turned off.

AntiAliasGridFit AntiAliasGridFit AntiAliasGridFit AntiAliasGridFit 3

Ogni carattere viene visualizzato utilizzando la relativa bitmap di glifo con anti-aliasing, con funzionalità di hint.Each character is drawn using its antialiased glyph bitmap with hinting. Qualità notevolmente migliore, grazie alla funzionalità di antialias, ma riduzione delle prestazioni.Much better quality due to antialiasing, but at a higher performance cost.

ClearTypeGridFit ClearTypeGridFit ClearTypeGridFit ClearTypeGridFit 5

Ogni carattere viene visualizzato utilizzando la relativa bitmap ClearType di glifo, con funzionalità di hint.Each character is drawn using its glyph ClearType bitmap with hinting. Impostazione per la qualità più elevata.The highest quality setting. Utilizzata per sfruttare le funzionalità dei tipi di carattere ClearType.Used to take advantage of ClearType font features.

SingleBitPerPixel SingleBitPerPixel SingleBitPerPixel SingleBitPerPixel 2

Ogni carattere viene visualizzato utilizzando la relativa bitmap di glifo.Each character is drawn using its glyph bitmap. La funzionalità di hint non è utilizzata.Hinting is not used.

SingleBitPerPixelGridFit SingleBitPerPixelGridFit SingleBitPerPixelGridFit SingleBitPerPixelGridFit 1

Ogni carattere viene visualizzato utilizzando la relativa bitmap di glifo.Each character is drawn using its glyph bitmap. La funzionalità di hint viene utilizzata per migliorare l'aspetto dei caratteri, per quanto concerne aste e curvatura.Hinting is used to improve character appearance on stems and curvature.

SystemDefault SystemDefault SystemDefault SystemDefault 0

Ogni carattere viene visualizzato utilizzando la relativa bitmap di glifo, con l'hint di rendering predefinito del sistema.Each character is drawn using its glyph bitmap, with the system default rendering hint. Il testo verrà visualizzato utilizzando le impostazioni di smussatura dei caratteri selezionate dall'utente per il sistema.The text will be drawn using whatever font-smoothing settings the user has selected for the system.

Esempi

Esempio di codice seguente viene illustrato l'utilizzo del TextRenderingHint e TextContrast delle proprietà e il TextRenderingHint enumerazione.The following code example demonstrates the use of the TextRenderingHint and TextContrast properties and the TextRenderingHint enumeration.

In questo esempio è progettato per essere usato con Windows Form.This example is designed to be used with Windows Forms. Incollare il codice in un form e si chiama il ChangeTextRenderingHintAndTextContrast metodo durante la gestione del modulo Paint evento passando e come PaintEventArgs.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.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

Gli intervalli di qualità da testo (le prestazioni più rapide, ma qualità più bassa) al testo con anti-aliasing al testo ClearType (migliore qualità su uno schermo LCD) (qualità migliore, ma riduzione delle prestazioni).The quality ranges from text (fastest performance, but lowest quality) to antialiased text (better quality, but slower performance) to ClearType text (best quality on an LCD display).

Si applica a