GraphicsPath.AddString Método

Definição

Espaço de Nomes:: System.Drawing.Drawing2D

Assemblagem:: System.Drawing.Common.dll

Assemblagem:: System.Drawing.dll

Pacote:: System.Drawing.Common v11.0.0-preview.4.26230.115

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Adiciona uma cadeia de texto a este caminho.

Sobrecargas

Name	Description
AddString(String, FontFamily, Int32, Single, Point, StringFormat)	Adiciona uma cadeia de texto a este caminho.
AddString(String, FontFamily, Int32, Single, PointF, StringFormat)	Adiciona uma cadeia de texto a este caminho.
AddString(String, FontFamily, Int32, Single, Rectangle, StringFormat)	Adiciona uma cadeia de texto a este caminho.
AddString(String, FontFamily, Int32, Single, RectangleF, StringFormat)	Adiciona uma cadeia de texto a este caminho.

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

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Adiciona uma cadeia de texto a este caminho.

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)

Parâmetros

s: String

O String a acrescentar.

family: FontFamily

A FontFamily que representa o nome da fonte com que o teste é desenhado.

style: Int32

Uma FontStyle enumeração que representa informação de estilo sobre o texto (negrito, itálico, etc.). Isto deve ser lançado como um inteiro (ver o código de exemplo mais adiante nesta secção).

emSize: Single

A altura da caixa em quadrado que limita o carácter.

origin: Point

A Point que representa o ponto onde o texto começa.

format: StringFormat

A StringFormat que especifica informação de formatação de texto, como espaçamento entre linhas e alinhamento.

Exemplos

O seguinte exemplo de código foi concebido para uso com Windows Forms e requer PaintEventArgse, um objeto de evento OnPaint. O código executa as seguintes ações:

Cria um caminho.
Configura argumentos de cadeia e fonte.
Adiciona a corda ao caminho.
Puxa o fio até ao ecrã.

Há duas coisas importantes a destacar. Primeiro, repare que o argumento fontStyle é apresentado como um inteiro. O AddString método requer isto para que dois ou mais FontStyle membros possam ser combinados para criar o estilo de fonte desejado (neste caso, Italic e Underline). Em segundo lugar, repare que o FillPath método é usado em vez do próprio DrawPath método. Se FillPath for usado, o texto sólido é renderizado, enquanto se DrawPath for usado, o texto terá um estilo de contorno.

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

Aplica-se a

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

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Adiciona uma cadeia de texto a este caminho.

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)

Parâmetros

s: String

O String a acrescentar.

family: FontFamily

A FontFamily que representa o nome da fonte com que o teste é desenhado.

style: Int32

emSize: Single

A altura da caixa em quadrado que limita o carácter.

origin: PointF

A PointF que representa o ponto onde o texto começa.

format: StringFormat

A StringFormat que especifica informação de formatação de texto, como espaçamento entre linhas e alinhamento.

Exemplos

Para obter um exemplo, consulte AddString(String, FontFamily, Int32, Single, Point, StringFormat).

Aplica-se a

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

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Adiciona uma cadeia de texto a este caminho.

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)

Parâmetros

s: String

O String a acrescentar.

family: FontFamily

A FontFamily que representa o nome da fonte com que o teste é desenhado.

style: Int32

emSize: Single

A altura da caixa em quadrado que limita o carácter.

layoutRect: Rectangle

A Rectangle que representa o retângulo que delimita o texto.

format: StringFormat

A StringFormat que especifica informação de formatação de texto, como espaçamento entre linhas e alinhamento.

Exemplos

Para obter um exemplo, consulte AddString(String, FontFamily, Int32, Single, Point, StringFormat).

Aplica-se a

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

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Origem:: GraphicsPath.cs

Adiciona uma cadeia de texto a este caminho.

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)

Parâmetros

s: String

O String a acrescentar.

family: FontFamily

A FontFamily que representa o nome da fonte com que o teste é desenhado.

style: Int32

emSize: Single

A altura da caixa em quadrado que limita o carácter.

layoutRect: RectangleF

A RectangleF que representa o retângulo que delimita o texto.

format: StringFormat

A StringFormat que especifica informação de formatação de texto, como espaçamento entre linhas e alinhamento.

Exemplos

Para obter um exemplo, consulte AddString(String, FontFamily, Int32, Single, Point, StringFormat).

Aplica-se a

Comentários

Esta página foi útil?