TextRenderer.DrawText Metódus

Definíció

Névtér:: System.Windows.Forms

Szerelvény:: System.Windows.Forms.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

A megadott szöveg rajzolása a megadott helyen a megadott eszközkörnyezet, szín és betűtípus használatával.

Túlterhelések

Név	Description
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)	A megadott szöveg rajzolása a megadott helyen a megadott eszközkörnyezet, betűtípus és szín használatával.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)	A megadott szövegrészt a megadott kereten belül rajzolja meg a megadott eszközkörnyezet, betűtípus, szín, háttérszín és formázási utasítások használatával.
DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)	A megadott helyen rajzolja meg a megadott szöveget a megadott eszközkörnyezet, betűtípus, szín, háttérszín és formázási utasítások használatával.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)	A megadott helyen rajzolja meg a megadott szöveget a megadott eszközkörnyezet, betűtípus, szín, háttérszín és formázási utasítások használatával.
DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)	A megadott szöveget a megadott kereten belül rajzolja meg a megadott eszközkörnyezet, betűtípus, szín és formázási utasítások használatával.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)	A megadott szöveget a megadott kereten belül rajzolja meg a megadott eszközkörnyezet, betűtípus, szín és háttérszín használatával.
DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)	A megadott szöveg rajzolása a megadott helyen a megadott eszközkörnyezet, betűtípus, szín és formázási utasítások használatával.
DrawText(IDeviceContext, String, Font, Point, Color, Color)	A megadott szöveget a megadott helyen rajzolja meg a megadott eszközkörnyezet, betűtípus, szín és háttérszín használatával.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)	A megadott szövegrészt a megadott kereten belül rajzolja meg a megadott eszközkörnyezet, betűtípus, szín, háttérszín és formázási utasítások használatával.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)	A megadott szöveget a megadott kereten belül rajzolja meg a megadott eszközkörnyezet, betűtípus, szín és háttérszín használatával.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)	A megadott szöveg rajzolása a megadott helyen a megadott eszközkörnyezet, betűtípus, szín és formázási utasítások használatával.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)	A megadott szöveget a megadott helyen rajzolja meg a megadott eszközkörnyezet, betűtípus, szín és háttérszín használatával.
DrawText(IDeviceContext, String, Font, Rectangle, Color)	A megadott szöveget a megadott kereteken belül rajzolja meg a megadott eszközkörnyezet, betűtípus és szín használatával.
DrawText(IDeviceContext, String, Font, Point, Color)	A megadott szöveg rajzolása a megadott helyen a megadott eszközkörnyezet, betűtípus és szín használatával.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)	A megadott szöveget a megadott kereteken belül rajzolja meg a megadott eszközkörnyezet, betűtípus és szín használatával.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, TextFormatFlags)	A megadott szöveget a megadott kereten belül rajzolja meg a megadott eszközkörnyezet, betűtípus, szín és formázási utasítások használatával.

Megjegyzések

A TextRenderer osztály által kínált szövegmegjelenítés GDI-szövegmegjelenítésen alapul, és nem támogatott Windows Forms nyomtatásához. Ehelyett használja az DrawString osztály metódusait Graphics .

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

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

A megadott szöveg rajzolása a megadott helyen a megadott eszközkörnyezet, betűtípus és szín használatával.

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éterek

dc: IDeviceContext

Az eszközkörnyezet, amelyben meg kell rajzolni a szöveget.

text: ReadOnlySpan<Char>

A rajzolni kívánt szöveg.

font: Font

A Font rajzolt szövegre alkalmazandó.

pt: Point

Ez Point a rajzolt szöveg bal felső sarkát jelöli.

foreColor: Color

A Color rajzolt szövegre alkalmazandó.

Kivételek

ArgumentNullException

dc az null.

A következőre érvényes:

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

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

A megadott szövegrészt a megadott kereten belül rajzolja meg a megadott eszközkörnyezet, betűtípus, szín, háttérszín és formázási utasítások használatával.

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éterek

dc: IDeviceContext

Az eszközkörnyezet, amelyben meg kell rajzolni a szöveget.

text: String

A rajzolni kívánt szöveg.

font: Font

A Font rajzolt szövegre alkalmazandó.

bounds: Rectangle

A Rectangle szöveg határait jelképező érték.

foreColor: Color

A Color szövegre alkalmazandó.

backColor: Color

A Color területi képviselő által boundsképviselt területre alkalmazandó.

flags: TextFormatFlags

Az értékek bitenkénti kombinációja TextFormatFlags .

