TextRenderer.DrawText Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Crea il testo specificato nella posizione specificata, utilizzando il contesto di periferica, il colore e il tipo di carattere specificati.

Overload

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)	Crea il testo specificato nella posizione specificata, utilizzando il contesto di periferica, il tipo di carattere e il colore specificati.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)	Crea il testo specificato nei limiti specificati, utilizzando il contesto di periferica, il tipo di carattere, il colore, il colore di sfondo e le istruzioni di formattazione specificati.
DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)	Crea il testo specificato nella posizione specificata, usando il contesto di dispositivo, il tipo di carattere, il colore, il colore di sfondo e le istruzioni di formattazione specificati.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)	Crea il testo specificato nella posizione specificata, usando il contesto di dispositivo, il tipo di carattere, il colore, il colore di sfondo e le istruzioni di formattazione specificati.
DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)	Crea il testo specificato nei limiti specificati, utilizzando il contesto di periferica, il tipo di carattere, il colore e le istruzioni di formattazione specificati.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)	Crea il testo specificato nei limiti specificati, utilizzando il contesto di periferica, il tipo di carattere e il colore di sfondo specificati.
DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)	Crea il testo specificato nella posizione specificata, utilizzando il contesto di periferica, il tipo di carattere, il colore e le istruzioni di formattazione specificati.
DrawText(IDeviceContext, String, Font, Point, Color, Color)	Crea il testo specificato nella posizione specificata, utilizzando il contesto di periferica, il tipo di carattere e il colore di sfondo specificati.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)	Crea il testo specificato nei limiti specificati, utilizzando il contesto di periferica, il tipo di carattere, il colore, il colore di sfondo e le istruzioni di formattazione specificati.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)	Crea il testo specificato nei limiti specificati, utilizzando il contesto di periferica, il tipo di carattere e il colore di sfondo specificati.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)	Crea il testo specificato nella posizione specificata, utilizzando il contesto di periferica, il tipo di carattere, il colore e le istruzioni di formattazione specificati.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)	Crea il testo specificato nella posizione specificata, utilizzando il contesto di periferica, il tipo di carattere e il colore di sfondo specificati.
DrawText(IDeviceContext, String, Font, Rectangle, Color)	Crea il testo specificato all'interno dei limiti specificati, utilizzando il contesto di periferica, il tipo di carattere e il colore specificati.
DrawText(IDeviceContext, String, Font, Point, Color)	Crea il testo specificato nella posizione specificata, utilizzando il contesto di periferica, il tipo di carattere e il colore specificati.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)	Crea il testo specificato all'interno dei limiti specificati, utilizzando il contesto di periferica, il tipo di carattere e il colore specificati.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, TextFormatFlags)	Crea il testo specificato nei limiti specificati, utilizzando il contesto di periferica, il tipo di carattere, il colore e le istruzioni di formattazione specificati.

Commenti

Il rendering del testo offerto dalla TextRenderer classe è basato sul rendering del testo GDI e non è supportato per la stampa da Windows Forms. Usare invece i DrawString metodi della Graphics classe .

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)

Crea il testo specificato nella posizione specificata, utilizzando il contesto di periferica, il tipo di carattere e il colore specificati.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, pt As Point, foreColor As Color)

Parametri

dc: IDeviceContext

Contesto di periferica in cui creare il testo.

text: ReadOnlySpan<Char>

Testo da disegnare.

font: Font

Classe Font da applicare al testo creato.

pt: Point

Struttura Point che rappresenta l'angolo superiore sinistro del testo creato.

foreColor: Color

Classe Color da applicare al testo creato.

Eccezioni

ArgumentNullException

dc è null.

Si applica a

Windows Desktop 9 e altre versioni

Prodotto	Versioni
Windows Desktop	5, 6, 7, 8, 9

DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)

Crea il testo specificato nei limiti specificati, utilizzando il contesto di periferica, il tipo di carattere, il colore, il colore di sfondo e le istruzioni di formattazione specificati.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, bounds As Rectangle, foreColor As Color, backColor As Color, flags As TextFormatFlags)

Parametri

dc: IDeviceContext

Contesto di periferica in cui creare il testo.

text: String

Testo da disegnare.

font: Font

Classe Font da applicare al testo creato.

bounds: Rectangle

Struttura Rectangle che rappresenta i limiti del testo.

foreColor: Color

Struttura Color da applicare al testo.

backColor: Color

Struttura Color da applicare all'area rappresentata dal parametro bounds.

flags: TextFormatFlags

