GraphicsPath.AddString Méthode

Définition

Ajoute une chaîne de texte à ce tracé.Adds a text string to this path.

Surcharges

AddString(String, FontFamily, Int32, Single, RectangleF, StringFormat)

Ajoute une chaîne de texte à ce tracé.Adds a text string to this path.

AddString(String, FontFamily, Int32, Single, Rectangle, StringFormat)

Ajoute une chaîne de texte à ce tracé.Adds a text string to this path.

AddString(String, FontFamily, Int32, Single, PointF, StringFormat)

Ajoute une chaîne de texte à ce tracé.Adds a text string to this path.

AddString(String, FontFamily, Int32, Single, Point, StringFormat)

Ajoute une chaîne de texte à ce tracé.Adds a text string to this path.

AddString(String, FontFamily, Int32, Single, RectangleF, StringFormat)

Ajoute une chaîne de texte à ce tracé.Adds a text string to this path.

public:
 void AddString(System::String ^ s, System::Drawing::FontFamily ^ family, int style, float emSize, System::Drawing::RectangleF layoutRect, System::Drawing::StringFormat ^ format);
public void AddString (string s, System.Drawing.FontFamily family, int style, float emSize, System.Drawing.RectangleF layoutRect, System.Drawing.StringFormat format);
public void AddString (string s, System.Drawing.FontFamily family, int style, float emSize, System.Drawing.RectangleF layoutRect, System.Drawing.StringFormat? format);
member this.AddString : string * System.Drawing.FontFamily * int * single * System.Drawing.RectangleF * System.Drawing.StringFormat -> unit
Public Sub AddString (s As String, family As FontFamily, style As Integer, emSize As Single, layoutRect As RectangleF, format As StringFormat)

Paramètres

s
String

String à ajouter.The String to add.

family
FontFamily

FontFamily qui correspond au nom de la police utilisée pour dessiner le test.A FontFamily that represents the name of the font with which the test is drawn.

style
Int32

