Condividi tramite


TextRenderer.DrawText Metodo

Definizione

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

dc è null.

Si applica a

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

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

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

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.

È 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.

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

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

dc costruito in modo predefinito è null.

La classe ModifyString è stata impostata.

Si applica a

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

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.

È 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 è basato sul rendering del testo GDI e non è supportato per la stampa da Windows Forms. Usare invece i DrawString metodi della Graphics classe .

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

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

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.

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 .

Si applica a

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

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

È 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 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.

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 .

L'oggetto TextRenderer non 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

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

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.

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 .

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

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

dc è null.

La classe ModifyString è stata impostata.

Si applica a

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

dc è null.

Si applica a

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

dc è null.

La classe ModifyString è stata impostata.

Si applica a

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

dc è null.

Si applica a

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

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.

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.

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 .

Vedi anche

Si applica a

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

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.

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 .

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.

Vedi anche

Si applica a

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

dc è null.

Si applica a

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

dc è null.

La classe ModifyString è stata impostata.

Si applica a