Combinazione bit per bit dei valori di TextFormatFlags.

Eccezioni

ArgumentNullException

dc è null.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo DrawText. Per eseguire questo esempio, incollare il codice in un Windows Form e chiamare RenderText8 dal gestore eventi del Paint modulo, passando e come PaintEventArgs.

private void RenderText8(PaintEventArgs e)
{
    TextFormatFlags flags = TextFormatFlags.Bottom | TextFormatFlags.WordBreak;
    TextRenderer.DrawText(e.Graphics, "This is some text that will display on multiple lines.", this.Font,
        new Rectangle(10, 10, 100, 50), SystemColors.ControlText, SystemColors.ControlDark, flags);
}

Private Sub RenderText8(ByVal e As PaintEventArgs)
    Dim flags As TextFormatFlags = _
        TextFormatFlags.Bottom Or TextFormatFlags.WordBreak
    TextRenderer.DrawText(e.Graphics, _
        "This is some text that will display on multiple lines.", _
        Me.Font, New Rectangle(10, 10, 100, 50), _
        SystemColors.ControlText, SystemColors.ControlDark, flags)

End Sub

Commenti

Il backcolor parametro viene applicato all'area all'interno del bounds parametro. If forecolorfonto è null o backcolorEmpty, rispettivamente; il DrawText metodo disegna il testo nel tipo di carattere o colore attualmente selezionato nel contesto del dispositivo specificato da dc. Se forecolor è Transparent, il testo non verrà disegnato.

È possibile modificare il modo in cui viene creato il testo utilizzando uno degli overload DrawText che accetta un parametro TextFormatFlags. Ad esempio, il comportamento predefinito della classe TextRenderer è di aggiungere spaziatura al rettangolo di delimitazione del testo creato per sistemare le parti sporgenti delle icone. Se è necessario creare una riga di testo senza tale spazio aggiuntivo, è necessario utilizzare le versioni dei metodi DrawText e MeasureText che accettano un parametro Size e TextFormatFlags. Per un esempio, vedere MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

Il rendering del testo offerto dalla TextRenderer classe si basa sul rendering del testo GDI e non è supportato per la stampa da Windows Forms. Usare invece i DrawString metodi della Graphics classe.

Non TextRenderer supporta l'aggiunta di tabulazioni al testo disegnato, anche se è possibile espandere le tabulazioni esistenti usando il ExpandTabs flag.

Si applica a

.NET Framework 4.8.1 e altre versioni

Prodotto	Versioni
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)

Crea il testo specificato nella posizione specificata, usando il contesto di dispositivo, il tipo di carattere, il colore, il colore di sfondo e le istruzioni di formattazione specificati.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, pt As Point, foreColor As Color, backColor As Color, flags As TextFormatFlags)

Parametri

dc: IDeviceContext

Contesto di periferica in cui creare il testo.

text: String

Testo da disegnare.

font: Font

Classe Font da applicare al testo creato.

pt: Point

Struttura Point che rappresenta l'angolo superiore sinistro del testo creato.

foreColor: Color

Struttura Color da applicare al testo.

backColor: Color

Classe Color da applicare all'area di sfondo del testo creato.

flags: TextFormatFlags

Combinazione bit per bit dei valori di TextFormatFlags.

Eccezioni

ArgumentNullException

dc è null.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo DrawText. Per eseguire questo esempio, incollare il codice in un Windows Form e chiamare RenderText7 dal gestore eventi del Paint modulo, passando e come PaintEventArgs.

private void RenderText7(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "This is some text.", this.Font,
        new Point(10, 10), Color.White, Color.SteelBlue, TextFormatFlags.Default);
}

Private Sub RenderText7(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "This is some text.", _
        Me.Font, New Point(10, 10), Color.White, Color.SteelBlue, _
        TextFormatFlags.Default)

End Sub

Commenti

Il backcolor parametro viene applicata l'area rettangolare contenente il testo disegnato. Se font o è null o Emptyforecolor , rispettivamente; il DrawText metodo disegna il testo nel tipo di carattere o nel colore attualmente selezionato nel contesto del dispositivo specificato da dc. Se forecolor è Transparent, il testo non verrà disegnato.

Non TextRenderer supporta l'aggiunta di tabulazioni al testo disegnato, anche se è possibile espandere le tabulazioni esistenti usando il ExpandTabs flag.

Nota

