TextRenderer.DrawText Méthode

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Dessine le texte spécifié à l'emplacement indiqué, à l'aide du contexte de périphérique (Device Context), de la couleur et de la police spécifiés.

Surcharges

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)	Dessine le texte spécifié à l'emplacement indiqué, à l'aide du contexte de périphérique (Device Context), de la police et de la couleur spécifiés.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)	Dessine le texte spécifié dans les limites indiquées, à l'aide des instructions de contexte de périphérique (Device Context), de police, de couleur, de couleur d'arrière-plan et de mise en forme spécifiées.
DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)	Dessine le texte spécifié à l’emplacement indiqué, à l’aide des instructions de contexte d’appareil, de police, de couleur, de couleur d’arrière-plan et de mise en forme spécifiées.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)	Dessine le texte spécifié à l’emplacement indiqué, à l’aide des instructions de contexte d’appareil, de police, de couleur, de couleur d’arrière-plan et de mise en forme spécifiées.
DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)	Dessine le texte spécifié dans les limites indiquées, à l'aide des instructions de contexte de périphérique (Device Context), de police, de couleur et de mise en forme spécifiées.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)	Dessine le texte spécifié dans les limites indiquées, à l'aide du contexte de périphérique (Device Context), de la police, de la couleur et de la couleur d'arrière-plan spécifiés.
DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)	Dessine le texte spécifié à l'emplacement indiqué, à l'aide des instructions de contexte de périphérique (Device Context), de police, de couleur et de mise en forme spécifiées.
DrawText(IDeviceContext, String, Font, Point, Color, Color)	Dessine le texte spécifié à l'emplacement indiqué, à l'aide du contexte de périphérique (Device Context), de la police, de la couleur et de la couleur d'arrière-plan spécifiés.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)	Dessine le texte spécifié dans les limites indiquées, à l'aide des instructions de contexte de périphérique (Device Context), de police, de couleur, de couleur d'arrière-plan et de mise en forme spécifiées.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)	Dessine le texte spécifié dans les limites indiquées, à l'aide du contexte de périphérique (Device Context), de la police, de la couleur et de la couleur d'arrière-plan spécifiés.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)	Dessine le texte spécifié à l'emplacement indiqué, à l'aide des instructions de contexte de périphérique (Device Context), de police, de couleur et de mise en forme spécifiées.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)	Dessine le texte spécifié à l'emplacement indiqué, à l'aide du contexte de périphérique (Device Context), de la police, de la couleur et de la couleur d'arrière-plan spécifiés.
DrawText(IDeviceContext, String, Font, Rectangle, Color)	Dessine le texte spécifié dans les limites indiquées, à l'aide du contexte de périphérique (Device Context), de la police et de la couleur spécifiés.
DrawText(IDeviceContext, String, Font, Point, Color)	Dessine le texte spécifié à l'emplacement indiqué, à l'aide du contexte de périphérique (Device Context), de la police et de la couleur spécifiés.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)	Dessine le texte spécifié dans les limites indiquées, à l'aide du contexte de périphérique (Device Context), de la police et de la couleur spécifiés.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, TextFormatFlags)	Dessine le texte spécifié dans les limites indiquées, à l'aide des instructions de contexte de périphérique (Device Context), de police, de couleur et de mise en forme spécifiées.

Remarques

Le rendu de texte proposé par la classe est basé sur le TextRenderer rendu de texte GDI et n’est pas pris en charge pour l’impression à partir de Windows Forms. Utilisez plutôt les DrawString méthodes de la Graphics classe .

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

Dessine le texte spécifié à l'emplacement indiqué, à l'aide du contexte de périphérique (Device Context), de la police et de la couleur spécifiés.

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)

Paramètres

dc: IDeviceContext

Contexte de périphérique (Device Context) dans lequel dessiner le texte.

text: ReadOnlySpan<Char>

Texte à dessiner.

font: Font

Font à appliquer au texte dessiné.

pt: Point

Point qui représente le coin supérieur gauche du texte dessiné.

foreColor: Color

Color à appliquer au texte dessiné.

Exceptions

ArgumentNullException

dc a la valeur null.

S’applique à

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

Dessine le texte spécifié dans les limites indiquées, à l'aide des instructions de contexte de périphérique (Device Context), de police, de couleur, de couleur d'arrière-plan et de mise en forme spécifiées.

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)

