Procedura: creare testo con GDI

Con il DrawText metodo nella TextRenderer classe è possibile accedere alla funzionalità GDI per disegnare testo in una maschera o in un controllo. Il rendering del testo GDI offre in genere prestazioni migliori e una misurazione del testo più accurata rispetto a GDI+.

Nota

I DrawText metodi della classe non sono supportati per la TextRenderer stampa. Quando si stampa, usare sempre i DrawString metodi della Graphics classe .

Esempio

Nell'esempio di codice seguente viene illustrato come disegnare testo su più righe all'interno di un rettangolo usando il DrawText metodo .

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

Per eseguire il rendering del testo con la TextRenderer classe , è necessario un IDeviceContextoggetto , ad esempio e Graphics , Fontuna posizione per disegnare il testo e il colore in cui deve essere disegnato. Facoltativamente, è possibile specificare la formattazione del testo usando l'enumerazione TextFormatFlags .

Per altre informazioni su come ottenere un Graphicsoggetto , vedere Procedura: Creare oggetti grafici per il disegno. Per altre informazioni sulla costruzione di un oggetto Font, vedere Procedura: Costruire famiglie di tipi di carattere e tipi di carattere.

Compilazione del codice

L'esempio di codice precedente è progettato per l'uso con Windows Form e richiede , PaintEventArgs eche è un parametro di PaintEventHandler.

Vedi anche