GraphicsPath.AddString Metoda

Definicja

Dodaje ciąg tekstowy do tej ścieżki.Adds a text string to this path.

Przeciążenia

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

Dodaje ciąg tekstowy do tej ścieżki.Adds a text string to this path.

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

Dodaje ciąg tekstowy do tej ścieżki.Adds a text string to this path.

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

Dodaje ciąg tekstowy do tej ścieżki.Adds a text string to this path.

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

Dodaje ciąg tekstowy do tej ścieżki.Adds a text string to this path.

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

Dodaje ciąg tekstowy do tej ścieżki.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)

Parametry

s
String

StringDo dodania.The String to add.

family
FontFamily

FontFamilyReprezentuje nazwę czcionki, z którą jest rysowany test.A FontFamily that represents the name of the font with which the test is drawn.

style
Int32

FontStyleWyliczenie, które reprezentuje informacje o stylu tekstu (pogrubiony, kursywa itd.).A FontStyle enumeration that represents style information about the text (bold, italic, and so on). Ta wartość musi być rzutowana jako liczba całkowita (Zobacz przykładowy kod w dalszej części tej sekcji).This must be cast as an integer (see the example code later in this section).

emSize
Single

Wysokość kwadratowego pola, które wiąże się z znakiem.The height of the em square box that bounds the character.

layoutRect
RectangleF

RectangleFReprezentuje prostokąt, który jest powiązany z tekstem.A RectangleF that represents the rectangle that bounds the text.

format
StringFormat

A StringFormat , która określa informacje o formatowaniu tekstu, takie jak odstępy między wierszami i wyrównanie.A StringFormat that specifies text formatting information, such as line spacing and alignment.

Przykłady

Aby zapoznać się z przykładem, zobacz AddString(String, FontFamily, Int32, Single, Point, StringFormat) .For an example, see AddString(String, FontFamily, Int32, Single, Point, StringFormat).

Dotyczy

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

Dodaje ciąg tekstowy do tej ścieżki.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)

Parametry

s
String

StringDo dodania.The String to add.

family
FontFamily

FontFamilyReprezentuje nazwę czcionki, z którą jest rysowany test.A FontFamily that represents the name of the font with which the test is drawn.

style
Int32

FontStyleWyliczenie, które reprezentuje informacje o stylu tekstu (pogrubiony, kursywa itd.).A FontStyle enumeration that represents style information about the text (bold, italic, and so on). Ta wartość musi być rzutowana jako liczba całkowita (Zobacz przykładowy kod w dalszej części tej sekcji).This must be cast as an integer (see the example code later in this section).

emSize
Single

Wysokość kwadratowego pola, które wiąże się z znakiem.The height of the em square box that bounds the character.

layoutRect
Rectangle

RectangleReprezentuje prostokąt, który jest powiązany z tekstem.A Rectangle that represents the rectangle that bounds the text.

format
StringFormat

A StringFormat , która określa informacje o formatowaniu tekstu, takie jak odstępy między wierszami i wyrównanie.A StringFormat that specifies text formatting information, such as line spacing and alignment.

Przykłady

Aby zapoznać się z przykładem, zobacz AddString(String, FontFamily, Int32, Single, Point, StringFormat) .For an example, see AddString(String, FontFamily, Int32, Single, Point, StringFormat).

Dotyczy

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

Dodaje ciąg tekstowy do tej ścieżki.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)

Parametry

s
String

StringDo dodania.The String to add.

family
FontFamily

FontFamilyReprezentuje nazwę czcionki, z którą jest rysowany test.A FontFamily that represents the name of the font with which the test is drawn.

style
Int32

FontStyleWyliczenie, które reprezentuje informacje o stylu tekstu (pogrubiony, kursywa itd.).A FontStyle enumeration that represents style information about the text (bold, italic, and so on). Ta wartość musi być rzutowana jako liczba całkowita (Zobacz przykładowy kod w dalszej części tej sekcji).This must be cast as an integer (see the example code later in this section).

emSize
Single

Wysokość kwadratowego pola, które wiąże się z znakiem.The height of the em square box that bounds the character.

origin
PointF

PointFReprezentujący punkt, w którym zaczyna się tekst.A PointF that represents the point where the text starts.

format
StringFormat

A StringFormat , która określa informacje o formatowaniu tekstu, takie jak odstępy między wierszami i wyrównanie.A StringFormat that specifies text formatting information, such as line spacing and alignment.

Przykłady

Aby zapoznać się z przykładem, zobacz AddString(String, FontFamily, Int32, Single, Point, StringFormat) .For an example, see AddString(String, FontFamily, Int32, Single, Point, StringFormat).

Dotyczy

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

Dodaje ciąg tekstowy do tej ścieżki.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)

Parametry

s
String

StringDo dodania.The String to add.

family
FontFamily

FontFamilyReprezentuje nazwę czcionki, z którą jest rysowany test.A FontFamily that represents the name of the font with which the test is drawn.

style
Int32

FontStyleWyliczenie, które reprezentuje informacje o stylu tekstu (pogrubiony, kursywa itd.).A FontStyle enumeration that represents style information about the text (bold, italic, and so on). Ta wartość musi być rzutowana jako liczba całkowita (Zobacz przykładowy kod w dalszej części tej sekcji).This must be cast as an integer (see the example code later in this section).

emSize
Single

Wysokość kwadratowego pola, które wiąże się z znakiem.The height of the em square box that bounds the character.

origin
Point

PointReprezentujący punkt, w którym zaczyna się tekst.A Point that represents the point where the text starts.

format
StringFormat

A StringFormat , która określa informacje o formatowaniu tekstu, takie jak odstępy między wierszami i wyrównanie.A StringFormat that specifies text formatting information, such as line spacing and alignment.

Przykłady

Poniższy przykład kodu jest przeznaczony do użytku z Windows Forms i wymaga PaintEventArgs e OnPaint obiektu zdarzenia.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, an OnPaint event object. Kod wykonuje następujące czynności:The code performs the following actions:

  • Tworzy ścieżkę.Creates a path.

  • Ustawia ciąg i argumenty czcionki.Sets up string and font arguments.

  • Dodaje ciąg do ścieżki.Adds the string to the path.

  • Rysuje ciąg na ekranie.Draws the string to the screen.

Istnieją dwie ważne rzeczy, które należy wyróżnić. Najpierw Zwróć uwagę, że fontStyle argument jest rzutowany jako liczbę całkowitą.There are two important things to be pointed out. First, notice that the fontStyle argument is cast as an integer. AddStringTa metoda wymaga, aby co najmniej dwa FontStyle elementy członkowskie mogły być połączone w celu utworzenia żądanego stylu czcionki (w tym przypadku Italic i 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). Następnie należy zauważyć, że FillPath Metoda jest używana zamiast DrawPath metody.Secondly, notice that the FillPath method is used rather than the DrawPath method. Jeśli FillPath jest używany, pełny tekst jest renderowany, natomiast jeśli DrawPath jest używany, tekst będzie stylem konturu.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

Dotyczy