Kivételek

ArgumentNullException

dc az null.

Példák

Az alábbi példakód bemutatja a DrawText metódus használatát. A példa futtatásához illessze be a kódot egy Windows űrlapba, és hívja meg RenderText8 az űrlap Paint eseménykezelőjéből, és adja át ePaintEventArgs.

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

Megjegyzések

A backcolor paraméter a If boundsparaméteren. belüli font területre lesz alkalmazva, forecolor vagy backcolornull az is, vagy Emptyaz; a metódus a DrawText szöveget a megadott eszközkörnyezetben dcjelenleg kijelölt betűtípusban vagy színben rajzolja meg. Ha forecolor igen Transparent, a szöveg nem lesz megrajzolva.

A paramétert használó DrawText túlterhelések egyikével módosíthatja a TextFormatFlags szöveg rajzolásának módját. Az alapértelmezett viselkedés például az TextRenderer , hogy a megrajzolt szöveg határoló téglalapjára kitöltést ad, hogy elférjenek a túlnyúló karakterjelek. Ha szövegsort kell rajzolnia ezek nélkül a plusz szóközök nélkül, használja azokat a verziókat DrawText MeasureText, amelyek egy és Size egy paramétert TextFormatFlags vesznek igénybe. Példaként tekintse meg a MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)-t.

Ez TextRenderer nem támogatja a tabulátorok hozzáadását a rajzolt szöveghez, bár a meglévő tabulátorok a ExpandTabs jelölővel kibonthatók.

A következőre érvényes:

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

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

A megadott helyen rajzolja meg a megadott szöveget a megadott eszközkörnyezet, betűtípus, szín, háttérszín és formázási utasítások használatával.

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éterek

dc: IDeviceContext

Az eszközkörnyezet, amelyben meg kell rajzolni a szöveget.

text: String

A rajzolni kívánt szöveg.

font: Font

A Font rajzolt szövegre alkalmazandó.

pt: Point

Ez Point a rajzolt szöveg bal felső sarkát jelöli.

foreColor: Color

A Color szövegre alkalmazandó.

backColor: Color

A Color rajzolt szöveg háttérterületére alkalmazandó.

flags: TextFormatFlags

Az értékek bitenkénti kombinációja TextFormatFlags .

Kivételek

ArgumentNullException

dc az null.

Példák

Az alábbi példakód bemutatja a DrawText metódus használatát. A példa futtatásához illessze be a kódot egy Windows űrlapba, és hívja meg RenderText7 az űrlap Paint eseménykezelőjéből, és adja át ePaintEventArgs.

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

Megjegyzések

A backcolor paraméter a rajzolt szöveget tartalmazó téglalap alakú területet alkalmazza. Ha font vagy forecolor igen nullEmpty, akkor a metódus a DrawText szöveget a megadott eszközkörnyezetben jelenleg kijelölt betűtípusban vagy színben rajzolja dcmeg. Ha forecolor igen Transparent, a szöveg nem lesz megrajzolva.

Ez TextRenderer nem támogatja a tabulátorok hozzáadását a rajzolt szöveghez, bár a meglévő tabulátorok a ExpandTabs jelölővel kibonthatók.

Note

Az DrawText metódusok, amelyek a rajzolt szöveg bal felső sarkában Point adnak meg, nem jelennek meg megfelelően a 2000. Windows. Ha az alkalmazás a 2000 Windows futó gépeken való használatra készült, akkor az egyik olyan DrawText metódust kell használnia, amely Rectangle határoz meg a megrajzolt szöveg határaihoz.

A következőre érvényes:

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

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

A megadott helyen rajzolja meg a megadott szöveget a megadott eszközkörnyezet, betűtípus, szín, háttérszín és formázási utasítások használatával.

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éterek

dc: IDeviceContext

Az eszközkörnyezet, amelyben meg kell rajzolni a szöveget.

text: ReadOnlySpan<Char>

A rajzolni kívánt szöveg.

font: Font

A Font rajzolt szövegre alkalmazandó.

pt: Point

Ez Point a rajzolt szöveg bal felső sarkát jelöli.

foreColor: Color

A Color rajzolt szövegre alkalmazandó.

backColor: Color

A Color rajzolt szöveg háttérterületére alkalmazandó.

flags: TextFormatFlags

Az értékek bitenkénti kombinációja TextFormatFlags .

Kivételek

ArgumentNullException

dc az null.

ArgumentOutOfRangeException

ModifyString be van állítva.

