StringFormatFlags Wyliczenie

Definicja

Określa informacje o wyświetlaniu i układzie ciągów tekstowych.Specifies the display and layout information for text strings.

To wyliczenie ma atrybut FlagsAttribute zezwalający na bitową kombinację jego wartości składowych.

public enum class StringFormatFlags
[System.Flags]
public enum StringFormatFlags
type StringFormatFlags = 
Public Enum StringFormatFlags
Dziedziczenie
StringFormatFlags
Atrybuty

Pola

DirectionRightToLeft 1

Tekst jest wyświetlany od prawej do lewej.Text is displayed from right to left.

DirectionVertical 2

Tekst jest wyrównany w pionie.Text is vertically aligned.

DisplayFormatControl 32

Znaki kontrolne, takie jak znacznik od lewej do prawej, są wyświetlane w danych wyjściowych z symbolem reprezentatywnym.Control characters such as the left-to-right mark are shown in the output with a representative glyph.

FitBlackBox 4

Części znaków mogą pozwisać prostokąt układu ciągu.Parts of characters are allowed to overhang the string's layout rectangle. Domyślnie znaki są zmieniane, aby uniknąć jakiegokolwiek zwisu.By default, characters are repositioned to avoid any overhang.

LineLimit 8192

W prostokącie formatowania są ułożone tylko całe linie.Only entire lines are laid out in the formatting rectangle. Domyślnie układ jest kontynuowany do końca tekstu lub do momentu, gdy nie będzie widocznych więcej wierszy w wyniku wycinka, zależnie od tego, co nastąpi wcześniej.By default layout continues until the end of the text, or until no more lines are visible as a result of clipping, whichever comes first. Należy zauważyć, że ustawienia domyślne zezwalają na częściowe zaciemnienie ostatniej linii przez prostokąt formatowania, który nie jest całkowicie wielokrotnością wysokości linii.Note that the default settings allow the last line to be partially obscured by a formatting rectangle that is not a whole multiple of the line height. Aby upewnić się, że widoczne są tylko całe linie, określ tę wartość i należy zachować ostrożność w celu zapewnienia prostokąta formatowania, który ma co najmniej wysokość jednego wiersza.To ensure that only whole lines are seen, specify this value and be careful to provide a formatting rectangle at least as tall as the height of one line.

MeasureTrailingSpaces 2048

Zawiera końcowe miejsce na końcu każdego wiersza.Includes the trailing space at the end of each line. Domyślnie prostokąt graniczny zwracany przez metodę MeasureString wyklucza odstępy na końcu każdego wiersza.By default the boundary rectangle returned by the MeasureString method excludes the space at the end of each line. Ustaw tę flagę, aby uwzględnić to miejsce w pomiar.Set this flag to include that space in measurement.

NoClip 16384

Elementy, które mogą być wyświetlane, nadwieszanie części symboli i nieopakowany tekst wykraczający poza prostokąt formatowania.Overhanging parts of glyphs, and unwrapped text reaching outside the formatting rectangle are allowed to show. Domyślnie wszystkie fragmenty tekstu i glifów, które wykraczają poza prostokąt formatowania, są obcinane.By default all text and glyph parts reaching outside the formatting rectangle are clipped.

NoFontFallback 1024

Nie można przeprowadzić zamiany na alternatywne czcionki dla znaków nieobsługiwanych w wymaganej czcionce.Fallback to alternate fonts for characters not supported in the requested font is disabled. Wszystkie brakujące znaki są wyświetlane z czcionką brak glifu, zwykle jest to otwarty kwadrat.Any missing characters are displayed with the fonts missing glyph, usually an open square.

NoWrap 4096

Zawijanie tekstu między wierszami, gdy formatowanie w prostokącie jest wyłączone.Text wrapping between lines when formatting within a rectangle is disabled. Ta flaga jest implikowana, gdy punkt jest przenoszona zamiast prostokąta lub gdy określony prostokąt ma zerową długość wiersza.This flag is implied when a point is passed instead of a rectangle, or when the specified rectangle has a zero line length.

Przykłady

Poniższy przykład kodu ilustruje następujące elementy członkowskie:The following code example demonstrates the following members:

Ten przykład jest przeznaczony do użycia z Windows Forms.This example is designed to be used with Windows Forms. Wklej kod do formularza i Wywołaj metodę ShowLineAndAlignment podczas obsługi zdarzenia Paint formularza, przekazując e jako PaintEventArgs.Paste the code into a form and call the ShowLineAndAlignment method when handling the form's Paint event, passing e as 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

Uwagi

StringFormatFlags jest używana przez klasę StringFormat.StringFormatFlags is used by the StringFormat class.

Uwaga

Pole FitBlackBox miało nazwę, a jego zachowanie jest podobne do pola NoFitBlackBox w oryginalnej implementacji GDI+.The FitBlackBox field was misnamed and its behavior is similar to the NoFitBlackBox field in the original GDI+ implementation.

Dotyczy