StringFormatFlags Enumeration

Definition

Namespace:
System.Drawing
Assembly:
System.Drawing.dll

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

Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.

public enum class StringFormatFlags
[System.Flags]
public enum StringFormatFlags
[<System.Flags>]
type StringFormatFlags = 
Public Enum StringFormatFlags
Vererbung
Object
ValueType
Enum
StringFormatFlags
Attribute
FlagsAttribute

Felder

Name Wert Beschreibung
DirectionRightToLeft 1

Text wird von rechts nach links angezeigt.
DirectionVertical 2

Text wird vertikal ausgerichtet.
FitBlackBox 4

Teile von Zeichen dürfen das Layoutrechteck der Zeichenfolge überhängen. Standardmäßig werden Zeichen neu positioniert, um einen Überhang zu vermeiden.
DisplayFormatControl 32

Steuerzeichen wie das links-nach-rechts-Zeichen werden in der Ausgabe mit einer repräsentativen Glyphe angezeigt.
NoFontFallback 1024

Fallback auf alternative Schriftarten für Zeichen, die in der angeforderten Schriftart nicht unterstützt werden, ist deaktiviert. Fehlende Zeichen werden mit fehlenden Schriftarten angezeigt, die glyphen fehlen, in der Regel ein offenes Quadrat.
MeasureTrailingSpaces 2048

Enthält das nachfolgende Leerzeichen am Ende jeder Zeile. Standardmäßig schließt das von der MeasureString Methode zurückgegebene Begrenzungsrechteck den Abstand am Ende jeder Zeile aus. Legen Sie dieses Kennzeichen fest, um diesen Abstand in die Maßeinheit einzuschließen.
NoWrap 4096

Textumbruch zwischen Zeilen, wenn die Formatierung innerhalb eines Rechtecks deaktiviert ist. Dieses Kennzeichen wird impliziert, wenn anstelle eines Rechtecks ein Punkt übergeben wird oder wenn das angegebene Rechteck eine Länge der Nullzeile aufweist.
LineLimit 8192

Nur ganze Zeilen werden im Formatierungsrechteck angeordnet. Standardmäßig wird das Layout bis zum Ende des Texts fortgesetzt, oder bis keine weiteren Zeilen als Ergebnis des Clippings sichtbar sind, je nachdem, was zuerst kommt. Beachten Sie, dass die Standardeinstellungen zulassen, dass die letzte Zeile teilweise durch ein Formatierungsrechteck verdeckt wird, bei dem es sich nicht um ein ganzes Vielfaches der Zeilenhöhe handelt. Um sicherzustellen, dass nur ganze Zeilen angezeigt werden, geben Sie diesen Wert an, und achten Sie darauf, ein Formatierungsrechteck mindestens so hoch wie die Höhe einer Zeile bereitzustellen.
NoClip 16384

Überhanging von Teilen von Glyphen und unwrappten Text, der außerhalb des Formatierungsrechtecks liegt, dürfen angezeigt werden. Standardmäßig werden alle Text- und Glyphenteile, die außerhalb des Formatierungsrechtecks liegen, abgeschnitten.

Beispiele

Im folgenden Codebeispiel werden die folgenden Member veranschaulicht:

Dieses Beispiel wurde für die Verwendung mit Windows Forms entwickelt. Fügen Sie den Code in ein Formular ein, und rufen Sie die ShowLineAndAlignment Methode beim Behandeln des Formularereignisses Paint auf und übergeben als ePaintEventArgs.

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

Hinweise

StringFormatFlags wird von der StringFormat Klasse verwendet.

Note

Das Feld "FitBlackBox" wurde falsch benannt, und sein Verhalten ähnelt dem NoFitBlackBox Feld in der ursprünglichen GDI+-Implementierung.

Gilt für: