StringFormatFlags Enumerazione
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
- 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.