Paramètres

dc: IDeviceContext

Contexte de périphérique (Device Context) dans lequel dessiner le texte.

text: String

Texte à dessiner.

font: Font

Font à appliquer au texte dessiné.

bounds: Rectangle

Rectangle qui représente les limites du texte.

foreColor: Color

Color à appliquer au texte.

backColor: Color

Color à appliquer à la zone représentée par bounds.

flags: TextFormatFlags

Combinaison d'opérations de bits des valeurs TextFormatFlags.

Exceptions

ArgumentNullException

dc a la valeur null.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode DrawText. Pour exécuter cet exemple, collez le code dans un Windows Form et appelez RenderText8 à partir du gestionnaire d’événements du Paint formulaire, en passant e comme 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

Remarques

Le backcolor paramètre est appliqué à la zone dans le bounds paramètre. Si font, forecolor ou backcolor est null ou Empty, respectivement ; la DrawText méthode dessine le texte dans la police ou la couleur actuellement sélectionnée dans le contexte d’appareil spécifié par dc. Si forecolor a la valeur Transparent, le texte n’est pas dessiné.

Vous pouvez manipuler le dessin du texte en utilisant une des surcharges de DrawText qui prend un paramètre TextFormatFlags. Par exemple, le comportement par défaut de TextRenderer est d'ajouter le remplissage au rectangle englobant du texte dessiné pour recevoir des glyphes surplombants. Si vous devez dessiner une ligne de texte sans ces espaces supplémentaires, vous devez utiliser les versions de DrawText et MeasureText qui prennent un paramètre Size et TextFormatFlags. Pour obtenir un exemple, consultez MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

ne prend pas en charge l’ajout TextRenderer de taquets de tabulation au texte dessiné, bien que vous puissiez développer des taquets de tabulation existants à l’aide de l’indicateur ExpandTabs .

S’applique à

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

Dessine le texte spécifié à l’emplacement indiqué, à l’aide des instructions de contexte d’appareil, de police, de couleur, de couleur d’arrière-plan et de mise en forme spécifiées.

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)

Paramètres

dc: IDeviceContext

Contexte de périphérique (Device Context) dans lequel dessiner le texte.

text: String

Texte à dessiner.

font: Font

Font à appliquer au texte dessiné.

pt: Point

Point qui représente le coin supérieur gauche du texte dessiné.

foreColor: Color

Color à appliquer au texte.

backColor: Color

Color à appliquer à la zone d'arrière-plan du texte dessiné.

flags: TextFormatFlags

Combinaison d'opérations de bits des valeurs TextFormatFlags.

Exceptions

ArgumentNullException

dc a la valeur null.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode DrawText. Pour exécuter cet exemple, collez le code dans un Windows Form et appelez RenderText7 à partir du gestionnaire d’événements du Paint formulaire, en passant e comme 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

Remarques

Le backcolor paramètre est appliqué à la zone rectangulaire contenant le texte dessiné. Si font ou forecolor est null ou Empty, respectivement ; la DrawText méthode dessine le texte dans la police ou la couleur actuellement sélectionnée dans le contexte d’appareil spécifié par dc. Si forecolor a la valeur Transparent, le texte n’est pas dessiné.

Notes

Les DrawText méthodes qui spécifient un Point comme coin supérieur gauche du texte dessiné ne s’affichent pas correctement sur Windows 2000. Si votre application est destinée à être utilisée sur des ordinateurs exécutant Windows 2000, vous devez utiliser l’une DrawText des méthodes qui spécifient un Rectangle pour les limites du texte dessiné.

S’applique à

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

Dessine le texte spécifié à l’emplacement indiqué, à l’aide des instructions de contexte d’appareil, de police, de couleur, de couleur d’arrière-plan et de mise en forme spécifiées.

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)

Paramètres

dc: IDeviceContext

Contexte de périphérique (Device Context) dans lequel dessiner le texte.

text: ReadOnlySpan<Char>

Texte à dessiner.

font: Font

Font à appliquer au texte dessiné.

pt: Point

Point qui représente le coin supérieur gauche du texte dessiné.

foreColor: Color

Color à appliquer au texte dessiné.

backColor: Color

Color à appliquer à la zone d'arrière-plan du texte dessiné.

flags: TextFormatFlags