A következőre érvényes:

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

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

A megadott szöveget a megadott kereten belül rajzolja meg a megadott eszközkörnyezet, betűtípus, szín és formázási utasítások használatával.

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éterek

dc: IDeviceContext

Az eszközkörnyezet, amelyben meg kell rajzolni a szöveget.

text: String

A rajzolni kívánt szöveg.

font: Font

A Font rajzolt szövegre alkalmazandó.

bounds: Rectangle

A Rectangle szöveg határait jelképező érték.

foreColor: Color

A Color rajzolt szövegre alkalmazandó.

flags: TextFormatFlags

Az értékek bitenkénti kombinációja TextFormatFlags .

Kivételek

ArgumentNullException

dc az null.

Példák

Az alábbi példakód bemutatja a DrawText metódus használatát. A példa futtatásához illessze be a kódot egy Windows űrlapba, és hívja meg RenderText6 az űrlap Paint eseménykezelőjéből, és adja át ePaintEventArgs.

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

Megjegyzések

Ha font vagy color igen nullEmpty, akkor a metódus a DrawText szöveget a megadott eszközkörnyezetben jelenleg kijelölt betűtípusban vagy színben rajzolja dcmeg. Ha forecolor igen Transparent, a szöveg nem lesz megrajzolva.

Ez TextRenderer nem támogatja a tabulátorok hozzáadását a rajzolt szöveghez, bár a meglévő tabulátorok a ExpandTabs jelölővel kibonthatók.

A következőre érvényes:

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

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

A megadott szöveget a megadott kereten belül rajzolja meg a megadott eszközkörnyezet, betűtípus, szín és háttérszín használatával.

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éterek

dc: IDeviceContext

Az eszközkörnyezet, amelyben meg kell rajzolni a szöveget.

text: String

A rajzolni kívánt szöveg.

font: Font

A Font rajzolt szövegre alkalmazandó.

bounds: Rectangle

A Rectangle szöveg határait jelképező érték.

foreColor: Color

A Color rajzolt szövegre alkalmazandó.

backColor: Color

A Color területi képviselő által boundsképviselt területre alkalmazandó.

Kivételek

ArgumentNullException

dc az null.

Példák

Az alábbi példakód bemutatja a DrawText metódus használatát. A példa futtatásához illessze be a kódot egy Windows űrlapba, és hívja meg RenderText4 az űrlap Paint eseménykezelőjéből, és adja át ePaintEventArgs.

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

Megjegyzések

A backColor paraméter a paraméteren belüli bounds területre lesz alkalmazva. Ha fontvagy backcolorforecolor igen nullEmpty, akkor a metódus a DrawText szöveget a megadott eszközkörnyezetben jelenleg kijelölt betűtípusban vagy színben rajzolja dcmeg. Ha forecolor igen Transparent, a szöveg nem lesz megrajzolva.

Ez a módszer a paraméter által bounds megadott téglalapban vízszintesen és függőlegesen középre igazított szöveget eredményez. A szöveg rajzolásának módosításához használjon egy paramétertípust használó verziót DrawText TextFormatFlags .

A következőre érvényes:

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

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

A megadott szöveg rajzolása a megadott helyen a megadott eszközkörnyezet, betűtípus, szín és formázási utasítások használatával.

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éterek

dc: IDeviceContext

Az eszközkörnyezet, amelyben meg kell rajzolni a szöveget.

text: String

A rajzolni kívánt szöveg.

font: Font

A Font rajzolt szövegre alkalmazandó.

pt: Point

Ez Point a rajzolt szöveg bal felső sarkát jelöli.

foreColor: Color

A Color rajzolt szövegre alkalmazandó.

flags: TextFormatFlags

Az értékek bitenkénti kombinációja TextFormatFlags .

Kivételek

ArgumentNullException

dc az null.

Példák

Az alábbi példakód bemutatja a DrawText metódus használatát. A példa futtatásához illessze be a kódot egy Windows űrlapba, és hívja meg RenderText5 az űrlap Paint eseménykezelőjéből, és adja át ePaintEventArgs.

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

Megjegyzések

A backColor paraméter a paraméteren belüli bounds területre lesz alkalmazva. Ha font vagy forecolor igen nullColor.Empty, akkor a metódus a DrawText szöveget a megadott eszközkörnyezetben jelenleg kijelölt betűtípusban vagy színben rajzolja dcmeg. Ha forecolor igen Transparent, a szöveg nem lesz megrajzolva.