I DrawText metodi che specificano un oggetto Point come angolo superiore sinistro del testo disegnato non vengono visualizzati correttamente in Windows 2000. Se l'applicazione è destinata all'uso nei computer che eseguono Windows 2000, è consigliabile usare uno dei DrawText metodi che specificano un Rectangle per i limiti del testo disegnato.

Si applica a

.NET Framework 4.8.1 e altre versioni

Prodotto	Versioni
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)

Crea il testo specificato nella posizione specificata, usando il contesto di dispositivo, il tipo di carattere, il colore, il colore di sfondo e le istruzioni di formattazione specificati.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, pt As Point, foreColor As Color, backColor As Color, flags As TextFormatFlags)

Parametri

dc: IDeviceContext

Contesto di periferica in cui creare il testo.

text: ReadOnlySpan<Char>

Testo da disegnare.

font: Font

Classe Font da applicare al testo creato.

pt: Point

Struttura Point che rappresenta l'angolo superiore sinistro del testo creato.

foreColor: Color

Classe Color da applicare al testo creato.

backColor: Color

Classe Color da applicare all'area di sfondo del testo creato.

flags: TextFormatFlags

Combinazione bit per bit dei valori di TextFormatFlags.

Eccezioni

ArgumentNullException

dc costruito in modo predefinito è null.

ArgumentOutOfRangeException

La classe ModifyString è stata impostata.

Si applica a

Windows Desktop 9 e altre versioni

Prodotto	Versioni
Windows Desktop	5, 6, 7, 8, 9

DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)

Crea il testo specificato nei limiti specificati, utilizzando il contesto di periferica, il tipo di carattere, il colore e le istruzioni di formattazione specificati.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, bounds As Rectangle, foreColor As Color, flags As TextFormatFlags)

Parametri

dc: IDeviceContext

Contesto di periferica in cui creare il testo.

text: String

Testo da disegnare.

font: Font

Classe Font da applicare al testo creato.

bounds: Rectangle

Struttura Rectangle che rappresenta i limiti del testo.

foreColor: Color

Classe Color da applicare al testo creato.

flags: TextFormatFlags

Combinazione bit per bit dei valori di TextFormatFlags.

Eccezioni

ArgumentNullException

dc è null.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo DrawText. Per eseguire questo esempio, incollare il codice in un Windows Form e chiamare RenderText6 dal gestore eventi del Paint modulo, passando e come PaintEventArgs.

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

Commenti

Se font o color è null o Empty, rispettivamente; il DrawText metodo disegna il testo nel tipo di carattere o nel colore attualmente selezionato nel contesto del dispositivo specificato da dc. Se forecolor è Transparent, il testo non verrà disegnato.

L'oggetto TextRenderer non supporta l'aggiunta di tabulazioni al testo disegnato, anche se è possibile espandere le tabulazioni esistenti usando il ExpandTabs flag .

Si applica a

.NET Framework 4.8.1 e altre versioni

Prodotto	Versioni
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)

Crea il testo specificato nei limiti specificati, utilizzando il contesto di periferica, il tipo di carattere e il colore di sfondo specificati.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Drawing::Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, bounds As Rectangle, foreColor As Color, backColor As Color)

Parametri

dc: IDeviceContext

Contesto di periferica in cui creare il testo.

text: String

Testo da disegnare.

font: Font

Classe Font da applicare al testo creato.

bounds: Rectangle

Struttura Rectangle che rappresenta i limiti del testo.

foreColor: Color

Classe Color da applicare al testo creato.

backColor: Color

Struttura Color da applicare all'area rappresentata dal parametro bounds.

Eccezioni

ArgumentNullException

dc è null.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo DrawText. Per eseguire questo esempio, incollare il codice in un Windows Form e chiamare RenderText4 dal gestore eventi del Paint modulo, passando e come PaintEventArgs.

private void RenderText4(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text.", this.Font,
        new Rectangle(10, 10, 70, 70), SystemColors.ControlText, 
        SystemColors.ControlDark);
}

Private Sub RenderText4(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Regular Text.", _
        Me.Font, New Rectangle(10, 10, 70, 70), _
        SystemColors.ControlText, SystemColors.ControlDark)

End Sub

Commenti

Il backColor parametro viene applicato all'area all'interno del bounds parametro . Se font, backcolor o forecolor è null o Empty, rispettivamente; il DrawText metodo disegna il testo nel tipo di carattere o nel colore attualmente selezionato nel contesto di dispositivo specificato da dc. Se forecolor è Transparent, il testo non verrà disegnato.

