StringFormatFlags-Enumeration

Artikel
08/20/2007

Gibt die Anzeige- und Layoutinformationen für Textzeichenfolgen an.

Diese Enumeration verfügt über ein FlagsAttribute -Attribut, das die bitweise Kombination der Memberwerte zulässt.

Namespace: System.Drawing
Assembly: System.Drawing (in system.drawing.dll)

Syntax

'Declaration
<FlagsAttribute> _
Public Enumeration StringFormatFlags
'Usage
Dim instance As StringFormatFlags

[FlagsAttribute] 
public enum StringFormatFlags

[FlagsAttribute] 
public enum class StringFormatFlags

/** @attribute FlagsAttribute() */ 
public enum StringFormatFlags

FlagsAttribute 
public enum StringFormatFlags

Member

	Membername	Beschreibung
	DirectionRightToLeft	Der Text wird von rechts nach links angezeigt.
	DirectionVertical	Der Text ist vertikal ausgerichtet.
	DisplayFormatControl	Steuerzeichen, z. B. die Markierung für die Leserichtung von links nach rechts, werden in der Ausgabe durch ein Symbol angezeigt.
	FitBlackBox	Teile von Zeichen dürfen aus dem Layoutrechteck der Zeichenfolge herausragen. Standardmäßig werden Zeichen neu angeordnet, um einen Überhang zu vermeiden.
	LineLimit	Im Formatierungsrechteck erfolgt ein Layout ausschließlich für vollständige Linien. Je nachdem, welches Ereignis zuerst eintritt, wird in der Standardeinstellung das Layout beendet, wenn das Ende des Textes erreicht ist oder als Ergebnis des Abschneidens keine Linien mehr sichtbar sind. Beachten Sie, dass in den Standardeinstellungen die letzte Zeile teilweise durch ein Formatierungsrechteck verborgen sein kann, das kein ganzzahliges Vielfaches der Zeilenhöhe ist. Um sicherzustellen, dass ausschließlich vollständige Zeilen angezeigt werden, geben Sie diesen Wert an, und stellen Sie ein Formatierungsrechteck bereit, das mindestens so hoch wie die Zeilenhöhe ist.
	MeasureTrailingSpaces	Schließt das nachgestellte Leerzeichen am Ende jeder Zeile ein. In der Standardeinstellung schließt das von der MeasureString-Methode zurückgegebene Begrenzungsrechteck Leerzeichen am Ende jeder Zeile aus. Legen Sie dieses Flag fest, um diese Leerzeichen in die Abmessung einzuschließen.
	NoClip	Überhängende Symbolbereiche und Text außerhalb des Formatierungsrechtecks dürfen angezeigt werden. In der Standardeinstellung werden Text und Symbolbereiche außerhalb des Formatierungsrechtecks abgeschnitten.
	NoFontFallback	Fallback zu alternativen Schriftarten für Zeichen, die in der angeforderten Schriftart nicht unterstützt werden. Sämtliche fehlenden Zeichen werden mit dem Symbol für fehlende Zeichen der Schriftart dargestellt, i. d. R. mit einem offenen Rechteck.
	NoWrap	Textumbruch zwischen Zeilen, wenn die Formatierung innerhalb eines Rechtecks deaktiviert ist. Dieses Flag wird generiert, wenn ein Punkt anstelle eines Rechtecks übergeben wird, oder wenn das angegebene Rechteck die Zeilenlänge 0 hat.

Hinweise

StringFormatFlags wird von der StringFormat-Klasse verwendet.

Hinweis

Das FitBlackBox-Feld besitzt in der ursprünglichen GDI+-Implementierung einen irreführenden Namen, und sein Verhalten ist dem des NoFitBlackBox-Felds ähnlich.

Beispiel

Im folgenden Codebeispiel werden folgende Member veranschaulicht:

Dieses Beispiel ist für die Verwendung mit Windows Forms vorgesehen. Fügen Sie den Code in ein Formular ein, und rufen Sie beim Behandeln des Paint-Ereignisses des Formulars die ShowLineAndAlignment-Methode auf, wobei Sie e als PaintEventArgs übergeben.

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

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:
   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.set_LineAlignment(StringAlignment.Near);
    format1.set_Alignment(StringAlignment.Center);
    format2.set_LineAlignment(StringAlignment.Center);
    format2.set_Alignment(StringAlignment.Far);

    // Draw the bounding rectangle and a string for each
    // StringFormat object.
    e.get_Graphics().DrawRectangle(Pens.get_Black(), displayRectangle);
    e.get_Graphics().DrawString("Showing Format1", this.get_Font(), 
        Brushes.get_Red(), (RectangleF.op_Implicit((displayRectangle))),
        format1);
    e.get_Graphics().DrawString("Showing Format2", this.get_Font(),
        Brushes.get_Red(), RectangleF.op_Implicit((displayRectangle)),
        format2);
} //ShowLineAndAlignment

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Freigeben über

StringFormatFlags-Enumeration

Syntax

Member

Hinweise

Beispiel

Plattformen

Versionsinformationen

.NET Framework

.NET Compact Framework

Siehe auch

Referenz

Zusätzliche Ressourcen