Ez TextRenderer nem támogatja a tabulátorok hozzáadását a rajzolt szöveghez, bár a meglévő tabulátorok a ExpandTabs jelölővel kibonthatók.

Note

A következőre érvényes:

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

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

A megadott szöveget a megadott helyen rajzolja meg a megadott eszközkörnyezet, betűtípus, szín és háttérszín használatával.

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éterek

dc: IDeviceContext

Az eszközkörnyezet, amelyben meg kell rajzolni a szöveget.

text: String

A rajzolni kívánt szöveg.

font: Font

A Font rajzolt szövegre alkalmazandó.

pt: Point

Ez Point a rajzolt szöveg bal felső sarkát jelöli.

foreColor: Color

A Color rajzolt szövegre alkalmazandó.

backColor: Color

A Color rajzolt szöveg háttérterületére alkalmazandó.

Kivételek

ArgumentNullException

dc az null.

Példák

Az alábbi példakód bemutatja a DrawText metódus használatát. A példa futtatásához illessze be a kódot egy Windows űrlapba, és hívja meg RenderText3 az űrlap Paint eseménykezelőjéből, és adja át ePaintEventArgs.

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

Megjegyzések

A backColor paraméter a rajzolt szöveget tartalmazó négyszögletes területre lesz alkalmazva. Ha fontvagy backcolorforecolor igen nullColor.Empty, akkor a metódus a DrawText szöveget a megadott eszközkörnyezetben jelenleg kijelölt betűtípusban vagy színben rajzolja dcmeg. Ha forecolor igen Transparent, a szöveg nem lesz megrajzolva.

A paramétert használó DrawText túlterhelések egyikével módosíthatja a TextFormatFlags szöveg rajzolásának módját.

Note

A következőre érvényes:

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

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

A megadott szövegrészt a megadott kereten belül rajzolja meg a megadott eszközkörnyezet, betűtípus, szín, háttérszín és formázási utasítások használatával.

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éterek

dc: IDeviceContext

Az eszközkörnyezet, amelyben meg kell rajzolni a szöveget.

text: ReadOnlySpan<Char>

A rajzolni kívánt szöveg.

font: Font

A Font rajzolt szövegre alkalmazandó.

bounds: Rectangle

A Rectangle szöveg határait jelképező érték.

foreColor: Color

A Color rajzolt szövegre alkalmazandó.

backColor: Color

A Color rajzolt szöveg háttérterületére alkalmazandó.

flags: TextFormatFlags

Az értékek bitenkénti kombinációja TextFormatFlags .

Kivételek

ArgumentNullException

dc az null.

ArgumentOutOfRangeException

ModifyString be van állítva.

A következőre érvényes:

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

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

A megadott szöveget a megadott kereten belül rajzolja meg a megadott eszközkörnyezet, betűtípus, szín és háttérszín használatával.

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éterek

dc: IDeviceContext

Az eszközkörnyezet, amelyben meg kell rajzolni a szöveget.

text: ReadOnlySpan<Char>

A rajzolni kívánt szöveg.

font: Font

A Font rajzolt szövegre alkalmazandó.

bounds: Rectangle

A Rectangle szöveg határait jelképező érték.

foreColor: Color

A Color rajzolt szövegre alkalmazandó.

backColor: Color

A Color rajzolt szöveg háttérterületére alkalmazandó.

Kivételek

ArgumentNullException

dc az null.

A következőre érvényes:

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

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

A megadott szöveg rajzolása a megadott helyen a megadott eszközkörnyezet, betűtípus, szín és formázási utasítások használatával.

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éterek

dc: IDeviceContext

Az eszközkörnyezet, amelyben meg kell rajzolni a szöveget.

text: ReadOnlySpan<Char>

A rajzolni kívánt szöveg.

font: Font

A Font rajzolt szövegre alkalmazandó.

pt: Point

Ez Point a rajzolt szöveg bal felső sarkát jelöli.

foreColor: Color

A Color rajzolt szövegre alkalmazandó.

flags: TextFormatFlags

Az értékek bitenkénti kombinációja TextFormatFlags .

Kivételek

ArgumentNullException

dc az null.

ArgumentOutOfRangeException

ModifyString be van állítva.

A következőre érvényes:

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

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

A megadott szöveget a megadott helyen rajzolja meg a megadott eszközkörnyezet, betűtípus, szín és háttérszín használatával.

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éterek

dc: IDeviceContext

Az eszközkörnyezet, amelyben meg kell rajzolni a szöveget.

