TextRenderer.DrawText Metodo

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.

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

Overload

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

Commenti

Il rendering del testo offerto dalla classe TextRenderer si basa 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)

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Disegna il testo specificato nella posizione specificata utilizzando il contesto di dispositivo, 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 del dispositivo in cui disegnare il testo.

text: ReadOnlySpan<Char>

Testo da disegnare.

font: Font

Oggetto Font da applicare al testo disegnato.

pt: Point

Oggetto Point che rappresenta l'angolo superiore sinistro del testo disegnato.

foreColor: Color

Oggetto Color da applicare al testo disegnato.

Eccezioni

ArgumentNullException

dc è null.

Si applica a

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

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Disegna il testo specificato all'interno dei limiti specificati utilizzando il contesto di dispositivo, il tipo di carattere, il colore, il colore posteriore 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 del dispositivo in cui disegnare il testo.

text: String

Testo da disegnare.

font: Font

Oggetto Font da applicare al testo disegnato.

bounds: Rectangle

Oggetto Rectangle che rappresenta i limiti del testo.

foreColor: Color

Oggetto Color da applicare al testo.

backColor: Color

Oggetto Color da applicare all'area rappresentata da bounds.

flags: TextFormatFlags

Combinazione bit per bit dei TextFormatFlags valori.

Eccezioni

ArgumentNullException

dc è null.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il DrawText metodo . Per eseguire questo esempio, incollare il codice in un modulo di Windows e chiamare dal gestore eventi /> come .

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. Se fontforecolor, o backcolor è null o Empty, rispettivamente; il DrawText metodo disegnare 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 la modalità di disegno del testo usando uno degli DrawText overload che accettano un TextFormatFlags parametro. Ad esempio, il comportamento predefinito di consiste nell'aggiungere TextRenderer spaziatura interna al rettangolo di delimitazione del testo disegnato per contenere glifi sporgenti. Se è necessario disegnare una riga di testo senza questi spazi aggiuntivi, è consigliabile usare le versioni di DrawText e che accettano un MeasureText parametro e Size TextFormatFlags . Per un esempio, vedere MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

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

Si applica a

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

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Disegna il testo specificato nella posizione specificata utilizzando il contesto di dispositivo, il tipo di carattere, il colore, il colore posteriore 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 del dispositivo in cui disegnare il testo.

text: String

Testo da disegnare.

font: Font

Oggetto Font da applicare al testo disegnato.

pt: Point

Oggetto Point che rappresenta l'angolo superiore sinistro del testo disegnato.

foreColor: Color

Oggetto Color da applicare al testo.

backColor: Color

Oggetto Color da applicare all'area di sfondo del testo disegnato.

flags: TextFormatFlags

Combinazione bit per bit dei TextFormatFlags valori.

Eccezioni

ArgumentNullException

dc è null.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il DrawText metodo . Per eseguire questo esempio, incollare il codice in un modulo di Windows e chiamare dal gestore eventi /> come .

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 applicato all'area rettangolare contenente il testo disegnato. Se font o forecolor è null o Empty, rispettivamente; il DrawText metodo disegnare 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.

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

Note

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

Si applica a

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

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Disegna il testo specificato nella posizione specificata utilizzando il contesto di dispositivo, il tipo di carattere, il colore, il colore posteriore 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 del dispositivo in cui disegnare il testo.

text: ReadOnlySpan<Char>

Testo da disegnare.

font: Font

Oggetto Font da applicare al testo disegnato.

pt: Point

Oggetto Point che rappresenta l'angolo superiore sinistro del testo disegnato.

foreColor: Color

Oggetto Color da applicare al testo disegnato.

backColor: Color

Oggetto Color da applicare all'area di sfondo del testo disegnato.

flags: TextFormatFlags

Combinazione bit per bit dei TextFormatFlags valori.

Eccezioni

ArgumentNullException

dc è null.

ArgumentOutOfRangeException

ModifyString è impostato.

Si applica a

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

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Disegna il testo specificato all'interno dei limiti specificati utilizzando il contesto di dispositivo, 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 del dispositivo in cui disegnare il testo.

text: String

Testo da disegnare.

font: Font

Oggetto Font da applicare al testo disegnato.

bounds: Rectangle

Oggetto Rectangle che rappresenta i limiti del testo.

