Graphics.TextRenderingHint プロパティ

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

Graphics.TextRenderingHint プロパティ

この Graphics に関連付けられているテキストのレンダリング モードを取得または設定します。

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

Visual Basic (宣言)

Public Property TextRenderingHint As
 TextRenderingHint

Visual Basic (使用法)

Dim instance As Graphics
Dim value As TextRenderingHint

value = instance.TextRenderingHint

instance.TextRenderingHint = value

C#

public TextRenderingHint TextRenderingHint { get;
 set; }

C++

public:
property TextRenderingHint TextRenderingHint {
    TextRenderingHint get ();
    void set (TextRenderingHint value);
}

J#

/** @property */
public TextRenderingHint get_TextRenderingHint ()

/** @property */
public void set_TextRenderingHint (TextRenderingHint
 value)

JScript

public function get TextRenderingHint
 () : TextRenderingHint

public function set TextRenderingHint
 (value : TextRenderingHint)

プロパティ値
TextRenderingHint 値の 1 つ。

解説

テキストのレンダリング ヒントは、テキストをアンチエイリアス処理するかどうかを指定します。

使用例

TextRenderingHint プロパティと TextContrast プロパティの使用方法を示すコード例を次に示します。

この例は、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

C#

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;
   }

J#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Graphics クラス
Graphics メンバ
System.Drawing 名前空間