GraphicsPath.AddString Metoda

Definicja

Przestrzeń nazw:

System.Drawing.Drawing2D

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Dodaje ciąg tekstowy do tej ścieżki.

Przeciążenia

AddString(String, FontFamily, Int32, Single, Point, StringFormat)	Dodaje ciąg tekstowy do tej ścieżki.
AddString(String, FontFamily, Int32, Single, PointF, StringFormat)	Dodaje ciąg tekstowy do tej ścieżki.
AddString(String, FontFamily, Int32, Single, Rectangle, StringFormat)	Dodaje ciąg tekstowy do tej ścieżki.
AddString(String, FontFamily, Int32, Single, RectangleF, StringFormat)	Dodaje ciąg tekstowy do tej ścieżki.

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

Źródło:

GraphicsPath.cs

Dodaje ciąg tekstowy do tej ścieżki.

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);

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

Element do dodania String .

family

FontFamily

Element FontFamily reprezentujący nazwę czcionki, z którą jest rysowany test.

style

Int32

FontStyle Wyliczenie reprezentujące informacje o stylu tekstu (pogrubienie, kursywa itd.). Musi to być rzutowanie jako liczba całkowita (zobacz przykładowy kod w dalszej części tej sekcji).

emSize

Single

Wysokość pola kwadratowego, który wiąże znak.

origin

Point

Element Point reprezentujący punkt, w którym rozpoczyna się tekst.

format

StringFormat

Element StringFormat określający informacje o formatowaniu tekstu, takie jak odstępy między wierszami i wyrównanie.

Przykłady

Poniższy przykład kodu jest przeznaczony do użytku z Windows Forms i wymaga PaintEventArgseobiektu OnPaint zdarzenia . Kod wykonuje następujące akcje:

• Tworzy ścieżkę.

• Konfiguruje ciąg i argumenty czcionek.

• Dodaje ciąg do ścieżki.

• Rysuje ciąg do ekranu.

Należy zwrócić uwagę na dwie ważne kwestie. Najpierw zwróć uwagę, że fontStyle argument jest rzutowy jako liczba całkowita. Metoda AddString wymaga tego, aby można było połączyć co najmniej dwa FontStyle elementy członkowskie w celu utworzenia żądanego stylu czcionki (w tym przypadku Italic i Underline). Po drugie należy zauważyć, że FillPath metoda jest używana, a nie DrawPath metoda. Jeśli FillPath jest używany, tekst stały jest renderowany, a jeśli DrawPath jest używany, tekst będzie stylem konspektu.

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

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

Źródło:

GraphicsPath.cs

Dodaje ciąg tekstowy do tej ścieżki.

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);

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

Element do dodania String .

family

FontFamily

Element FontFamily reprezentujący nazwę czcionki, z którą jest rysowany test.

style

Int32

FontStyle Wyliczenie reprezentujące informacje o stylu tekstu (pogrubienie, kursywa itd.). Musi to być rzutowanie jako liczba całkowita (zobacz przykładowy kod w dalszej części tej sekcji).

emSize

Single

Wysokość pola kwadratowego, który wiąże znak.

origin

PointF

Element PointF reprezentujący punkt, w którym rozpoczyna się tekst.

format

StringFormat

Element StringFormat określający informacje o formatowaniu tekstu, takie jak odstępy między wierszami i wyrównanie.

Przykłady

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

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

Źródło:

GraphicsPath.cs

Dodaje ciąg tekstowy do tej ścieżki.

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);

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

Element do dodania String .

family

FontFamily

Element FontFamily reprezentujący nazwę czcionki, z którą jest rysowany test.

style

Int32

FontStyle Wyliczenie reprezentujące informacje o stylu tekstu (pogrubienie, kursywa itd.). Musi to być rzutowanie jako liczba całkowita (zobacz przykładowy kod w dalszej części tej sekcji).

emSize

Single

Wysokość pola kwadratowego, który wiąże znak.

layoutRect

Rectangle

Obiekt Rectangle reprezentujący prostokąt, który jest powiązany z tekstem.

format

StringFormat

Element StringFormat określający informacje o formatowaniu tekstu, takie jak odstępy między wierszami i wyrównanie.

Przykłady

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

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

Źródło:

GraphicsPath.cs

Dodaje ciąg tekstowy do tej ścieżki.

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);

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

Element do dodania String .

family

FontFamily

Element FontFamily reprezentujący nazwę czcionki, z którą jest rysowany test.

style

Int32

FontStyle Wyliczenie reprezentujące informacje o stylu tekstu (pogrubienie, kursywa itd.). Musi to być rzutowanie jako liczba całkowita (zobacz przykładowy kod w dalszej części tej sekcji).

emSize

Single

Wysokość pola kwadratowego, który wiąże znak.

layoutRect

RectangleF

Obiekt RectangleF reprezentujący prostokąt, który jest powiązany z tekstem.

format

StringFormat

Element StringFormat określający informacje o formatowaniu tekstu, takie jak odstępy między wierszami i wyrównanie.

Przykłady

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