foreColor: Color

Oggetto Color da applicare al testo disegnato.

flags: TextFormatFlags

Combinazione bit per bit dei TextFormatFlags valori.

Eccezioni

ArgumentNullException

dc è null.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il DrawText metodo . Per eseguire questo esempio, incollare il codice in un modulo di Windows e chiamare dal gestore eventi /> come .

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

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

Si applica a

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

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Disegna il testo specificato all'interno dei limiti specificati utilizzando il contesto di dispositivo, il tipo di carattere, il colore e il colore posteriore 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 del dispositivo in cui disegnare il testo.

text: String

Testo da disegnare.

font: Font

Oggetto Font da applicare al testo disegnato.

bounds: Rectangle

Oggetto Rectangle che rappresenta i limiti del testo.

foreColor: Color

Oggetto Color da applicare al testo disegnato.

backColor: Color

Oggetto Color da applicare all'area rappresentata da bounds.

Eccezioni

ArgumentNullException

dc è null.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il DrawText metodo . Per eseguire questo esempio, incollare il codice in un modulo di Windows e chiamare dal gestore eventi /> come .

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 è forecolornull o Emptyrispettivamente; il DrawText metodo disegnare 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 genererà testo allineato orizzontalmente e verticalmente centrato nel rettangolo specificato dal bounds parametro . Per modificare la modalità di disegno del testo, usare una versione di che accetta un DrawText tipo di TextFormatFlags parametro.

Si applica a

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

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Disegna il testo specificato nella posizione specificata usando il contesto di dispositivo, 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 del dispositivo in cui disegnare il testo.

text: String

Testo da disegnare.

font: Font

Oggetto Font da applicare al testo disegnato.

pt: Point

Oggetto Point che rappresenta l'angolo superiore sinistro del testo disegnato.

foreColor: Color

Oggetto Color da applicare al testo disegnato.

flags: TextFormatFlags

Combinazione bit per bit dei TextFormatFlags valori.

Eccezioni

ArgumentNullException

dc è null.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il DrawText metodo . Per eseguire questo esempio, incollare il codice in un modulo di Windows e chiamare dal gestore eventi /> come .

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

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

Note

Si applica a

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

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Disegna il testo specificato nella posizione specificata, utilizzando il contesto di dispositivo, il tipo di carattere, il colore e il colore posteriore 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 del dispositivo in cui disegnare il testo.

text: String

Testo da disegnare.

font: Font

Oggetto Font da applicare al testo disegnato.

pt: Point

Oggetto Point che rappresenta l'angolo superiore sinistro del testo disegnato.

foreColor: Color

Oggetto Color da applicare al testo disegnato.

backColor: Color

Oggetto Color da applicare all'area di sfondo del testo disegnato.

Eccezioni

ArgumentNullException

dc è null.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il DrawText metodo . Per eseguire questo esempio, incollare il codice in un modulo di Windows e chiamare dal gestore eventi /> come .

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 è forecolornull o Color.Emptyrispettivamente; il DrawText metodo disegnare 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 la modalità di disegno del testo usando uno degli DrawText overload che accettano un TextFormatFlags parametro.

Note

Si applica a

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

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

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 del dispositivo in cui disegnare il testo.

text: ReadOnlySpan<Char>

Testo da disegnare.

font: Font

Oggetto Font da applicare al testo disegnato.

bounds: Rectangle

Oggetto Rectangle che rappresenta i limiti del testo.

foreColor: Color

Oggetto Color da applicare al testo disegnato.

backColor: Color

Oggetto Color da applicare all'area di sfondo del testo disegnato.

flags: TextFormatFlags

Combinazione bit per bit dei TextFormatFlags valori.

Eccezioni

ArgumentNullException

dc è null.

ArgumentOutOfRangeException

ModifyString è impostato.

Si applica a

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

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Disegna il testo specificato all'interno dei limiti specificati utilizzando il contesto di dispositivo, il tipo di carattere, il colore e il colore posteriore 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 del dispositivo in cui disegnare il testo.

text: ReadOnlySpan<Char>

Testo da disegnare.

font: Font

Oggetto Font da applicare al testo disegnato.

bounds: Rectangle

Oggetto Rectangle che rappresenta i limiti del testo.

foreColor: Color

