TextRenderingHint TextRenderingHint TextRenderingHint TextRenderingHint Enum

Definition

Gibt die Qualität der Textdarstellung an.Specifies the quality of text rendering.

public enum class TextRenderingHint
public enum TextRenderingHint
type TextRenderingHint = 
Public Enum TextRenderingHint
Vererbung
TextRenderingHintTextRenderingHintTextRenderingHintTextRenderingHint

Felder

AntiAlias AntiAlias AntiAlias AntiAlias 4

Jedes Zeichen wird unter Verwendung der zugehörigen Symbolbitmap mit Antialiasing und ohne Hinting gezeichnet.Each character is drawn using its antialiased glyph bitmap without hinting. Bessere Qualität aufgrund von Antialiasing.Better quality due to antialiasing. Unterschiede in der Stammbreite können erkennbar sein, da Hinting ausgeschaltet ist.Stem width differences may be noticeable because hinting is turned off.

AntiAliasGridFit AntiAliasGridFit AntiAliasGridFit AntiAliasGridFit 3

Jedes Zeichen wird unter Verwendung der zugehörigen Symbolbitmap mit Antialiasing und mit Hinting gezeichnet.Each character is drawn using its antialiased glyph bitmap with hinting. Wesentlich bessere Qualität durch Antialiasing, jedoch bei höheren Leistungsverlusten.Much better quality due to antialiasing, but at a higher performance cost.

ClearTypeGridFit ClearTypeGridFit ClearTypeGridFit ClearTypeGridFit 5

Jedes Zeichen wird unter Verwendung der zugehörigen ClearType-Symbolbitmap mit Hinting gezeichnet.Each character is drawn using its glyph ClearType bitmap with hinting. Die Einstellung mit der höchsten Qualität.The highest quality setting. Wird verwendet, um die Features der ClearType-Schriftart nutzen zu können.Used to take advantage of ClearType font features.

SingleBitPerPixel SingleBitPerPixel SingleBitPerPixel SingleBitPerPixel 2

Jedes Zeichen wird unter Verwendung der zugehörigen Symbolbitmap gezeichnet.Each character is drawn using its glyph bitmap. Hinting wird nicht verwendet.Hinting is not used.

SingleBitPerPixelGridFit SingleBitPerPixelGridFit SingleBitPerPixelGridFit SingleBitPerPixelGridFit 1

Jedes Zeichen wird unter Verwendung der zugehörigen Symbolbitmap gezeichnet.Each character is drawn using its glyph bitmap. Durch Hinting wird die Darstellung der Stämme und Bögen von Zeichen verbessert.Hinting is used to improve character appearance on stems and curvature.

SystemDefault SystemDefault SystemDefault SystemDefault 0

Jedes Zeichen wird unter Verwendung der zugehörigen Symbolbitmap mit dem Standardhinting des Systems gezeichnet.Each character is drawn using its glyph bitmap, with the system default rendering hint. Der Text wird mit den Einstellungen für die Schriftartglättung gezeichnet, die der Benutzer für das System ausgewählt hat.The text will be drawn using whatever font-smoothing settings the user has selected for the system.

Beispiele

Im folgenden Codebeispiel wird die Verwendung TextRenderingHint der-Eigenschaft und TextContrast der- TextRenderingHint Eigenschaft sowie der-Enumeration veranschaulicht.The following code example demonstrates the use of the TextRenderingHint and TextContrast properties and the TextRenderingHint enumeration.

Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert.This example is designed to be used with Windows Forms. Fügen Sie den Code in ein Formular ein, ChangeTextRenderingHintAndTextContrast und nennen Sie die-Methode Paint , wenn Sie das PaintEventArgs-Ereignis des Formulars verarbeiten und als übergeben e .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

Hinweise

Die Qualität reicht von Text (schnellste Leistung, aber niedrigste Qualität) bis zu Text mit Antialiasing (bessere Qualität, aber langsamer Leistung) bis ClearType-Text (beste Qualität auf einem LCD-Display).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).

Gilt für: