方法: GDI を使用してテキストを描画するHow to: Draw Text with GDI

TextRendererクラスのDrawTextメソッドを使用すると、フォームまたはコントロールにテキストを描画するための GDI 機能にアクセスできます。With the DrawText method in the TextRenderer class, you can access GDI functionality for drawing text on a form or control. GDI テキストレンダリングでは、通常、GDI + よりもパフォーマンスが向上し、より正確なテキスト測定が提供されます。GDI text rendering typically offers better performance and more accurate text measuring than GDI+.

注意

クラスのメソッドは印刷がサポートされていません。 DrawText TextRendererThe DrawText methods of the TextRenderer class are not supported for printing. 印刷時には、常DrawStringGraphicsクラスのメソッドを使用します。When printing, always use the DrawString methods of the Graphics class.

Example

次のコード例は、 DrawTextメソッドを使用して、四角形内の複数の行にテキストを描画する方法を示しています。The following code example demonstrates how to draw text on multiple lines within a rectangle using the DrawText method.

private void RenderText6(PaintEventArgs e)
{
    TextFormatFlags flags = TextFormatFlags.Bottom | TextFormatFlags.EndEllipsis;
    TextRenderer.DrawText(e.Graphics, "This is some text that will be clipped at the end.", this.Font,
        new Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags);
}
Private Sub RenderText6(ByVal e As PaintEventArgs)
    Dim flags As TextFormatFlags = TextFormatFlags.Bottom Or _
        TextFormatFlags.EndEllipsis
    TextRenderer.DrawText(e.Graphics, _
    "This is some text that will be clipped at the end.", _
    Me.Font, New Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags)

End Sub

TextRendererクラスを使用してテキストを表示するにIDeviceContextは、 GraphicsFontなどの、テキストを描画する場所、および描画する色を必要とします。To render text with the TextRenderer class, you need an IDeviceContext, such as a Graphics and a Font, a location to draw the text, and the color in which it should be drawn. 必要に応じて、 TextFormatFlags列挙を使用してテキストの書式を指定することもできます。Optionally, you can specify the text formatting by using the TextFormatFlags enumeration.

Graphics取得の詳細については、「方法:描画用のグラフィックスオブジェクトを作成します。For more information about obtaining a Graphics, see How to: Create Graphics Objects for Drawing. Font構築の詳細については、「」を参照してください。フォントファミリとフォントを構築します。For more information about constructing a Font, see How to: Construct Font Families and Fonts.

コードのコンパイルCompiling the Code

上記のコード例は、Windows フォームで使用するように設計されPaintEventArgsており、のPaintEventHandlerパラメーターであるeを必要とします。The preceding code example is designed for use with Windows Forms, and it requires the PaintEventArgs e, which is a parameter of PaintEventHandler.

関連項目See also