Vorgehensweise: Zeichnen von Text mit GDI

  • Artikel

Mit der DrawText-Methode in der TextRenderer-Klasse können Sie auf die GDI-Funktion zum Zeichnen von Text in einem Formular oder Steuerelement zugreifen. Das GDI-Textrendering bietet in der Regel eine bessere Leistung und eine genauere Textmessung als GDI+.

Hinweis

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

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie Sie Text in mehreren Zeilen innerhalb eines Rechtecks mit der DrawText-Methode zeichnen können.

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

Wenn Sie den Text mit der TextRenderer-Klasse rendern möchten, benötigen Sie eine IDeviceContext-Schnittstelle (z. B. eine Graphics-Klasse und eine Font-Klasse), die Position, an der der Text gezeichnet werden soll, und die Farbe, in der er gezeichnet werden soll. Optional können Sie die Textformatierung mithilfe der TextFormatFlags-Enumeration definieren.

Weitere Informationen zum Abrufen einer Graphics-Klasse finden Sie unter Vorgehensweise: Erstellen von Grafikobjekten zum Zeichnen. Weitere Informationen zum Konstruieren einer Font-Klasse finden Sie unter Vorgehensweise: Erstellen von Schriftfamilien und Schriftarten.

Kompilieren des Codes

Das obige Codebeispiel ist für die Verwendung in Windows Forms konzipiert und erfordert die PaintEventArgse-Klasse, die ein Parameter von PaintEventHandler ist.

Weitere Informationen