TextRenderingHint 列挙体とは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

TextRenderingHint 列挙体

テキストレンダリングの品質を指定します。

名前空間: System.Drawing.Text
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Enumeration TextRenderingHint

Visual Basic (使用法)

Dim instance As TextRenderingHint

public enum TextRenderingHint

C++

public enum class TextRenderingHint

public enum TextRenderingHint

JScript

public enum TextRenderingHint

メンバ

	メンバ名	説明
	AntiAlias	アンチエイリアス処理されたグリフビットマップを使用して、ヒンティングなしに各文字を描画します。アンチエイリアスによって品質が向上します。ヒンティングがオフにされるため、ステム幅の違いが目立ちます。
	AntiAliasGridFit	アンチエイリアス処理されたグリフビットマップを使用して、ヒンティングありで各文字を描画します。アンチエイリアスによってより高い品質が得られますが、パフォーマンスは大きく低下します。
	ClearTypeGridFit	グリフ ClearType ビットマップを使用して、ヒンティングありで各文字を描画します。最高の品質設定です。ClearType テキストフォント機能を利用するときに使用します。
	SingleBitPerPixel	グリフビットマップを使用して各文字を描画します。ヒンティングは使用されません。
	SingleBitPerPixelGridFit	グリフビットマップを使用して各文字を描画します。ヒンティングを使用して、文字のステム部分と曲線部分の見た目を向上します。
	SystemDefault	グリフビットマップを使用し、システムの既定のレンダリングヒントで各文字を描画します。ユーザーがシステムで選択した、すべてのフォントスムージング設定を使用してテキストを描画します。

解説

テキスト (最高の速度、最低の品質) から、アンチエイリアス処理されたテキスト (品質が向上、速度は低下)、ClearType テキスト (LCD ディスプレイで最高の品質) までの品質の範囲。

使用例

TextRenderingHint プロパティ、TextContrast プロパティ、および TextRenderingHint 列挙体の使用方法を示すコード例を次に示します。

この例は、Windows フォームでの使用を意図してデザインされています。コードをフォームに貼り付け、フォームの Paint イベントを処理するときに PaintEventArgs の e を渡して ChangeTextRenderingHintAndTextContrast メソッドを呼び出します。

Visual Basic

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

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();

}

C++

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.get_Graphics();

    // Declare a new font.
    Font myFont = new Font(FontFamily.get_GenericSansSerif(),
 
                20, FontStyle.Regular);

    // Set the TextRenderingHint property.
    formGraphics.set_TextRenderingHint(System.Drawing.Text.
        TextRenderingHint.SingleBitPerPixel);

    // Draw the string.
    formGraphics.DrawString("Hello World", myFont,
        Brushes.get_Firebrick(), 20, 20);

    // Change the TextRenderingHint property.
    formGraphics.set_TextRenderingHint(System.Drawing.Text.
        TextRenderingHint.AntiAliasGridFit);

    // Draw the string again.
    formGraphics.DrawString("Hello World", myFont, 
        Brushes.get_Firebrick(), 20, 60);

    // Set the text contrast to a high-contrast setting.
    formGraphics.set_TextContrast(0);

    // Draw the string.
    formGraphics.DrawString("Hello World", myFont, 
        Brushes.get_DodgerBlue(), 20, 100);

    // Set the text contrast to a low-contrast setting.
    formGraphics.set_TextContrast(12);

    // Draw the string again.
    formGraphics.DrawString("Hello World", myFont,
        Brushes.get_DodgerBlue(), 20, 140);

    // Dispose of the font object.
    myFont.Dispose();
} //ChangeTextRenderingHintAndTextContrast