Combinaison d'opérations de bits des valeurs TextFormatFlags.

Exceptions

ArgumentNullException

dc est null.

ArgumentOutOfRangeException

ModifyString est définie.

S’applique à

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

Dessine le texte spécifié dans les limites indiquées, à l'aide des instructions de contexte de périphérique (Device Context), de police, de couleur et de mise en forme spécifiées.

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)

Paramètres

dc: IDeviceContext

Contexte de périphérique (Device Context) dans lequel dessiner le texte.

text: String

Texte à dessiner.

font: Font

Font à appliquer au texte dessiné.

bounds: Rectangle

Rectangle qui représente les limites du texte.

foreColor: Color

Color à appliquer au texte dessiné.

flags: TextFormatFlags

Combinaison d'opérations de bits des valeurs TextFormatFlags.

Exceptions

ArgumentNullException

dc a la valeur null.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode DrawText. Pour exécuter cet exemple, collez le code dans un Windows Form et appelez RenderText6 à partir du gestionnaire d’événements du Paint formulaire, en passant e comme 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

Remarques

Si font ou color est null ou Empty, respectivement ; la DrawText méthode dessine le texte dans la police ou la couleur actuellement sélectionnée dans le contexte d’appareil spécifié par dc. Si forecolor a la valeur Transparent, le texte n’est pas dessiné.

ne prend pas en charge l’ajout TextRenderer de tabulations au texte dessiné, bien que vous puissiez développer des taquets de tabulation existants à l’aide de l’indicateur ExpandTabs .

S’applique à

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

Dessine le texte spécifié dans les limites indiquées, à l'aide du contexte de périphérique (Device Context), de la police, de la couleur et de la couleur d'arrière-plan spécifiés.

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)

Paramètres

dc: IDeviceContext

Contexte de périphérique (Device Context) dans lequel dessiner le texte.

text: String

Texte à dessiner.

font: Font

Font à appliquer au texte dessiné.

bounds: Rectangle

Rectangle qui représente les limites du texte.

foreColor: Color

Color à appliquer au texte dessiné.

backColor: Color

Color à appliquer à la zone représentée par bounds.

Exceptions

ArgumentNullException

dc a la valeur null.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode DrawText. Pour exécuter cet exemple, collez le code dans un Windows Form et appelez RenderText4 à partir du gestionnaire d’événements du Paint formulaire, en passant e comme 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

Remarques

Le backColor paramètre est appliqué à la zone dans le bounds paramètre. Si font, backcolor ou forecolor est null ou Empty, respectivement ; la DrawText méthode dessine le texte dans la police ou la couleur actuellement sélectionnée dans le contexte d’appareil spécifié par dc. Si forecolor a la valeur Transparent, le texte n’est pas dessiné.

Cette méthode aboutira à un texte centré horizontalement et verticalement dans le rectangle spécifié par le bounds paramètre. Pour modifier la façon dont le texte est dessiné, utilisez une version de DrawText qui prend un TextFormatFlags type de paramètre.

S’applique à

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

Dessine le texte spécifié à l'emplacement indiqué, à l'aide des instructions de contexte de périphérique (Device Context), de police, de couleur et de mise en forme spécifiées.

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)

Paramètres

dc: IDeviceContext

Contexte de périphérique (Device Context) dans lequel dessiner le texte.

text: String

Texte à dessiner.

font: Font

Font à appliquer au texte dessiné.

pt: Point

Point qui représente le coin supérieur gauche du texte dessiné.

foreColor: Color

Color à appliquer au texte dessiné.

flags: TextFormatFlags

Combinaison d'opérations de bits des valeurs TextFormatFlags.

Exceptions

ArgumentNullException

dc a la valeur null.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode DrawText. Pour exécuter cet exemple, collez le code dans un Windows Form et appelez RenderText5 à partir du gestionnaire d’événements du Paint formulaire, en passant e comme 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

Remarques

Le backColor paramètre est appliqué à la zone dans le bounds paramètre. Si font ou forecolor est null ou Color.Empty, respectivement ; la DrawText méthode dessine le texte dans la police ou la couleur actuellement sélectionnée dans le contexte d’appareil spécifié par dc. Si forecolor a la valeur Transparent, le texte n’est pas dessiné.

