Практическое руководство. Рисование текста с использованием GDI

  • Статья

Получить доступ к функционалу GDI для рисования текста на форме или элементе управления можно с помощью метода DrawText класса TextRenderer. Отрисовка текста GDI обычно обеспечивает лучшую производительность и более точное измерение текста, чем GDI+.

Примечание.

Методы DrawText класса TextRenderer не поддерживаются для печати. При печати всегда следует использовать методы DrawString класса Graphics.

Пример

В следующем примере кода показано, как нарисовать текст на нескольких строках в прямоугольнике с помощью метода DrawText.

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 (такие как Graphics и Font), а также место для рисования текста и цвет, в котором он должен быть нарисован. При необходимости можно указать форматирование текста с помощью перечисления TextFormatFlags.

Дополнительные сведения по получению Graphics см. в разделе Практическое руководство. Создание графических объектов для рисования. Дополнительные сведения о создании объекта Font см. в разделе Практическое руководство. Создание семейств шрифтов и шрифтов.

Компиляция кода

Предыдущий пример кода предназначен для работы с Windows Forms и требует PaintEventArgse, который является параметром PaintEventHandler.

См. также