StringFormat Konstruktory

Definicja

Przestrzeń nazw:

System.Drawing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Inicjuje nowy StringFormat obiekt.

Przeciążenia

StringFormat()	Inicjuje nowy StringFormat obiekt.
StringFormat(StringFormat)	Inicjuje nowy StringFormat obiekt z określonego istniejącego StringFormat obiektu.
StringFormat(StringFormatFlags)	Inicjuje nowy StringFormat obiekt przy użyciu określonego StringFormatFlags wyliczenia.
StringFormat(StringFormatFlags, Int32)	Inicjuje nowy StringFormat obiekt przy użyciu określonego StringFormatFlags wyliczenia i języka.

StringFormat()

Źródło:

StringFormat.cs

Inicjuje nowy StringFormat obiekt.

public:
 StringFormat();

public StringFormat ();

Public Sub New ()

Uwagi

W poniższej tabeli przedstawiono początkowe wartości właściwości dla wystąpienia StringFormat klasy.

Właściwość	Wartość początkowa
FormatFlags	0 (nie ustawiono żadnych flag)
HotkeyPrefix	None

StringFormat(StringFormat)

Źródło:

StringFormat.cs

Inicjuje nowy StringFormat obiekt z określonego istniejącego StringFormat obiektu.

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)

Parametry

format

StringFormat

Obiekt StringFormat , z którego ma inicjować nowy StringFormat obiekt.

Wyjątki

ArgumentNullException

format to null.

Przykłady

Poniższy przykład kodu przedstawia następujące elementy członkowskie:

• Rectangle

• StringFormat

• StringFormat

• Alignment

• LineAlignment

• StringAlignment

• StringFormatFlags

Ten przykład jest przeznaczony do użycia z Windows Forms. Wklej kod do formularza i wywołaj ShowLineAndAlignment metodę podczas obsługi zdarzenia formularza Paint , przekazując e go jako 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

StringFormat(StringFormatFlags)

Źródło:

StringFormat.cs

Inicjuje nowy StringFormat obiekt przy użyciu określonego StringFormatFlags wyliczenia.

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)

Parametry

options

StringFormatFlags

Wyliczenie StringFormatFlags dla nowego StringFormat obiektu.

Przykłady

Poniższy przykład kodu przedstawia następujące elementy członkowskie:

• Rectangle

• StringFormat

• StringFormat

• Alignment

• LineAlignment

• StringAlignment

• StringFormatFlags

Ten przykład jest przeznaczony do użycia z Windows Forms. Wklej kod do formularza i wywołaj ShowLineAndAlignment metodę podczas obsługi zdarzenia formularza Paint , przekazując e go jako 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

StringFormat(StringFormatFlags, Int32)

Źródło:

StringFormat.cs

Inicjuje nowy StringFormat obiekt przy użyciu określonego StringFormatFlags wyliczenia i języka.

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)

Parametry

options

StringFormatFlags

Wyliczenie StringFormatFlags dla nowego StringFormat obiektu.

language

Int32

Wartość wskazująca język tekstu.