StringFormat Construtores

Referência

Definição

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Pacote:: System.Drawing.Common v6.0.0

Pacote:: System.Drawing.Common v7.0.0

Pacote:: System.Drawing.Common v8.0.0

Pacote:: System.Drawing.Common v9.0.0-preview.2.24128.3

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Inicializa um novo objeto StringFormat.

Sobrecargas

StringFormat()	Inicializa um novo objeto StringFormat.
StringFormat(StringFormat)	Inicializa um novo objeto StringFormat do objeto StringFormat existente especificado.
StringFormat(StringFormatFlags)	Inicializa um novo objeto StringFormat com a enumeração StringFormatFlags especificada.
StringFormat(StringFormatFlags, Int32)	Inicializa um novo objeto StringFormat com a enumeração StringFormatFlags e o idioma especificados.

StringFormat()

Origem:: StringFormat.cs

Origem:: StringFormat.cs

Origem:: StringFormat.cs

Inicializa um novo objeto StringFormat.

public:
 StringFormat();

public StringFormat ();

Public Sub New ()

Comentários

A tabela a seguir mostra valores de propriedade iniciais para uma instância da StringFormat classe .

Propriedade	Valor inicial
Formatflags	0 (nenhum sinalizador está definido)
HotkeyPrefix	None

Aplica-se a

StringFormat(StringFormat)

Origem:: StringFormat.cs

Origem:: StringFormat.cs

Origem:: StringFormat.cs

Inicializa um novo objeto StringFormat do objeto StringFormat existente especificado.

public:
 StringFormat(System::Drawing::StringFormat ^ format);

public StringFormat (System.Drawing.StringFormat format);

new System.Drawing.StringFormat : System.Drawing.StringFormat -> System.Drawing.StringFormat

Public Sub New (format As StringFormat)

Parâmetros

format: StringFormat

O objeto StringFormat do qual inicializar o novo objeto StringFormat.

Exceções

ArgumentNullException

format é null.

Exemplos

O exemplo de código a seguir demonstra os seguintes membros:

Este exemplo foi projetado para ser usado com Windows Forms. Cole o código em um formulário e chame o ShowLineAndAlignment método ao manipular o evento do Paint formulário, passando e como PaintEventArgs.

private:
   void ShowLineAndAlignment( PaintEventArgs^ e )
   {
      // Construct a new Rectangle .
      Rectangle displayRectangle = Rectangle(Point(40,40),System::Drawing::Size( 80, 80 ));
      
      // Construct 2 new StringFormat objects
      StringFormat^ format1 = gcnew StringFormat( StringFormatFlags::NoClip );
      StringFormat^ format2 = gcnew StringFormat( format1 );
      
      // Set the LineAlignment and Alignment properties for
      // both StringFormat objects to different values.
      format1->LineAlignment = StringAlignment::Near;
      format1->Alignment = StringAlignment::Center;
      format2->LineAlignment = StringAlignment::Center;
      format2->Alignment = StringAlignment::Far;
      
      // Draw the bounding rectangle and a string for each
      // StringFormat object.
      e->Graphics->DrawRectangle( Pens::Black, displayRectangle );
      e->Graphics->DrawString( "Showing Format1", this->Font, Brushes::Red, displayRectangle, format1 );
      e->Graphics->DrawString( "Showing Format2", this->Font, Brushes::Red, displayRectangle, format2 );
   }

private void ShowLineAndAlignment(PaintEventArgs e)
{

    // Construct a new Rectangle .
    Rectangle  displayRectangle = 
        new Rectangle (new Point(40, 40), new Size (80, 80));

    // Construct 2 new StringFormat objects
    StringFormat format1 = new StringFormat(StringFormatFlags.NoClip);
    StringFormat format2 = new StringFormat(format1);

    // Set the LineAlignment and Alignment properties for
    // both StringFormat objects to different values.
    format1.LineAlignment = StringAlignment.Near;
    format1.Alignment = StringAlignment.Center;
    format2.LineAlignment = StringAlignment.Center;
    format2.Alignment = StringAlignment.Far;

    // Draw the bounding rectangle and a string for each
    // StringFormat object.
    e.Graphics.DrawRectangle(Pens.Black, displayRectangle);
    e.Graphics.DrawString("Showing Format1", this.Font, 
        Brushes.Red, (RectangleF)displayRectangle, format1);
    e.Graphics.DrawString("Showing Format2", this.Font, 
        Brushes.Red, (RectangleF)displayRectangle, format2);
}

Private Sub ShowLineAndAlignment(ByVal e As PaintEventArgs)

    ' Construct a new Rectangle.
    Dim displayRectangle _
        As New Rectangle(New Point(40, 40), New Size(80, 80))

    ' Construct two new StringFormat objects
    Dim format1 As New StringFormat(StringFormatFlags.NoClip)
    Dim format2 As New StringFormat(format1)

    ' Set the LineAlignment and Alignment properties for
    ' both StringFormat objects to different values.
    format1.LineAlignment = StringAlignment.Near
    format1.Alignment = StringAlignment.Center
    format2.LineAlignment = StringAlignment.Center
    format2.Alignment = StringAlignment.Far

    ' Draw the bounding rectangle and a string for each
    ' StringFormat object.
    e.Graphics.DrawRectangle(Pens.Black, displayRectangle)
    e.Graphics.DrawString("Showing Format1", Me.Font, Brushes.Red, _
        RectangleF.op_Implicit(displayRectangle), format1)
    e.Graphics.DrawString("Showing Format2", Me.Font, Brushes.Red, _
        RectangleF.op_Implicit(displayRectangle), format2)
