GraphicsPath.AddString Metoda

Definicja

Przestrzeń nazw:

System.Drawing.Drawing2D

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v9.0.0-preview.5.24306.5

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

String do dodania.

family

FontFamily

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

style

Int32

Wyliczenie FontStyle 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 em, który jest powiązany z znakiem.

origin

Point

Point, który reprezentuje punkt, w którym rozpoczyna się tekst.

format

StringFormat

StringFormat, który określa 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życia z formularzami Systemu Windows i wymaga PaintEventArgse, obiektu zdarzenia OnPaint. Kod wykonuje następujące akcje:

• Tworzy ścieżkę.

• Konfiguruje argumenty ciągu i czcionki.

• Dodaje ciąg do ścieżki.

• Rysuje ciąg na ekranie.

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

String do dodania.

family

FontFamily

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

style

Int32

Wyliczenie FontStyle 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 em, który jest powiązany z znakiem.

origin

PointF

PointF, który reprezentuje punkt, w którym rozpoczyna się tekst.

format

StringFormat

StringFormat, który określa 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

String do dodania.

family

FontFamily

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

style

Int32

Wyliczenie FontStyle 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 em, który jest powiązany z znakiem.

layoutRect

Rectangle

Rectangle, który reprezentuje prostokąt powiązany z tekstem.

format

StringFormat

StringFormat, który określa 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

String do dodania.

family

FontFamily

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

style

Int32

Wyliczenie FontStyle 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 em, który jest powiązany z znakiem.

layoutRect

RectangleF

RectangleF, który reprezentuje prostokąt powiązany z tekstem.

format

StringFormat

StringFormat, który określa 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).