ne prend pas en charge l’ajout TextRenderer de tabulations au texte dessiné, bien que vous puissiez développer des taquets de tabulation existants à l’aide de l’indicateur ExpandTabs .

Notes

Les DrawText méthodes qui spécifient un Point comme coin supérieur gauche du texte dessiné ne s’affichent pas correctement sur Windows 2000. Si votre application est destinée à être utilisée sur des machines exécutant Windows 2000, vous devez utiliser l’une DrawText des méthodes qui spécifient un Rectangle pour les limites du texte dessiné.

S’applique à

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

Dessine le texte spécifié à l'emplacement indiqué, à l'aide du contexte de périphérique (Device Context), de la police, de la couleur et de la couleur d'arrière-plan spécifiés.

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)

Paramètres

dc: IDeviceContext

Contexte de périphérique (Device Context) dans lequel dessiner le texte.

text: String

Texte à dessiner.

font: Font

Font à appliquer au texte dessiné.

pt: Point

Point qui représente le coin supérieur gauche du texte dessiné.

foreColor: Color

Color à appliquer au texte dessiné.

backColor: Color

Color à appliquer à la zone d'arrière-plan du texte dessiné.

Exceptions

ArgumentNullException

dc a la valeur null.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode DrawText. Pour exécuter cet exemple, collez le code dans un Windows Form et appelez RenderText3 à partir du gestionnaire d’événements du Paint formulaire, en passant e comme 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

Remarques

Le backColor paramètre est appliqué à la zone rectangulaire contenant le texte dessiné. Si font, backcolor ou forecolor est null ou Color.Empty, respectivement ; la DrawText méthode dessine le texte dans la police ou la couleur actuellement sélectionnée dans le contexte d’appareil spécifié par dc. Si forecolor a la valeur Transparent, le texte n’est pas dessiné.

Vous pouvez manipuler le dessin du texte en utilisant une des surcharges de DrawText qui prend un paramètre TextFormatFlags.

Notes

Les DrawText méthodes qui spécifient un Point comme coin supérieur gauche du texte dessiné ne s’affichent pas correctement sur Windows 2000. Si votre application est destinée à être utilisée sur des machines exécutant Windows 2000, vous devez utiliser l’une DrawText des méthodes qui spécifient un Rectangle pour les limites du texte dessiné.

S’applique à

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

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)

Paramètres

dc: IDeviceContext

Contexte de périphérique (Device Context) dans lequel dessiner le texte.

text: ReadOnlySpan<Char>

Texte à dessiner.

font: Font

Font à appliquer au texte dessiné.

bounds: Rectangle

Rectangle qui représente les limites du texte.

foreColor: Color

Color à appliquer au texte dessiné.

backColor: Color

Color à appliquer à la zone d'arrière-plan du texte dessiné.

flags: TextFormatFlags

Combinaison d'opérations de bits des valeurs TextFormatFlags.

Exceptions

ArgumentNullException

dc a la valeur null.

ArgumentOutOfRangeException

ModifyString est définie.

S’applique à

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

Dessine le texte spécifié dans les limites indiquées, à l'aide du contexte de périphérique (Device Context), de la police, de la couleur et de la couleur d'arrière-plan spécifiés.

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)

Paramètres

dc: IDeviceContext

Contexte de périphérique (Device Context) dans lequel dessiner le texte.

text: ReadOnlySpan<Char>

Texte à dessiner.

font: Font

Font à appliquer au texte dessiné.

bounds: Rectangle

Rectangle qui représente les limites du texte.

foreColor: Color

Color à appliquer au texte dessiné.

backColor: Color

Color à appliquer à la zone d'arrière-plan du texte dessiné.

Exceptions

ArgumentNullException

dc a la valeur null.

S’applique à

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

Dessine le texte spécifié à l'emplacement indiqué, à l'aide des instructions de contexte de périphérique (Device Context), de police, de couleur et de mise en forme spécifiées.

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)

Paramètres

dc: IDeviceContext

Contexte de périphérique (Device Context) dans lequel dessiner le texte.

text: ReadOnlySpan<Char>

Texte à dessiner.

font: Font

Font à appliquer au texte dessiné.

pt: Point

Point qui représente le coin supérieur gauche du texte dessiné.

foreColor: Color

Color à appliquer au texte dessiné.

flags: TextFormatFlags

Combinaison d'opérations de bits des valeurs TextFormatFlags.