Énumération FontStyle qui représente les informations sur le style du texte (gras, italique, etc.).A FontStyle enumeration that represents style information about the text (bold, italic, and so on). Elle doit être castée en un entier (consultez l'exemple de code figurant plus loin dans cette rubrique).This must be cast as an integer (see the example code later in this section).

emSize
Single

Hauteur du carré cadratin englobant le caractère.The height of the em square box that bounds the character.

layoutRect
RectangleF

RectangleF représentant le rectangle qui englobe le texte.A RectangleF that represents the rectangle that bounds the text.

format
StringFormat

StringFormat qui spécifie des informations sur la mise en forme du texte telles que l'espacement des lignes et l'alignement.A StringFormat that specifies text formatting information, such as line spacing and alignment.

Exemples

Pour obtenir un exemple, consultez AddString(String, FontFamily, Int32, Single, Point, StringFormat).For an example, see AddString(String, FontFamily, Int32, Single, Point, StringFormat).

S’applique à

AddString(String, FontFamily, Int32, Single, Rectangle, StringFormat)

Ajoute une chaîne de texte à ce tracé.Adds a text string to this path.

public:
 void AddString(System::String ^ s, System::Drawing::FontFamily ^ family, int style, float emSize, System::Drawing::Rectangle layoutRect, System::Drawing::StringFormat ^ format);
public void AddString (string s, System.Drawing.FontFamily family, int style, float emSize, System.Drawing.Rectangle layoutRect, System.Drawing.StringFormat format);
public void AddString (string s, System.Drawing.FontFamily family, int style, float emSize, System.Drawing.Rectangle layoutRect, System.Drawing.StringFormat? format);
member this.AddString : string * System.Drawing.FontFamily * int * single * System.Drawing.Rectangle * System.Drawing.StringFormat -> unit
Public Sub AddString (s As String, family As FontFamily, style As Integer, emSize As Single, layoutRect As Rectangle, format As StringFormat)

Paramètres

s
String

String à ajouter.The String to add.

family
FontFamily

FontFamily qui correspond au nom de la police utilisée pour dessiner le test.A FontFamily that represents the name of the font with which the test is drawn.

style
Int32

Énumération FontStyle qui représente les informations sur le style du texte (gras, italique, etc.).A FontStyle enumeration that represents style information about the text (bold, italic, and so on). Elle doit être castée en un entier (consultez l'exemple de code figurant plus loin dans cette rubrique).This must be cast as an integer (see the example code later in this section).

emSize
Single

Hauteur du carré cadratin englobant le caractère.The height of the em square box that bounds the character.

layoutRect
Rectangle

Rectangle représentant le rectangle qui englobe le texte.A Rectangle that represents the rectangle that bounds the text.

format
StringFormat

StringFormat qui spécifie des informations sur la mise en forme du texte telles que l'espacement des lignes et l'alignement.A StringFormat that specifies text formatting information, such as line spacing and alignment.

Exemples

Pour obtenir un exemple, consultez AddString(String, FontFamily, Int32, Single, Point, StringFormat).For an example, see AddString(String, FontFamily, Int32, Single, Point, StringFormat).

S’applique à

AddString(String, FontFamily, Int32, Single, PointF, StringFormat)

Ajoute une chaîne de texte à ce tracé.Adds a text string to this path.

public:
 void AddString(System::String ^ s, System::Drawing::FontFamily ^ family, int style, float emSize, System::Drawing::PointF origin, System::Drawing::StringFormat ^ format);
public void AddString (string s, System.Drawing.FontFamily family, int style, float emSize, System.Drawing.PointF origin, System.Drawing.StringFormat format);
public void AddString (string s, System.Drawing.FontFamily family, int style, float emSize, System.Drawing.PointF origin, System.Drawing.StringFormat? format);
member this.AddString : string * System.Drawing.FontFamily * int * single * System.Drawing.PointF * System.Drawing.StringFormat -> unit
Public Sub AddString (s As String, family As FontFamily, style As Integer, emSize As Single, origin As PointF, format As StringFormat)

Paramètres

s
String

String à ajouter.The String to add.

family
FontFamily

FontFamily qui correspond au nom de la police utilisée pour dessiner le test.A FontFamily that represents the name of the font with which the test is drawn.

style
Int32

Énumération FontStyle qui représente les informations sur le style du texte (gras, italique, etc.).A FontStyle enumeration that represents style information about the text (bold, italic, and so on). Elle doit être castée en un entier (consultez l'exemple de code figurant plus loin dans cette rubrique).This must be cast as an integer (see the example code later in this section).

emSize
Single

Hauteur du carré cadratin englobant le caractère.The height of the em square box that bounds the character.

origin
PointF

PointF représentant le point où le texte commence.A PointF that represents the point where the text starts.

format
StringFormat

StringFormat qui spécifie des informations sur la mise en forme du texte telles que l'espacement des lignes et l'alignement.A StringFormat that specifies text formatting information, such as line spacing and alignment.

Exemples

Pour obtenir un exemple, consultez AddString(String, FontFamily, Int32, Single, Point, StringFormat).For an example, see AddString(String, FontFamily, Int32, Single, Point, StringFormat).

S’applique à

AddString(String, FontFamily, Int32, Single, Point, StringFormat)

Ajoute une chaîne de texte à ce tracé.Adds a text string to this path.

public:
 void AddString(System::String ^ s, System::Drawing::FontFamily ^ family, int style, float emSize, System::Drawing::Point origin, System::Drawing::StringFormat ^ format);
public void AddString (string s, System.Drawing.FontFamily family, int style, float emSize, System.Drawing.Point origin, System.Drawing.StringFormat format);
public void AddString (string s, System.Drawing.FontFamily family, int style, float emSize, System.Drawing.Point origin, System.Drawing.StringFormat? format);
member this.AddString : string * System.Drawing.FontFamily * int * single * System.Drawing.Point * System.Drawing.StringFormat -> unit
Public Sub AddString (s As String, family As FontFamily, style As Integer, emSize As Single, origin As Point, format As StringFormat)

Paramètres

s
String

String à ajouter.The String to add.

family
FontFamily

FontFamily qui correspond au nom de la police utilisée pour dessiner le test.A FontFamily that represents the name of the font with which the test is drawn.

style
Int32

Énumération FontStyle qui représente les informations sur le style du texte (gras, italique, etc.).A FontStyle enumeration that represents style information about the text (bold, italic, and so on). Elle doit être castée en un entier (consultez l'exemple de code figurant plus loin dans cette rubrique).This must be cast as an integer (see the example code later in this section).

emSize
Single

Hauteur du carré cadratin englobant le caractère.The height of the em square box that bounds the character.

origin
Point

Point représentant le point où le texte commence.A Point that represents the point where the text starts.

format
StringFormat

StringFormat qui spécifie des informations sur la mise en forme du texte telles que l'espacement des lignes et l'alignement.A StringFormat that specifies text formatting information, such as line spacing and alignment.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms, et il requiert PaintEventArgs e un OnPaint objet d’événement.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, an OnPaint event object. Le code effectue les actions suivantes :The code performs the following actions:

  • Crée un chemin d’accès.Creates a path.

  • Définit des arguments de chaîne et de police.Sets up string and font arguments.

  • Ajoute la chaîne au chemin d’accès.Adds the string to the path.

  • Dessine la chaîne à l’écran.Draws the string to the screen.

Il y a deux choses importantes à faire pointer. Tout d’abord, Notez que l' fontStyle argument est converti en un entier.There are two important things to be pointed out. First, notice that the fontStyle argument is cast as an integer. La AddString méthode requiert cela afin que deux membres ou plus FontStyle puissent être combinés pour créer le style de police souhaité (dans ce cas, Italic et Underline ).The AddString method requires this so that two or more FontStyle members can be combined to create the desired font style (in this case, Italic and Underline). Deuxièmement, Notez que la FillPath méthode est utilisée à la place de la DrawPath méthode.Secondly, notice that the FillPath method is used rather than the DrawPath method. Si FillPath est utilisé, le texte plein est affiché, tandis que si DrawPath est utilisé, le texte est un style de contour.If FillPath is used, solid text is rendered, whereas if DrawPath is used, the text will be an outline style.

private:
   void AddStringExample( PaintEventArgs^ e )
   {
      // Create a GraphicsPath object.
      GraphicsPath^ myPath = gcnew GraphicsPath;

      // Set up all the string parameters.
      String^ stringText = "Sample Text";
      FontFamily^ family = gcnew FontFamily( "Arial" );
      int fontStyle = (int)FontStyle::Italic;
      int emSize = 26;
      Point origin = Point(20,20);
      StringFormat^ format = StringFormat::GenericDefault;

      // Add the string to the path.
      myPath->AddString( stringText, family, fontStyle, (float)emSize, origin, format );

      //Draw the path to the screen.
      e->Graphics->FillPath( Brushes::Black, myPath );
   }
private void AddStringExample(PaintEventArgs e)
{
             
    // Create a GraphicsPath object.
    GraphicsPath myPath = new GraphicsPath();
             
    // Set up all the string parameters.
    string stringText = "Sample Text";
    FontFamily family = new FontFamily("Arial");
    int fontStyle = (int)FontStyle.Italic;
    int emSize = 26;
    Point origin = new Point(20, 20);
    StringFormat format = StringFormat.GenericDefault;
             
    // Add the string to the path.
    myPath.AddString(stringText,
        family,
        fontStyle,
        emSize,
        origin,
        format);
             
    //Draw the path to the screen.
    e.Graphics.FillPath(Brushes.Black, myPath);
}
Public Sub AddStringExample(ByVal e As PaintEventArgs)

    ' Create a GraphicsPath object.
    Dim myPath As New GraphicsPath

    ' Set up all the string parameters.
    Dim stringText As String = "Sample Text"
    Dim family As New FontFamily("Arial")
    Dim myfontStyle As Integer = CInt(FontStyle.Italic)
    Dim emSize As Integer = 26
    Dim origin As New Point(20, 20)
    Dim format As StringFormat = StringFormat.GenericDefault

    ' Add the string to the path.
    myPath.AddString(stringText, family, myfontStyle, emSize, _
    origin, format)

    'Draw the path to the screen.
    e.Graphics.FillPath(Brushes.Black, myPath)
End Sub

S’applique à