GraphicsPath.AddString Метод

Определение

Добавляет текстовую строку в этот путь.

Перегрузки

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

Добавляет текстовую строку в этот путь.

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

Добавляет текстовую строку в этот путь.

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

Добавляет текстовую строку в этот путь.

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

Добавляет текстовую строку в этот путь.

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

Исходный код:
GraphicsPath.cs
Исходный код:
GraphicsPath.cs
Исходный код:
GraphicsPath.cs
Исходный код:
GraphicsPath.cs
Исходный код:
GraphicsPath.cs

Добавляет текстовую строку в этот путь.

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)

Параметры

s
String

Добавлена String.

family
FontFamily

FontFamily, представляющий имя шрифта, с помощью которого выполняется тестирование.

style
Int32

Перечисление FontStyle, представляющее сведения о стиле текста (полужирный, курсив и т. д.). Это должно быть приведение в виде целого числа (см. пример кода далее в этом разделе).

emSize
Single

Высота квадратного поля em, ограничивающего символ.

origin
Point

Point, представляющий точку, в которой начинается текст.

format
StringFormat

StringFormat, указывающий сведения о форматировании текста, например интервалы строк и выравнивание.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgseобъекта события OnPaint. Код выполняет следующие действия:

  • Создает путь.

  • Настраивает аргументы строки и шрифта.

  • Добавляет строку в путь.

  • Рисует строку на экране.

Важно отметить две важные вещи. Сначала обратите внимание, что аргумент fontStyle представляется целым числом. Метод AddString требует этого, чтобы два или более FontStyle членов можно объединить для создания требуемого стиля шрифта (в данном случае Italic и Underline). Во-вторых, обратите внимание, что метод FillPath используется вместо метода DrawPath. Если используется FillPath, отрисовывается твердый текст, а если используется DrawPath, текст будет стилем структуры.

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)

Исходный код:
GraphicsPath.cs
Исходный код:
GraphicsPath.cs
Исходный код:
GraphicsPath.cs
Исходный код:
GraphicsPath.cs
Исходный код:
GraphicsPath.cs

Добавляет текстовую строку в этот путь.

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)

Параметры

s
String

Добавлена String.

family
FontFamily

FontFamily, представляющий имя шрифта, с помощью которого выполняется тестирование.

style
Int32

Перечисление FontStyle, представляющее сведения о стиле текста (полужирный, курсив и т. д.). Это должно быть приведение в виде целого числа (см. пример кода далее в этом разделе).

emSize
Single

Высота квадратного поля em, ограничивающего символ.

origin
PointF

PointF, представляющий точку, в которой начинается текст.

format
StringFormat

StringFormat, указывающий сведения о форматировании текста, например интервалы строк и выравнивание.

Примеры

Пример см. в разделе AddString(String, FontFamily, Int32, Single, Point, StringFormat).

Применяется к

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

Исходный код:
GraphicsPath.cs
Исходный код:
GraphicsPath.cs
Исходный код:
GraphicsPath.cs
Исходный код:
GraphicsPath.cs
Исходный код:
GraphicsPath.cs

Добавляет текстовую строку в этот путь.

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)

Параметры

s
String

Добавлена String.

family
FontFamily

FontFamily, представляющий имя шрифта, с помощью которого выполняется тестирование.

style
Int32

Перечисление FontStyle, представляющее сведения о стиле текста (полужирный, курсив и т. д.). Это должно быть приведение в виде целого числа (см. пример кода далее в этом разделе).

emSize
Single

Высота квадратного поля em, ограничивающего символ.

layoutRect
Rectangle

Rectangle, представляющий прямоугольник, ограничивающий текст.

format
StringFormat

StringFormat, указывающий сведения о форматировании текста, например интервалы строк и выравнивание.

Примеры

Пример см. в разделе AddString(String, FontFamily, Int32, Single, Point, StringFormat).

Применяется к

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

Исходный код:
GraphicsPath.cs
Исходный код:
GraphicsPath.cs
Исходный код:
GraphicsPath.cs
Исходный код:
GraphicsPath.cs
Исходный код:
GraphicsPath.cs

Добавляет текстовую строку в этот путь.

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)

Параметры

s
String

Добавлена String.

family
FontFamily

FontFamily, представляющий имя шрифта, с помощью которого выполняется тестирование.

style
Int32

Перечисление FontStyle, представляющее сведения о стиле текста (полужирный, курсив и т. д.). Это должно быть приведение в виде целого числа (см. пример кода далее в этом разделе).

emSize
Single

Высота квадратного поля em, ограничивающего символ.

layoutRect
RectangleF

RectangleF, представляющий прямоугольник, ограничивающий текст.

format
StringFormat

StringFormat, указывающий сведения о форматировании текста, например интервалы строк и выравнивание.

Примеры

Пример см. в разделе AddString(String, FontFamily, Int32, Single, Point, StringFormat).

Применяется к