Oggetto Color da applicare al testo disegnato.

backColor: Color

Oggetto Color da applicare all'area di sfondo del testo disegnato.

Eccezioni

ArgumentNullException

dc è null.

Si applica a

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

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Disegna il testo specificato nella posizione specificata usando il contesto di dispositivo, 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 del dispositivo in cui disegnare il testo.

text: ReadOnlySpan<Char>

Testo da disegnare.

font: Font

Oggetto Font da applicare al testo disegnato.

pt: Point

Oggetto Point che rappresenta l'angolo superiore sinistro del testo disegnato.

foreColor: Color

Oggetto Color da applicare al testo disegnato.

flags: TextFormatFlags

Combinazione bit per bit dei TextFormatFlags valori.

Eccezioni

ArgumentNullException

dc è null.

ArgumentOutOfRangeException

ModifyString è impostato.

Si applica a

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

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Disegna il testo specificato nella posizione specificata, utilizzando il contesto di dispositivo, il tipo di carattere, il colore e il colore posteriore 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 del dispositivo in cui disegnare il testo.

text: ReadOnlySpan<Char>

Testo da disegnare.

font: Font

Oggetto Font da applicare al testo disegnato.

pt: Point

Oggetto Point che rappresenta l'angolo superiore sinistro del testo disegnato.

foreColor: Color

Oggetto Color da applicare al testo disegnato.

backColor: Color

Oggetto Color da applicare all'area di sfondo del testo disegnato.

Eccezioni

ArgumentNullException

dc è null.

Si applica a

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

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Disegna il testo specificato all'interno dei limiti specificati, utilizzando il contesto di dispositivo, 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 del dispositivo in cui disegnare il testo.

text: String

Testo da disegnare.

font: Font

Oggetto Font da applicare al testo disegnato.

bounds: Rectangle

Oggetto Rectangle che rappresenta i limiti del testo.

foreColor: Color

Oggetto Color da applicare al testo disegnato.

Eccezioni

ArgumentNullException

dc è null.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il DrawText metodo . Per eseguire questo esempio, incollare il codice in un modulo di Windows e chiamare dal gestore eventi /> come .

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

Vedi anche

IDeviceContext

Si applica a

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

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Disegna il testo specificato nella posizione specificata utilizzando il contesto di dispositivo, 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 del dispositivo in cui disegnare il testo.

text: String

Testo da disegnare.

font: Font

Oggetto Font da applicare al testo disegnato.

pt: Point

Oggetto Point che rappresenta l'angolo superiore sinistro del testo disegnato.

foreColor: Color

Oggetto Color da applicare al testo disegnato.

Eccezioni

ArgumentNullException

dc è null.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il DrawText metodo . Per eseguire questo esempio, incollare il codice in un modulo di Windows e chiamare dal gestore eventi /> come .

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 la modalità di disegno del testo usando uno degli DrawText overload che accettano un TextFormatFlags parametro.

Se font è o null è forecolorColor.Empty , il DrawText metodo disegnare 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.

Note

Vedi anche

IDeviceContext

Si applica a

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

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Disegna il testo specificato all'interno dei limiti specificati, utilizzando il contesto di dispositivo, 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 del dispositivo in cui disegnare il testo.

text: ReadOnlySpan<Char>

Testo da disegnare.

font: Font

Oggetto Font da applicare al testo disegnato.

bounds: Rectangle

Oggetto Rectangle che rappresenta i limiti del testo.

foreColor: Color

Oggetto Color da applicare al testo disegnato.

Eccezioni

ArgumentNullException

dc è null.

Si applica a

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

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Origine:: TextRenderer.cs

Disegna il testo specificato all'interno dei limiti specificati utilizzando il contesto di dispositivo, 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 del dispositivo in cui disegnare il testo.

text: ReadOnlySpan<Char>

Testo da disegnare.

font: Font

Oggetto Font da applicare al testo disegnato.

bounds: Rectangle

Oggetto Rectangle che rappresenta i limiti del testo.

foreColor: Color

Oggetto Color da applicare al testo disegnato.

flags: TextFormatFlags

Combinazione bit per bit dei TextFormatFlags valori.

Eccezioni

ArgumentNullException

dc è null.

ArgumentOutOfRangeException

ModifyString è impostato.

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?