StringFormatFlags StringFormatFlags StringFormatFlags StringFormatFlags Enum

Definizione

Specifica le informazioni relative alla visualizzazione e al layout per le stringhe di testo.Specifies the display and layout information for text strings.

Questa enumerazione ha un attributo FlagsAttribute che consente una combinazione bit per bit dei valori del relativo membro.

public enum class StringFormatFlags
[System.Flags]
public enum StringFormatFlags
type StringFormatFlags = 
Public Enum StringFormatFlags
Ereditarietà
StringFormatFlagsStringFormatFlagsStringFormatFlagsStringFormatFlags
Attributi

Campi

DirectionRightToLeft DirectionRightToLeft DirectionRightToLeft DirectionRightToLeft 1

Il testo è visualizzato da destra a sinistra.Text is displayed from right to left.

DirectionVertical DirectionVertical DirectionVertical DirectionVertical 2

Il testo è allineato in senso verticale.Text is vertically aligned.

DisplayFormatControl DisplayFormatControl DisplayFormatControl DisplayFormatControl 32

I caratteri di controllo, quali il simbolo di formattazione da sinistra a destra, sono visualizzati nell'output con un glifo rappresentativo.Control characters such as the left-to-right mark are shown in the output with a representative glyph.

FitBlackBox FitBlackBox FitBlackBox FitBlackBox 4

Parti dei caratteri possono fuoriuscire dal rettangolo di layout della stringa.Parts of characters are allowed to overhang the string's layout rectangle. Per impostazione predefinita, i caratteri vengono riposizionati per evitare eventuali fuoriuscite.By default, characters are repositioned to avoid any overhang.

LineLimit LineLimit LineLimit LineLimit 8192

Nel rettangolo di formattazione vengono disposte solo le righe intere.Only entire lines are laid out in the formatting rectangle. Per impostazione predefinita, il layout continua fino alla fine del testo o fino a quando non sono visibili altre righe a causa di un'operazione di taglio.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. Le impostazioni predefinite consentono all'ultima riga di essere parzialmente oscurata da un rettangolo di formattazione che non è un multiplo intero dell'altezza della riga.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. Per garantire che siano visibili solo le righe intere, occorre specificare questo valore e fornire un rettangolo di formattazione la cui altezza sia almeno pari a quella di una riga.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 MeasureTrailingSpaces MeasureTrailingSpaces MeasureTrailingSpaces 2048

Include lo spazio di primo al termine di ciascuna riga.Includes the trailing space at the end of each line. Per impostazione predefinita, il rettangolo di delimitazione restituito dal metodo MeasureString esclude lo spazio al termine di ogni riga.By default the boundary rectangle returned by the MeasureString method excludes the space at the end of each line. Impostare questo flag per includere lo spazio nella misurazione.Set this flag to include that space in measurement.

NoClip NoClip NoClip NoClip 16384

È consentita la visualizzazione delle parti sporgenti dei glifi e del testo senza ritorno a capo che fuoriesce dal rettangolo di formattazione.Overhanging parts of glyphs, and unwrapped text reaching outside the formatting rectangle are allowed to show. Per impostazioni predefinita, tutte le parti di testo e di glifi che fuoriescono dal rettangolo di formattazione vengono troncate.By default all text and glyph parts reaching outside the formatting rectangle are clipped.

NoFontFallback NoFontFallback NoFontFallback NoFontFallback 1024

Il fallback su tipi di carattere alternativi, per i caratteri non supportati dal tipo di carattere richiesto, non è attivo.Fallback to alternate fonts for characters not supported in the requested font is disabled. Tutti i caratteri mancanti vengono visualizzati con un glifo rappresentativo, in genere un quadrato vuoto.Any missing characters are displayed with the fonts missing glyph, usually an open square.

NoWrap NoWrap NoWrap NoWrap 4096

Il ritorno a capo tra le righe durante la formattazione all'interno di un rettangolo non è attivo.Text wrapping between lines when formatting within a rectangle is disabled. Questo flag viene utilizzato quando viene passato un punto al posto di un rettangolo o quando la lunghezza delle linee del rettangolo specificato è pari a zero.This flag is implied when a point is passed instead of a rectangle, or when the specified rectangle has a zero line length.

Esempi

L'esempio di codice seguente illustra i membri seguenti:The following code example demonstrates the following members:

In questo esempio è progettato per essere usato con Windows Form.This example is designed to be used with Windows Forms. Incollare il codice in un form e si chiama il ShowLineAndAlignment metodo durante la gestione del modulo Paint evento passando e come 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

Commenti

StringFormatFlags viene usato per il StringFormat classe.StringFormatFlags is used by the StringFormat class.

Nota

Il campo FitBlackBox senza denominazione e il relativo comportamento è simile al NoFitBlackBox campo nell'implementazione originale GDI+.The FitBlackBox field was misnamed and its behavior is similar to the NoFitBlackBox field in the original GDI+ implementation.

Si applica a