Questo metodo comporterà il testo allineato orizzontalmente e verticalmente centrato nel rettangolo specificato dal bounds parametro . Per modificare la modalità di disegno del testo, usare una versione di DrawText che accetta un TextFormatFlags tipo di parametro.

Si applica a

.NET Framework 4.8.1 e altre versioni

Prodotto	Versioni
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)

Crea il testo specificato nella posizione specificata, utilizzando il contesto di periferica, il tipo di carattere, il colore e le istruzioni di formattazione specificati.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, pt As Point, foreColor As Color, flags As TextFormatFlags)

Parametri

dc: IDeviceContext

Contesto di periferica in cui creare il testo.

text: String

Testo da disegnare.

font: Font

Classe Font da applicare al testo creato.

pt: Point

Struttura Point che rappresenta l'angolo superiore sinistro del testo creato.

foreColor: Color

Classe Color da applicare al testo creato.

flags: TextFormatFlags

Combinazione bit per bit dei valori di TextFormatFlags.

Eccezioni

ArgumentNullException

dc è null.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo DrawText. Per eseguire questo esempio, incollare il codice in un Windows Form e chiamare RenderText5 dal gestore eventi del Paint modulo, passando e come PaintEventArgs.

private void RenderText5(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Some text.",
        this.Font, new Point(10, 10), SystemColors.ControlText, TextFormatFlags.Bottom);
}

Private Sub RenderText5(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Some text.", _
    Me.Font, New Point(10, 10), SystemColors.ControlText, _
    TextFormatFlags.Bottom)

End Sub

Commenti

Il backColor parametro viene applicato all'area all'interno del bounds parametro . Se font o forecolor è null o Color.Empty, rispettivamente; il DrawText metodo disegna il testo nel tipo di carattere o nel colore attualmente selezionato nel contesto del dispositivo specificato da dc. Se forecolor è Transparent, il testo non verrà disegnato.

L'oggetto TextRenderer non supporta l'aggiunta di tabulazioni al testo disegnato, anche se è possibile espandere le tabulazioni esistenti usando il ExpandTabs flag .

Nota

Si applica a

.NET Framework 4.8.1 e altre versioni

Prodotto	Versioni
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawText(IDeviceContext, String, Font, Point, Color, Color)

Crea il testo specificato nella posizione specificata, utilizzando il contesto di periferica, il tipo di carattere e il colore di sfondo specificati.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Drawing::Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, pt As Point, foreColor As Color, backColor As Color)

Parametri

dc: IDeviceContext

Contesto di periferica in cui creare il testo.

text: String

Testo da disegnare.

font: Font

Classe Font da applicare al testo creato.

pt: Point

Struttura Point che rappresenta l'angolo superiore sinistro del testo creato.

foreColor: Color

Classe Color da applicare al testo creato.

backColor: Color

Classe Color da applicare all'area di sfondo del testo creato.

Eccezioni

ArgumentNullException

dc è null.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo DrawText. Per eseguire questo esempio, incollare il codice in un Windows Form e chiamare RenderText3 dal gestore eventi del Paint modulo, passando e come PaintEventArgs.

private void RenderText3(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text", this.Font,
        new Point(10, 10), Color.Red, Color.PowderBlue);
}

Private Sub RenderText3(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Regular Text", Me.Font, _
        New Point(10, 10), Color.Red, Color.PowderBlue)

End Sub

Commenti

Il backColor parametro viene applicato all'area rettangolare contenente il testo disegnato. Se font, backcolor o forecolor è null o Color.Empty, rispettivamente; il DrawText metodo disegna il testo nel tipo di carattere o nel colore attualmente selezionato nel contesto di dispositivo specificato da dc. Se forecolor è Transparent, il testo non verrà disegnato.

È possibile modificare il modo in cui viene creato il testo utilizzando uno degli overload DrawText che accetta un parametro TextFormatFlags.

Nota

Si applica a

.NET Framework 4.8.1 e altre versioni

Prodotto	Versioni
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)

Crea il testo specificato nei limiti specificati, utilizzando il contesto di periferica, il tipo di carattere, il colore, il colore di sfondo e le istruzioni di formattazione specificati.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, bounds As Rectangle, foreColor As Color, backColor As Color, flags As TextFormatFlags)

Parametri

dc: IDeviceContext

Contesto di periferica in cui creare il testo.

text: ReadOnlySpan<Char>

Testo da disegnare.

font: Font

Classe Font da applicare al testo creato.

bounds: Rectangle

Struttura Rectangle che rappresenta i limiti del testo.

foreColor: Color

Classe Color da applicare al testo creato.

