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

Добавляет строку текста в этот контур.

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

Высота рамки максимального пробела, ограничивающей символ.

origin
Point

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

format
StringFormat

Объект StringFormat, задающий информацию о форматировании текста, такую как интервал между строками и выравнивание.

Примеры

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

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

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

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

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

Есть две важные вещи, которые следует отметить. Во-первых fontStyle , обратите внимание, что аргумент приведен как целое число. Метод AddString требует этого, чтобы можно было объединить два или более FontStyle элементов для создания нужного стиля шрифта (в данном случае и ItalicUnderline). Во-вторых, обратите внимание, что 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

Добавляет строку текста в этот контур.

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

Высота рамки максимального пробела, ограничивающей символ.

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

Добавляет строку текста в этот контур.

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

Высота рамки максимального пробела, ограничивающей символ.

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

Добавляет строку текста в этот контур.

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

Высота рамки максимального пробела, ограничивающей символ.

layoutRect
RectangleF

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

format
StringFormat

Объект StringFormat, задающий информацию о форматировании текста, такую как интервал между строками и выравнивание.

Примеры

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

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