Enumerazione StringFormatFlags (gdiplusenums.h)

Articolo
02/23/2024

L'enumerazione StringFormatFlags specifica informazioni sul layout del testo (ad esempio orientamento e ritaglio) e manipolazioni di visualizzazione,ad esempio inserimento con puntini di sospensione, sostituzione delle cifre e rappresentazione di caratteri non supportati da un tipo di carattere.

Sintassi

typedef enum StringFormatFlags {
  StringFormatFlagsDirectionRightToLeft = 0x00000001,
  StringFormatFlagsDirectionVertical = 0x00000002,
  StringFormatFlagsNoFitBlackBox = 0x00000004,
  StringFormatFlagsDisplayFormatControl = 0x00000020,
  StringFormatFlagsNoFontFallback = 0x00000400,
  StringFormatFlagsMeasureTrailingSpaces = 0x00000800,
  StringFormatFlagsNoWrap = 0x00001000,
  StringFormatFlagsLineLimit = 0x00002000,
  StringFormatFlagsNoClip = 0x00004000,
  StringFormatFlagsBypassGDI = 0x80000000
} ;

Costanti


`StringFormatFlagsDirectionRightToLeft` Valore: 0x00000001 Specifica che l'ordine di lettura è da destra a sinistra. Per il testo orizzontale, i caratteri vengono letti da destra a sinistra. Per il testo verticale, le colonne vengono lette da destra a sinistra. Per impostazione predefinita, il testo orizzontale o verticale viene letto da sinistra a destra.
`StringFormatFlagsDirectionVertical` Valore: 0x00000002 Specifica che le singole righe di testo vengono disegnate verticalmente nel dispositivo di visualizzazione. Per impostazione predefinita, le righe di testo sono orizzontali, ogni nuova riga sotto la riga precedente.
`StringFormatFlagsNoFitBlackBox` Valore: 0x00000004 Specifica che parti di caratteri possono sovrapporsi al rettangolo di layout della stringa. Per impostazione predefinita, i caratteri vengono prima allineati all'interno dei limiti del rettangolo, quindi tutti i caratteri che continuano a sporgere i limiti vengono riposizionati per evitare l'overhang e quindi evitare di influire sui pixel all'esterno del rettangolo di layout. Una lettera corsiva minuscola F (f) è un esempio di carattere che può avere parti sporgenti. L'impostazione di questo flag garantisce che il carattere sia allineato visivamente con le righe sopra e sotto, ma può causare parti di caratteri, che si trovano all'esterno del rettangolo di layout, essere ritagliate o disegnate.
`StringFormatFlagsDisplayFormatControl` Valore: 0x00000020 Specifica che i caratteri di controllo del layout Unicode vengono visualizzati con un carattere rappresentativo.
`StringFormatFlagsNoFontFallback` Valore: 0x00000400 Specifica che viene utilizzato un tipo di carattere alternativo per i caratteri non supportati nel tipo di carattere richiesto. Per impostazione predefinita, tutti i caratteri mancanti vengono visualizzati con il carattere "font mancante", in genere un quadrato aperto.
`StringFormatFlagsMeasureTrailingSpaces` Valore: 0x00000800 Specifica che lo spazio alla fine di ogni riga viene incluso in una misura di stringa. Per impostazione predefinita, il rettangolo limite restituito da Il metodo Graphics::MeasureString esclude lo spazio alla fine di ogni riga. Impostare questo flag per includere tale spazio nella misura.
`StringFormatFlagsNoWrap` Valore: 0x00001000 Specifica che il ritorno a capo del testo alla riga successiva è disabilitato. NoWrap è implicito quando viene usato un punto di origine anziché un rettangolo di layout. Quando si disegna testo all'interno di un rettangolo, per impostazione predefinita, il testo viene interrotto all'interno del limite dell'ultima parola all'interno del limite del rettangolo e sottoposto a wrapping alla riga successiva.
`StringFormatFlagsLineLimit` Valore: 0x00002000 Specifica che solo le righe intere sono disposte nel rettangolo di layout. Per impostazione predefinita, il layout continua fino alla fine del testo o fino a quando non sono visibili altre righe in seguito al ritaglio, a prescindere dal primo. Le impostazioni predefinite consentono di nascondere parzialmente l'ultima riga da un rettangolo di layout che non è un intero multiplo dell'altezza della riga. Per assicurarsi che vengano visualizzate solo linee intere, impostare questo flag e prestare attenzione a fornire un rettangolo di layout almeno pari all'altezza di una riga.
`StringFormatFlagsNoClip` Valore: 0x00004000 Specifica che i caratteri sporgenti del rettangolo di layout e del testo che si estendono all'esterno del rettangolo di layout possono essere visualizzati. Per impostazione predefinita, tutti i caratteri e il testo sporgenti che si estendono all'esterno del rettangolo di layout vengono ritagliati. Tutti gli spazi finali (spazi che si trovano alla fine di una linea) che si estendono all'esterno del rettangolo di layout vengono ritagliati. Pertanto, l'impostazione di questo flag avrà un effetto su una misura di stringa se gli spazi finali vengono inclusi nella misura. Se il ritaglio è abilitato, gli spazi finali che si estendono all'esterno del rettangolo di layout non sono inclusi nella misura. Se il ritaglio è disabilitato, tutti gli spazi finali vengono inclusi nella misura, indipendentemente dal fatto che si trovino all'esterno del rettangolo di layout.
`StringFormatFlagsBypassGDI` Valore: 0x80000000

Commenti

Più flag impostati possono produrre effetti combinati:

Quando vengono impostati sia StringFormatFlagsDirectionVerticalche StringFormatFlagsDirectionRightToLeft , vengono disegnate verticalmente singole righe di testo. La prima riga inizia al bordo destro del rettangolo di layout; la seconda riga di testo è a sinistra della prima riga e così via.
Quando StringFormatFlagsDirectionVertical è impostato e StringFormatFlagsDirectionRightToLeft non è impostato, le singole righe di testo vengono disegnate verticalmente. La prima riga inizia al bordo sinistro del rettangolo di layout; la seconda riga di testo è a destra della prima riga.
Quando StringFormatFlagsDirectionRightToLeft è impostato e StringFormatFlagsDirectionVertical non è impostato, le singole righe di testo sono orizzontali e l'ordine di lettura è da destra a sinistra. Questa impostazione non modifica l'ordine in cui vengono visualizzati i caratteri, specifica semplicemente l'ordine in cui è possibile leggere i caratteri.

I flag StringFormatFlagsDirectionVertical e StringFormatFlagsDirectionRightToLeft possono influire sull'allineamento delle stringhe.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	gdiplusenums.h (include Gdiplus.h)