backColor: Color

Classe Color da applicare all'area di sfondo del testo creato.

flags: TextFormatFlags

Combinazione bit per bit dei valori di TextFormatFlags.

Eccezioni

ArgumentNullException

dc è null.

ArgumentOutOfRangeException

La classe ModifyString è stata impostata.

Si applica a

Windows Desktop 9 e altre versioni

Prodotto	Versioni
Windows Desktop	5, 6, 7, 8, 9

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)

Crea il testo specificato nei limiti specificati, utilizzando il contesto di periferica, il tipo di carattere e il colore di sfondo specificati.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Drawing::Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, bounds As Rectangle, foreColor As Color, backColor As Color)

Parametri

dc: IDeviceContext

Contesto di periferica in cui creare il testo.

text: ReadOnlySpan<Char>

Testo da disegnare.

font: Font

Classe Font da applicare al testo creato.

bounds: Rectangle

Struttura Rectangle che rappresenta i limiti del testo.

foreColor: Color

Classe Color da applicare al testo creato.

backColor: Color

Classe Color da applicare all'area di sfondo del testo creato.

Eccezioni

ArgumentNullException

dc è null.

Si applica a

Windows Desktop 9 e altre versioni

Prodotto	Versioni
Windows Desktop	5, 6, 7, 8, 9

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)

Crea il testo specificato nella posizione specificata, utilizzando il contesto di periferica, il tipo di carattere, il colore e le istruzioni di formattazione specificati.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, pt As Point, foreColor As Color, flags As TextFormatFlags)

Parametri

dc: IDeviceContext

Contesto di periferica in cui creare il testo.

text: ReadOnlySpan<Char>

Testo da disegnare.

font: Font

Classe Font da applicare al testo creato.

pt: Point

Struttura Point che rappresenta l'angolo superiore sinistro del testo creato.

foreColor: Color

Classe Color da applicare al testo creato.

flags: TextFormatFlags

Combinazione bit per bit dei valori di TextFormatFlags.

Eccezioni

ArgumentNullException

dc è null.

ArgumentOutOfRangeException

La classe ModifyString è stata impostata.

Si applica a

Windows Desktop 9 e altre versioni

Prodotto	Versioni
Windows Desktop	5, 6, 7, 8, 9

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)

Crea il testo specificato nella posizione specificata, utilizzando il contesto di periferica, il tipo di carattere e il colore di sfondo specificati.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Drawing::Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, pt As Point, foreColor As Color, backColor As Color)

Parametri

dc: IDeviceContext

Contesto di periferica in cui creare il testo.

text: ReadOnlySpan<Char>

Testo da disegnare.

font: Font

Classe Font da applicare al testo creato.

pt: Point

Struttura Point che rappresenta l'angolo superiore sinistro del testo creato.

foreColor: Color

Classe Color da applicare al testo creato.

backColor: Color

Classe Color da applicare all'area di sfondo del testo creato.

Eccezioni

ArgumentNullException

dc è null.

Si applica a

Windows Desktop 9 e altre versioni

Prodotto	Versioni
Windows Desktop	5, 6, 7, 8, 9

DrawText(IDeviceContext, String, Font, Rectangle, Color)

Crea il testo specificato all'interno dei limiti specificati, utilizzando il contesto di periferica, il tipo di carattere e il colore specificati.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, bounds As Rectangle, foreColor As Color)

Parametri

dc: IDeviceContext

Contesto di periferica in cui creare il testo.

text: String

Testo da disegnare.

font: Font

Classe Font da applicare al testo creato.

bounds: Rectangle

Struttura Rectangle che rappresenta i limiti del testo.

foreColor: Color

Classe Color da applicare al testo creato.

Eccezioni

ArgumentNullException

dc è null.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo DrawText. Per eseguire questo esempio, incollare il codice in un Windows Form e chiamare RenderText2 dal gestore eventi del Paint modulo, passando e come PaintEventArgs.

private void RenderText2(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text", this.Font,
        new Rectangle(10, 10, 100, 100), SystemColors.ControlText);
}

Private Sub RenderText2(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Regular Text", _
        Me.Font, New Rectangle(10, 10, 100, 100), _
        SystemColors.ControlText)

End Sub

Commenti

Se font o forecolor è null o Color.Empty, rispettivamente; il DrawText metodo disegna il testo nel tipo di carattere o nel colore attualmente selezionato nel contesto del dispositivo specificato da dc. Se forecolor è Transparent, il testo non verrà disegnato.

Vedi anche