Exceptions

ArgumentNullException

dc a la valeur null.

ArgumentOutOfRangeException

ModifyString est définie.

S’applique à

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

Dessine le texte spécifié à l'emplacement indiqué, à l'aide du contexte de périphérique (Device Context), de la police, de la couleur et de la couleur d'arrière-plan spécifiés.

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)

Paramètres

dc: IDeviceContext

Contexte de périphérique (Device Context) dans lequel dessiner le texte.

text: ReadOnlySpan<Char>

Texte à dessiner.

font: Font

Font à appliquer au texte dessiné.

pt: Point

Point qui représente le coin supérieur gauche du texte dessiné.

foreColor: Color

Color à appliquer au texte dessiné.

backColor: Color

Color à appliquer à la zone d'arrière-plan du texte dessiné.

Exceptions

ArgumentNullException

dc a la valeur null.

S’applique à

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

Dessine le texte spécifié dans les limites indiquées, à l'aide du contexte de périphérique (Device Context), de la police et de la couleur spécifiés.

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)

Paramètres

dc: IDeviceContext

Contexte de périphérique (Device Context) dans lequel dessiner le texte.

text: String

Texte à dessiner.

font: Font

Font à appliquer au texte dessiné.

bounds: Rectangle

Rectangle qui représente les limites du texte.

foreColor: Color

Color à appliquer au texte dessiné.

Exceptions

ArgumentNullException

dc a la valeur null.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode DrawText. Pour exécuter cet exemple, collez le code dans un Windows Form et appelez RenderText2 à partir du gestionnaire d’événements du Paint formulaire, en passant e comme 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

Remarques

Si font ou forecolor est null ou Color.Empty, respectivement ; la DrawText méthode dessine le texte dans la police ou la couleur actuellement sélectionnée dans le contexte d’appareil spécifié par dc. Si forecolor a la valeur Transparent, le texte n’est pas dessiné.

Voir aussi

IDeviceContext

S’applique à

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

Dessine le texte spécifié à l'emplacement indiqué, à l'aide du contexte de périphérique (Device Context), de la police et de la couleur spécifiés.

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)

Paramètres

dc: IDeviceContext

Contexte de périphérique (Device Context) dans lequel dessiner le texte.

text: String

Texte à dessiner.

font: Font

Font à appliquer au texte dessiné.

pt: Point

Point qui représente le coin supérieur gauche du texte dessiné.

foreColor: Color

Color à appliquer au texte dessiné.

Exceptions

ArgumentNullException

dc a la valeur null.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode DrawText. Pour exécuter cet exemple, collez le code dans un Windows Form et appelez RenderText1 à partir du gestionnaire d’événements du Paint formulaire, en passant e comme 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

Remarques

Vous pouvez manipuler le dessin du texte en utilisant une des surcharges de DrawText qui prend un paramètre TextFormatFlags.

Si font est null ou forecolor est Color.Empty, la DrawText méthode dessine le texte dans la police ou la couleur actuellement sélectionnée dans le contexte d’appareil spécifié par dc. Si forecolor a la valeur Transparent, le texte n’est pas dessiné.

Notes

Les DrawText méthodes qui spécifient un Point comme coin supérieur gauche du texte dessiné ne s’affichent pas correctement sur Windows 2000. Si votre application est destinée à être utilisée sur des machines exécutant Windows 2000, vous devez utiliser l’une DrawText des méthodes qui spécifient un Rectangle pour les limites du texte dessiné.

Voir aussi

IDeviceContext

S’applique à

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

Dessine le texte spécifié dans les limites indiquées, à l'aide du contexte de périphérique (Device Context), de la police et de la couleur spécifiés.

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)

Paramètres

dc: IDeviceContext

Contexte de périphérique (Device Context) dans lequel dessiner le texte.

text: ReadOnlySpan<Char>

Texte à dessiner.

font: Font

Font à appliquer au texte dessiné.

bounds: Rectangle

Rectangle qui représente les limites du texte.

foreColor: Color

Color à appliquer au texte dessiné.

Exceptions

ArgumentNullException

dc a la valeur null.

S’applique à

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

Dessine le texte spécifié dans les limites indiquées, à l'aide des instructions de contexte de périphérique (Device Context), de police, de couleur et de mise en forme spécifiées.

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)