StringFormatFlags Enumerazione

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Origine:

StringFormatFlags.cs

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à

Object

ValueType

Enum

StringFormatFlags

Attributi

FlagsAttribute

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:

• Rectangle

• StringFormat

• StringFormat

• Alignment

• LineAlignment

• StringAlignment

• StringFormatFlags

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.