TextRenderingHint Énumération

Définition

Espace de noms:

System.Drawing.Text

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

TextRenderingHint.cs

Spécifie la qualité de rendu du texte.

public enum class TextRenderingHint

public enum TextRenderingHint

type TextRenderingHint = 

Public Enum TextRenderingHint

Héritage

Object

ValueType

Enum

TextRenderingHint

Champs

AntiAlias	4	Chaque caractère est dessiné en utilisant sa bitmap de glyphe non crénelée, sans affinage. La qualité est meilleure en raison de l'anticrénelage. L'affinage étant désactivé, les différences de largeur du jambage risquent d'être plus visibles.
AntiAliasGridFit	3	Chaque caractère est dessiné en utilisant sa bitmap de glyphe non crénelée, avec affinage. La qualité est sensiblement meilleure en raison de l'anticrénelage, mais au détriment de la vitesse.
ClearTypeGridFit	5	Chaque caractère est dessiné en utilisant sa bitmap ClearType de glyphe, avec affinage. Il s'agit de la qualité optimale. Permet de tirer parti des fonctionnalités des polices ClearType.
SingleBitPerPixel	2	Chaque caractère est dessiné en utilisant sa bitmap de glyphe. L'affinage n'est pas utilisé.
SingleBitPerPixelGridFit	1	Chaque caractère est dessiné en utilisant sa bitmap de glyphe. L'affinage est utilisé pour améliorer l'apparence du jambage et de la courbure des caractères.
SystemDefault	0	Chaque caractère est dessiné en utilisant sa bitmap de glyphe, avec l'affinage de rendu par défaut utilisé par le système. Le texte sera dessiné en utilisant les paramètres de lissage de police sélectionnés par l'utilisateur sur le système.

Exemples

L’exemple de code suivant illustre l’utilisation des TextRenderingHint propriétés et et TextContrast de l’énumération TextRenderingHint .

Cet exemple est conçu pour être utilisé avec Windows Forms. Collez le code dans un formulaire et appelez la méthode lors de la ChangeTextRenderingHintAndTextContrast gestion de l’événement du Paint formulaire, en passant e comme 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

Remarques

La qualité va du texte (performances les plus rapides, mais de qualité inférieure) au texte anticrénelé (meilleure qualité, mais performances plus lentes) en passant par le texte ClearType (meilleure qualité sur un écran LCD).