End Sub

Aplica-se a

StringFormat(StringFormatFlags)

Origem:: StringFormat.cs

Origem:: StringFormat.cs

Origem:: StringFormat.cs

Inicializa um novo objeto StringFormat com a enumeração StringFormatFlags especificada.

public:
 StringFormat(System::Drawing::StringFormatFlags options);

public StringFormat (System.Drawing.StringFormatFlags options);

new System.Drawing.StringFormat : System.Drawing.StringFormatFlags -> System.Drawing.StringFormat

Public Sub New (options As StringFormatFlags)

Parâmetros

options: StringFormatFlags

A enumeração StringFormatFlags do novo objeto StringFormat.

Exemplos

O exemplo de código a seguir demonstra os seguintes membros:

private:
   void ShowLineAndAlignment( PaintEventArgs^ e )
   {
      // Construct a new Rectangle .
      Rectangle displayRectangle = Rectangle(Point(40,40),System::Drawing::Size( 80, 80 ));
      
      // Construct 2 new StringFormat objects
      StringFormat^ format1 = gcnew StringFormat( StringFormatFlags::NoClip );
      StringFormat^ format2 = gcnew StringFormat( format1 );
      
      // Set the LineAlignment and Alignment properties for
      // both StringFormat objects to different values.
      format1->LineAlignment = StringAlignment::Near;
      format1->Alignment = StringAlignment::Center;
      format2->LineAlignment = StringAlignment::Center;
      format2->Alignment = StringAlignment::Far;
      
      // Draw the bounding rectangle and a string for each
      // StringFormat object.
      e->Graphics->DrawRectangle( Pens::Black, displayRectangle );
      e->Graphics->DrawString( "Showing Format1", this->Font, Brushes::Red, displayRectangle, format1 );
      e->Graphics->DrawString( "Showing Format2", this->Font, Brushes::Red, displayRectangle, format2 );
   }

private void ShowLineAndAlignment(PaintEventArgs e)
{

    // Construct a new Rectangle .
    Rectangle  displayRectangle = 
        new Rectangle (new Point(40, 40), new Size (80, 80));

    // Construct 2 new StringFormat objects
    StringFormat format1 = new StringFormat(StringFormatFlags.NoClip);
    StringFormat format2 = new StringFormat(format1);

    // Set the LineAlignment and Alignment properties for
    // both StringFormat objects to different values.
    format1.LineAlignment = StringAlignment.Near;
    format1.Alignment = StringAlignment.Center;
    format2.LineAlignment = StringAlignment.Center;
    format2.Alignment = StringAlignment.Far;

    // Draw the bounding rectangle and a string for each
    // StringFormat object.
    e.Graphics.DrawRectangle(Pens.Black, displayRectangle);
    e.Graphics.DrawString("Showing Format1", this.Font, 
        Brushes.Red, (RectangleF)displayRectangle, format1);
    e.Graphics.DrawString("Showing Format2", this.Font, 
        Brushes.Red, (RectangleF)displayRectangle, format2);
}

Private Sub ShowLineAndAlignment(ByVal e As PaintEventArgs)

    ' Construct a new Rectangle.
    Dim displayRectangle _
        As New Rectangle(New Point(40, 40), New Size(80, 80))

    ' Construct two new StringFormat objects
    Dim format1 As New StringFormat(StringFormatFlags.NoClip)
    Dim format2 As New StringFormat(format1)

    ' Set the LineAlignment and Alignment properties for
    ' both StringFormat objects to different values.
    format1.LineAlignment = StringAlignment.Near
    format1.Alignment = StringAlignment.Center
    format2.LineAlignment = StringAlignment.Center
    format2.Alignment = StringAlignment.Far

    ' Draw the bounding rectangle and a string for each
    ' StringFormat object.
    e.Graphics.DrawRectangle(Pens.Black, displayRectangle)
    e.Graphics.DrawString("Showing Format1", Me.Font, Brushes.Red, _
        RectangleF.op_Implicit(displayRectangle), format1)
    e.Graphics.DrawString("Showing Format2", Me.Font, Brushes.Red, _
        RectangleF.op_Implicit(displayRectangle), format2)
End Sub

Aplica-se a

StringFormat(StringFormatFlags, Int32)

Origem:: StringFormat.cs

Origem:: StringFormat.cs

Origem:: StringFormat.cs

Inicializa um novo objeto StringFormat com a enumeração StringFormatFlags e o idioma especificados.

public:
 StringFormat(System::Drawing::StringFormatFlags options, int language);

public StringFormat (System.Drawing.StringFormatFlags options, int language);

new System.Drawing.StringFormat : System.Drawing.StringFormatFlags * int -> System.Drawing.StringFormat

Public Sub New (options As StringFormatFlags, language As Integer)

Parâmetros

options: StringFormatFlags

A enumeração StringFormatFlags do novo objeto StringFormat.

language: Int32

Um valor que indica o idioma do texto.

Aplica-se a

StringFormat Construtores

Definição

Sobrecargas

StringFormat()

Comentários

Aplica-se a

StringFormat(StringFormat)

Parâmetros

Exceções

Exemplos

Aplica-se a

StringFormat(StringFormatFlags)

Parâmetros

Exemplos

Aplica-se a

StringFormat(StringFormatFlags, Int32)

Parâmetros

Aplica-se a

Comentários

Recursos adicionais