StringFormatFlags Enumerazione

Definizione

Spazio dei nomi:
System.Drawing
Assembly:
System.Drawing.dll

Specifica le informazioni di visualizzazione e 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

Nome Valore Descrizione
DirectionRightToLeft 1

Il testo viene visualizzato da destra a sinistra.
DirectionVertical 2

Il testo è allineato verticalmente.
FitBlackBox 4

Le parti dei caratteri possono sovrapporsi al rettangolo di layout della stringa. Per impostazione predefinita, i caratteri vengono riposizionati per evitare un sovraccarico.
DisplayFormatControl 32

I caratteri di controllo, ad esempio il segno da sinistra a destra, vengono visualizzati nell'output con un glifo rappresentativo.
NoFontFallback 1024

Il fallback a tipi di carattere alternativi per i caratteri non supportati nel tipo di carattere richiesto è disabilitato. I caratteri mancanti vengono visualizzati con i tipi di carattere mancanti, in genere un quadrato aperto.
MeasureTrailingSpaces 2048

Include lo spazio finale alla fine di ogni riga. Per impostazione predefinita, il rettangolo limite restituito dal MeasureString metodo esclude lo spazio alla fine di ogni riga. Impostare questo flag per includere tale spazio nella misura.
NoWrap 4096

La disposizione del testo tra le righe quando la formattazione all'interno di un rettangolo è disabilitata. Questo flag è implicito quando viene passato un punto anziché un rettangolo o quando il rettangolo specificato ha una lunghezza di riga zero.
LineLimit 8192

Solo le righe intere sono disposte nel rettangolo di formattazione. Per impostazione predefinita, il layout continua fino alla fine del testo o fino a quando non sono visibili altre righe a causa del ritaglio, a prescindere dal primo. Si noti che le impostazioni predefinite consentono di nascondere parzialmente l'ultima riga da un rettangolo di formattazione che non è un intero multiplo dell'altezza della riga. Per assicurarsi che vengano visualizzate solo le righe intere, specificare questo valore e prestare attenzione a fornire un rettangolo di formattazione almeno quanto l'altezza di una riga.
NoClip 16384

È possibile visualizzare parti sporgenti di glifi e testo non compresso che si estende all'esterno del rettangolo di formattazione. Per impostazione predefinita, tutte le parti di testo e glifo che raggiungono l'esterno del rettangolo di formattazione vengono ritagliate.

Esempio

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

Questo esempio è progettato per essere usato con Windows Form. Incollare il codice in una maschera e chiamare il ShowLineAndAlignment metodo quando si gestisce l'evento 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 .

Annotazioni

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

Si applica a