TextRenderingHint Enumeration

Definition

Namespace:

System.Drawing.Text

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Quelle:

TextRenderingHint.cs

Gibt die Qualität der Textdarstellung an.

public enum class TextRenderingHint

public enum TextRenderingHint

type TextRenderingHint = 

Public Enum TextRenderingHint

Vererbung

Object

ValueType

Enum

TextRenderingHint

Felder

AntiAlias	4	Jedes Zeichen wird unter Verwendung der zugehörigen Symbolbitmap mit Antialiasing und ohne Hinting gezeichnet. Bessere Qualität aufgrund von Antialiasing. Unterschiede in der Stammbreite können erkennbar sein, da Hinting ausgeschaltet ist.
AntiAliasGridFit	3	Jedes Zeichen wird unter Verwendung der zugehörigen Symbolbitmap mit Antialiasing und mit Hinting gezeichnet. Wesentlich bessere Qualität durch Antialiasing, jedoch bei höheren Leistungsverlusten.
ClearTypeGridFit	5	Jedes Zeichen wird unter Verwendung der zugehörigen ClearType-Symbolbitmap mit Hinting gezeichnet. Die Einstellung mit der höchsten Qualität. Wird verwendet, um die Features der ClearType-Schriftart nutzen zu können.
SingleBitPerPixel	2	Jedes Zeichen wird unter Verwendung der zugehörigen Symbolbitmap gezeichnet. Hinting wird nicht verwendet.
SingleBitPerPixelGridFit	1	Jedes Zeichen wird unter Verwendung der zugehörigen Symbolbitmap gezeichnet. Durch Hinting wird die Darstellung der Stämme und Bögen von Zeichen verbessert.
SystemDefault	0	Jedes Zeichen wird unter Verwendung der zugehörigen Symbolbitmap mit dem Standardhinting des Systems gezeichnet. Der Text wird mit den Einstellungen für die Schriftartglättung gezeichnet, die der Benutzer für das System ausgewählt hat.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der TextRenderingHint Eigenschaften und TextContrast und der TextRenderingHint Enumeration veranschaulicht.

Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert. Fügen Sie den Code in ein Formular ein, und rufen Sie die ChangeTextRenderingHintAndTextContrast -Methode auf, wenn Sie das Ereignis des Formulars Paint behandeln, und übergeben Sie e als 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

Hinweise

Die Qualität reicht von Text (schnellste Leistung, aber niedrigste Qualität) über Antialiased-Text (bessere Qualität, aber langsamere Leistung) bis hin zu ClearType-Text (beste Qualität auf einem LCD-Display).