GraphicsPath.AddString Método

Definición

Espacio de nombres:

System.Drawing.Drawing2D

Ensamblado:

System.Drawing.Common.dll

Paquete:

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

Agrega una cadena de texto a esta ruta de acceso.

Sobrecargas

AddString(String, FontFamily, Int32, Single, Point, StringFormat)	Agrega una cadena de texto a esta ruta de acceso.
AddString(String, FontFamily, Int32, Single, PointF, StringFormat)	Agrega una cadena de texto a esta ruta de acceso.
AddString(String, FontFamily, Int32, Single, Rectangle, StringFormat)	Agrega una cadena de texto a esta ruta de acceso.
AddString(String, FontFamily, Int32, Single, RectangleF, StringFormat)	Agrega una cadena de texto a esta ruta de acceso.

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

Source:

GraphicsPath.cs

Agrega una cadena de texto a esta ruta de acceso.

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)

Parámetros

s

String

El String que se va a agregar.

family

FontFamily

Un FontFamily que representa el nombre de la fuente con la que se dibuja la prueba.

style

Int32

Enumeración FontStyle que representa información de estilo sobre el texto (negrita, cursiva, etc.). Debe convertirse como un entero (vea el código de ejemplo más adelante en esta sección).

emSize

Single

Alto del cuadro em cuadrado que enlaza el carácter.

origin

Point

Un Point que representa el punto donde se inicia el texto.

format

StringFormat

Un StringFormat que especifica información de formato de texto, como el espaciado de líneas y la alineación.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, un objeto de evento OnPaint. El código realiza las siguientes acciones:

• Crea una ruta de acceso.

• Configura argumentos de cadena y fuente.

• Agrega la cadena a la ruta de acceso.

• Dibuja la cadena en la pantalla.

Hay dos cosas importantes que se deben señalar. En primer lugar, observe que el argumento fontStyle se convierte como un entero. El método AddString requiere esto para que se puedan combinar dos o más miembros FontStyle para crear el estilo de fuente deseado (en este caso, Italic y Underline). En segundo lugar, observe que el método FillPath se usa en lugar del método DrawPath. Si se usa FillPath, se representa texto sólido, mientras que si se usa DrawPath, el texto será un estilo de esquema.

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)

Source:

GraphicsPath.cs

Agrega una cadena de texto a esta ruta de acceso.

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)

Parámetros

s

String

El String que se va a agregar.

family

FontFamily

Un FontFamily que representa el nombre de la fuente con la que se dibuja la prueba.

style

Int32

Enumeración FontStyle que representa información de estilo sobre el texto (negrita, cursiva, etc.). Debe convertirse como un entero (vea el código de ejemplo más adelante en esta sección).

emSize

Single

Alto del cuadro em cuadrado que enlaza el carácter.

origin

PointF

Un PointF que representa el punto donde se inicia el texto.

format

StringFormat

Un StringFormat que especifica información de formato de texto, como el espaciado de líneas y la alineación.

Ejemplos

Para obtener un ejemplo, vea AddString(String, FontFamily, Int32, Single, Point, StringFormat).

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

Source:

GraphicsPath.cs

Agrega una cadena de texto a esta ruta de acceso.

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)

Parámetros

s

String

El String que se va a agregar.

family

FontFamily

Un FontFamily que representa el nombre de la fuente con la que se dibuja la prueba.

style

Int32

Enumeración FontStyle que representa información de estilo sobre el texto (negrita, cursiva, etc.). Debe convertirse como un entero (vea el código de ejemplo más adelante en esta sección).

emSize

Single

Alto del cuadro em cuadrado que enlaza el carácter.

layoutRect

Rectangle

Un Rectangle que representa el rectángulo que enlaza el texto.

format

StringFormat

Un StringFormat que especifica información de formato de texto, como el espaciado de líneas y la alineación.

Ejemplos

Para obtener un ejemplo, vea AddString(String, FontFamily, Int32, Single, Point, StringFormat).

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

Source:

GraphicsPath.cs

Agrega una cadena de texto a esta ruta de acceso.

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)

Parámetros

s

String

El String que se va a agregar.

family

FontFamily

Un FontFamily que representa el nombre de la fuente con la que se dibuja la prueba.

style

Int32

Enumeración FontStyle que representa información de estilo sobre el texto (negrita, cursiva, etc.). Debe convertirse como un entero (vea el código de ejemplo más adelante en esta sección).

emSize

Single

Alto del cuadro em cuadrado que enlaza el carácter.

layoutRect

RectangleF

Un RectangleF que representa el rectángulo que enlaza el texto.

format

StringFormat

Un StringFormat que especifica información de formato de texto, como el espaciado de líneas y la alineación.

Ejemplos

Para obtener un ejemplo, vea AddString(String, FontFamily, Int32, Single, Point, StringFormat).