Leggere in inglese

Condividi tramite


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.

C#
[System.Flags]
public enum StringFormatFlags
Ereditarietà
StringFormatFlags
Attributi

Campi

Nome Valore Descrizione
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.

C#
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);
}

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

Prodotto Versioni
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9