StringFormatFlags Enumerazione

Definizione

Specifica le informazioni relative alla visualizzazione e al layout per le stringhe di testo.

Questa enumerazione supporta una combinazione bit per bit dei rispettivi valori dei membri.

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

Campi

DirectionRightToLeft 1

Il testo è visualizzato da destra a sinistra.

DirectionVertical 2

Il testo è allineato in senso verticale.

DisplayFormatControl 32

I caratteri di controllo, quali il simbolo di formattazione da sinistra a destra, sono visualizzati nell'output con un glifo rappresentativo.

FitBlackBox 4

Parti dei caratteri possono fuoriuscire dal rettangolo di layout della stringa. Per impostazione predefinita, i caratteri vengono riposizionati per evitare eventuali fuoriuscite.

LineLimit 8192

Nel rettangolo di formattazione vengono disposte solo le righe intere. 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. 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. 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.

MeasureTrailingSpaces 2048

Include lo spazio di primo al termine di ciascuna riga. Per impostazione predefinita, il rettangolo di delimitazione restituito dal metodo MeasureString esclude lo spazio al termine di ogni riga. Impostare questo flag per includere lo spazio nella misurazione.

NoClip 16384

È consentita la visualizzazione delle parti sporgenti dei glifi e del testo senza ritorno a capo che fuoriesce dal rettangolo di formattazione. Per impostazioni predefinita, tutte le parti di testo e di glifi che fuoriescono dal rettangolo di formattazione vengono troncate.

NoFontFallback 1024

Il fallback su tipi di carattere alternativi, per i caratteri non supportati dal tipo di carattere richiesto, non è attivo. Tutti i caratteri mancanti vengono visualizzati con un glifo rappresentativo, in genere un quadrato vuoto.

NoWrap 4096

Il ritorno a capo tra le righe durante la formattazione all'interno di un rettangolo non è attivo. 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.

Esempio

Nell'esempio di codice seguente vengono illustrati i membri seguenti:

Questo esempio è progettato per essere usato con Windows Forms. Incollare il codice in una maschera e chiamare il metodo quando si gestisce l'evento ShowLineAndAlignment del Paint modulo, passando e come 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 dalla StringFormat classe .

Nota

Il campo FitBlackBox è stato nominato erroneamente e il relativo comportamento è simile al NoFitBlackBox campo nell'implementazione GDI+ originale.

Si applica a