IDeviceContext

Si applica a

.NET Framework 4.8.1 e altre versioni

Prodotto	Versioni
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawText(IDeviceContext, String, Font, Point, Color)

Crea il testo specificato nella posizione specificata, utilizzando il contesto di periferica, il tipo di carattere e il colore specificati.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, pt As Point, foreColor As Color)

Parametri

dc: IDeviceContext

Contesto di periferica in cui creare il testo.

text: String

Testo da disegnare.

font: Font

Classe Font da applicare al testo creato.

pt: Point

Struttura Point che rappresenta l'angolo superiore sinistro del testo creato.

foreColor: Color

Classe Color da applicare al testo creato.

Eccezioni

ArgumentNullException

dc è null.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo DrawText. Per eseguire questo esempio, incollare il codice in un Windows Form e chiamare RenderText1 dal gestore eventi del Paint modulo, passando e come PaintEventArgs.

private void RenderText1(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text", this.Font, 
        new Point(10, 10), SystemColors.ControlText);
}

Private Sub RenderText1(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Regular Text", _
        Me.Font, New Point(10, 10), SystemColors.ControlText)

End Sub

Commenti

È possibile modificare il modo in cui viene creato il testo utilizzando uno degli overload DrawText che accetta un parametro TextFormatFlags.

Se font è o forecolor è Color.Emptynull , il DrawText metodo disegnare il testo nel tipo di carattere o nel colore attualmente selezionato nel contesto del dispositivo specificato da dc. Se forecolor è Transparent, il testo non verrà disegnato.

Nota

Vedi anche

IDeviceContext

Si applica a

.NET Framework 4.8.1 e altre versioni

Prodotto	Versioni
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)

Crea il testo specificato all'interno dei limiti specificati, utilizzando il contesto di periferica, il tipo di carattere e il colore specificati.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, bounds As Rectangle, foreColor As Color)

Parametri

dc: IDeviceContext

Contesto di periferica in cui creare il testo.

text: ReadOnlySpan<Char>

Testo da disegnare.

font: Font

Classe Font da applicare al testo creato.

bounds: Rectangle

Struttura Rectangle che rappresenta i limiti del testo.

foreColor: Color

Classe Color da applicare al testo creato.

Eccezioni

ArgumentNullException

dc è null.

Si applica a

Windows Desktop 9 e altre versioni

Prodotto	Versioni
Windows Desktop	5, 6, 7, 8, 9

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, TextFormatFlags)

Crea il testo specificato nei limiti specificati, utilizzando il contesto di periferica, il tipo di carattere, il colore e le istruzioni di formattazione specificati.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, bounds As Rectangle, foreColor As Color, flags As TextFormatFlags)

Parametri

dc: IDeviceContext

Contesto di periferica in cui creare il testo.

text: ReadOnlySpan<Char>

Testo da disegnare.

font: Font

Classe Font da applicare al testo creato.

bounds: Rectangle

Struttura Rectangle che rappresenta i limiti del testo.

foreColor: Color

Classe Color da applicare al testo creato.

flags: TextFormatFlags

Combinazione bit per bit dei valori di TextFormatFlags.

Eccezioni

ArgumentNullException

dc è null.

ArgumentOutOfRangeException

La classe ModifyString è stata impostata.

Si applica a

Windows Desktop 9 e altre versioni

Prodotto	Versioni
Windows Desktop	5, 6, 7, 8, 9

Condividi tramite

TextRenderer.DrawText Metodo

Definizione

Overload

Commenti

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)

Parametri

Eccezioni

Si applica a

DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)

Parametri

Eccezioni

Esempio

Commenti

Si applica a

DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)

Parametri

Eccezioni

Esempio

Commenti

Si applica a

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)

Parametri

Eccezioni

Si applica a

DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)

Parametri

Eccezioni

Esempio

Commenti

Si applica a

DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)

Parametri

Eccezioni

Esempio

Commenti

Si applica a

DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)

Parametri

Eccezioni

Esempio

Commenti

Si applica a

DrawText(IDeviceContext, String, Font, Point, Color, Color)

Parametri

Eccezioni

Esempio

Commenti

Si applica a

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)

Parametri

Eccezioni

Si applica a

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)

Parametri

Eccezioni

Si applica a

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)

Parametri

Eccezioni

Si applica a

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)

Parametri

Eccezioni

Si applica a

DrawText(IDeviceContext, String, Font, Rectangle, Color)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

DrawText(IDeviceContext, String, Font, Point, Color)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)