text: ReadOnlySpan<Char>

A rajzolni kívánt szöveg.

font: Font

A Font rajzolt szövegre alkalmazandó.

pt: Point

Ez Point a rajzolt szöveg bal felső sarkát jelöli.

foreColor: Color

A Color rajzolt szövegre alkalmazandó.

backColor: Color

A Color rajzolt szöveg háttérterületére alkalmazandó.

Kivételek

ArgumentNullException

dc az null.

A következőre érvényes:

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

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

A megadott szöveget a megadott kereteken belül rajzolja meg a megadott eszközkörnyezet, betűtípus és szín használatával.

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éterek

dc: IDeviceContext

Az eszközkörnyezet, amelyben meg kell rajzolni a szöveget.

text: String

A rajzolni kívánt szöveg.

font: Font

A Font rajzolt szövegre alkalmazandó.

bounds: Rectangle

A Rectangle szöveg határait jelképező érték.

foreColor: Color

A Color rajzolt szövegre alkalmazandó.

Kivételek

ArgumentNullException

dc az null.

Példák

Az alábbi példakód bemutatja a DrawText metódus használatát. A példa futtatásához illessze be a kódot egy Windows űrlapba, és hívja meg RenderText2 az űrlap Paint eseménykezelőjéből, és adja át ePaintEventArgs.

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

Megjegyzések

Ha font vagy forecolor igen nullColor.Empty, akkor a metódus a DrawText szöveget a megadott eszközkörnyezetben jelenleg kijelölt betűtípusban vagy színben rajzolja dcmeg. Ha forecolor igen Transparent, a szöveg nem lesz megrajzolva.

Lásd még

IDeviceContext

A következőre érvényes:

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

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

A megadott szöveg rajzolása a megadott helyen a megadott eszközkörnyezet, betűtípus és szín használatával.

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éterek

dc: IDeviceContext

Az eszközkörnyezet, amelyben meg kell rajzolni a szöveget.

text: String

A rajzolni kívánt szöveg.

font: Font

A Font rajzolt szövegre alkalmazandó.

pt: Point

Ez Point a rajzolt szöveg bal felső sarkát jelöli.

foreColor: Color

A Color rajzolt szövegre alkalmazandó.

Kivételek

ArgumentNullException

dc az null.

Példák

Az alábbi példakód bemutatja a DrawText metódus használatát. A példa futtatásához illessze be a kódot egy Windows űrlapba, és hívja meg RenderText1 az űrlap Paint eseménykezelőjéből, és adja át ePaintEventArgs.

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

Megjegyzések

A paramétert használó DrawText túlterhelések egyikével módosíthatja a TextFormatFlags szöveg rajzolásának módját.

Ha font igen nullforecolorColor.Empty, akkor a metódus a DrawText szöveget a megadott eszközkörnyezetben kijelölt betűtípusban vagy színben rajzolja dcmeg. Ha forecolor igen Transparent, a szöveg nem lesz megrajzolva.

Note

Lásd még

IDeviceContext

A következőre érvényes:

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

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

A megadott szöveget a megadott kereteken belül rajzolja meg a megadott eszközkörnyezet, betűtípus és szín használatával.

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éterek

dc: IDeviceContext

Az eszközkörnyezet, amelyben meg kell rajzolni a szöveget.

text: ReadOnlySpan<Char>

A rajzolni kívánt szöveg.

font: Font

A Font rajzolt szövegre alkalmazandó.

bounds: Rectangle

A Rectangle szöveg határait jelképező érték.

foreColor: Color

A Color rajzolt szövegre alkalmazandó.

Kivételek

ArgumentNullException

dc az null.

A következőre érvényes:

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

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

Forrás:: TextRenderer.cs

A megadott szöveget a megadott kereten belül rajzolja meg a megadott eszközkörnyezet, betűtípus, szín és formázási utasítások használatával.

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)

Paraméterek

dc: IDeviceContext

Az eszközkörnyezet, amelyben meg kell rajzolni a szöveget.

text: ReadOnlySpan<Char>

A rajzolni kívánt szöveg.

font: Font

A Font rajzolt szövegre alkalmazandó.

bounds: Rectangle

A Rectangle szöveg határait jelképező érték.

foreColor: Color

A Color rajzolt szövegre alkalmazandó.

flags: TextFormatFlags

Az értékek bitenkénti kombinációja TextFormatFlags .

Kivételek

ArgumentNullException

dc az null.

ArgumentOutOfRangeException

ModifyString be van állítva.

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?