TextRenderingHint TextRenderingHint TextRenderingHint TextRenderingHint Enum

Определение

Задает качество отрисовки текста.Specifies the quality of text rendering.

public enum class TextRenderingHint
public enum TextRenderingHint
type TextRenderingHint = 
Public Enum TextRenderingHint
Наследование
TextRenderingHintTextRenderingHintTextRenderingHintTextRenderingHint

Поля

AntiAlias AntiAlias AntiAlias AntiAlias 4

Все знаки отображаются с помощью сглаженных базовых знаков без хинтования.Each character is drawn using its antialiased glyph bitmap without hinting. Сглаживание позволяет повысить качество.Better quality due to antialiasing. Поскольку функция хинтования отключена, может быть заметна разница в ширине основных штрихов.Stem width differences may be noticeable because hinting is turned off.

AntiAliasGridFit AntiAliasGridFit AntiAliasGridFit AntiAliasGridFit 3

Все знаки отображаются с помощью сглаженных базовых знаков с хинтованием.Each character is drawn using its antialiased glyph bitmap with hinting. Качество существенно повышается благодаря сглаживанию, но за счет производительности.Much better quality due to antialiasing, but at a higher performance cost.

ClearTypeGridFit ClearTypeGridFit ClearTypeGridFit ClearTypeGridFit 5

Все знаки отображаются с помощью базовых знаков ClearType с хинтованием.Each character is drawn using its glyph ClearType bitmap with hinting. Наилучшее качество.The highest quality setting. Применяется для раскрытия преимуществ шрифтов ClearType.Used to take advantage of ClearType font features.

SingleBitPerPixel SingleBitPerPixel SingleBitPerPixel SingleBitPerPixel 2

Все знаки отображаются с помощью базовых знаков.Each character is drawn using its glyph bitmap. Хинтование отключено.Hinting is not used.

SingleBitPerPixelGridFit SingleBitPerPixelGridFit SingleBitPerPixelGridFit SingleBitPerPixelGridFit 1

Все знаки отображаются с помощью базовых знаков.Each character is drawn using its glyph bitmap. Хинтование применяется для повышения качества отображения знаков на основных штрихах и изгибах.Hinting is used to improve character appearance on stems and curvature.

SystemDefault SystemDefault SystemDefault SystemDefault 0

Все знаки отображаются с помощью базовых знаков с системным хинтованием, используемым по умолчанию.Each character is drawn using its glyph bitmap, with the system default rendering hint. Текст будет отображен с параметрами сглаживания шрифта, указанными для системы.The text will be drawn using whatever font-smoothing settings the user has selected for the system.

Примеры

В следующем примере кода демонстрируется использование TextRenderingHint свойств TextRenderingHint и TextContrast перечисления.The following code example demonstrates the use of the TextRenderingHint and TextContrast properties and the TextRenderingHint enumeration.

Этот пример предназначен для использования с Windows Forms.This example is designed to be used with Windows Forms. Вставьте код в форму и вызовите ChangeTextRenderingHintAndTextContrast метод при обработке Paint события формы, передав e его как 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

Комментарии

Качество в диапазоне от текста (самая высокая производительность, но самое низкое качество) к тексту в виде сглаженного текста (более высокое качество, но медленная производительность) для текста ClearType (лучшее качество на ЖК-дисплее).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).

Применяется к