Freigeben über


Vorgehensweise: Zeichnen von Text mit GDI

Mit der DrawText Methode in der TextRenderer Klasse können Sie auf GDI-Funktionen für das Zeichnen von Text in einem Formular oder Steuerelement zugreifen. Das Rendern von GDI-Text bietet in der Regel eine bessere Leistung und genauere Textmessung als GDI+.

Hinweis

Die Methoden der DrawText Klasse TextRenderer werden nicht für Drucken unterstützt. Verwenden Sie beim Drucken immer die DrawString Methoden der Graphics Klasse.

Beispiel

Im folgenden Codebeispiel wird das Zeichnen von Text in mehreren Zeilen innerhalb eines Rechtecks mithilfe der DrawText Methode veranschaulicht.

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

Um Text mit der TextRenderer Klasse zu rendern, benötigen Sie eine IDeviceContext, z. B. eine Graphics und eine FontPosition zum Zeichnen des Texts und die Farbe, in der er gezeichnet werden soll. Optional können Sie die Textformatierung mithilfe der TextFormatFlags Enumeration angeben.

Weitere Informationen zum Erstellen eines GraphicsObjekts finden Sie im Artikel So geht's: Graphics-Objekte zum Zeichnen erstellen. Weitere Informationen zum Erstellen einer SchriftartFont finden Sie unter So erstellen Sie Schriftfamilien und Schriftarten.

Code kompilieren

Das vorausgehende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert den PaintEventArgse, der ein Parameter von PaintEventHandler ist.

Siehe auch