Formato valori

Questa sezione elenca i valori utilizzati con il parametro dwTextFlags delle funzioni DrawThemeText e GetThemeTextExtent. Uno o più di questi valori vengono usati per specificare la modalità di formattazione di una stringa di testo. La funzione DrawThemeText disegna la stringa di testo all'interno di un rettangolo di visualizzazione, specificato dal parametro pRect . La funzione GetThemeTextExtent può essere utilizzata per determinare il rettangolo di delimitazione necessario per il testo di una determinata lunghezza e formato.

Formato valori

Nella tabella seguente sono elencati i valori di formato.

Valore	Descrizione
DT_BOTTOM	Esegue il rendering della stringa di testo nella parte inferiore del rettangolo di visualizzazione. Questo valore viene usato solo con il valore DT_SINGLELINE.
DT_CALCRECT	Determina la larghezza e l'altezza del rettangolo di visualizzazione.
DT_CENTER	Centra il testo orizzontalmente nel rettangolo di visualizzazione.
DT_EDITCONTROL	Duplica le caratteristiche di visualizzazione del testo di un controllo di modifica su più righe. In particolare, la larghezza media dei caratteri viene calcolata nello stesso modo di un controllo di modifica e la funzione non visualizza un'ultima riga parzialmente visibile.
DT_END_ELLIPSIS	Tronca una stringa di testo più ampia del rettangolo di visualizzazione e aggiunge i puntini di sospensione per indicare il troncamento. La stringa non viene modificata a meno che non venga specificato il flag DT_MODIFYSTRING.
DT_EXPANDTABS	Espande i caratteri di tabulazioni. Il numero predefinito di caratteri per scheda è otto. I valori DT_WORD_ELLIPSIS, DT_PATH_ELLIPSIS e DT_END_ELLIPSIS non possono essere utilizzati con il valore DT_EXPANDTABS.
DT_EXTERNALLEADING	Include l'inizio esterno di un tipo di carattere nell'altezza della riga. In genere, l'inizio esterno non è incluso nell'altezza di una riga di testo.
DT_HIDEPREFIX	Ignora il carattere prefisso e nel testo. La lettera che segue non è sottolineata, ma altri caratteri di prefisso vengono comunque elaborati. Ad esempio: stringa di input: "A&bc&&d" normal: "Abc&d" DT_HIDEPREFIX: "Abc&d"
DT_LEFT	Allinea il testo a sinistra.
DT_MODIFYSTRING	Modifica una stringa in modo che corrisponda al testo visualizzato. Questo valore non ha alcun effetto a meno che non venga specificato DT_END_ELLIPSIS o DT_PATH_ELLIPSIS.
DT_NOCLIP	Disegna la stringa di testo senza ritagliare il rettangolo di visualizzazione.
DT_NOFULLWIDTHCHARBREAK	Impedisce un'interruzione di riga in corrispondenza di un set di caratteri a byte doppio (DBCS), in modo che la regola di interruzione della riga sia equivalente al set di caratteri a byte singolo (SBCS). Questa opzione può essere usata, ad esempio, per rendere più leggibili le etichette delle icone scritte nel testo coreano. Questo valore non ha alcun effetto a meno che non venga specificato DT_WORDBREAK.
DT_NOPREFIX	Disattiva l'elaborazione dei caratteri di prefisso. In genere, DrawThemeText interpreta il carattere prefisso & come direttiva per evidenziare il carattere che segue e i caratteri di prefisso && come direttiva per stampare un singolo &. Specificando DT_NOPREFIX, questa elaborazione viene disattivata. Ad esempio: stringa di input: "A&bc&&d" normal: "Abc&d" DT_NOPREFIX: "A&bc&&d"
DT_PATH_ELLIPSIS	Sostituisce i caratteri al centro del testo con i puntini di sospensione in modo che il risultato si adatti al rettangolo di visualizzazione. Se la stringa contiene caratteri barra rovesciata (\), DT_PATH_ELLIPSIS mantiene il più possibile il testo dopo l'ultima barra rovesciata. La stringa non viene modificata a meno che non venga specificato il flag DT_MODIFYSTRING.
DT_PREFIXONLY	Disegna solo una sottolineatura in corrispondenza della posizione del carattere dopo il carattere prefisso &. In genere DrawThemeText interpreta il & come direttiva per sottolineare il carattere che segue e i caratteri di prefisso && come direttiva per stampare un singolo &. Specificando DT_PREFIXONLY, non vengono disegnati caratteri, ma solo una sottolineatura. Gli spazi vuoti vengono posizionati nelle posizioni in cui normalmente vengono visualizzati i caratteri. Ad esempio: stringa di input: "A&bc&&d" normal: "Abc&d DT_PREFIXONLY: " "
DT_RIGHT	Allinea il testo a destra.
DT_RTLREADING	Dispone il testo in ordine da destra a sinistra per il testo bidirezionale, ad esempio testo in un carattere ebraico o arabo. La direzione predefinita per il testo è da sinistra a destra.
DT_SINGLELINE	Visualizza il testo su una singola riga. I ritorni a capo e i feed di riga non interrompono la riga.
DT_TABSTOP	Imposta tabulazioni.
DT_TOP	Esegue il rendering del testo nella parte superiore del rettangolo di visualizzazione.
DT_VCENTER	Centra il testo verticalmente. Questo valore viene usato solo con il valore DT_SINGLELINE.
DT_WORDBREAK	Interrompe le righe tra le parole se una parola si estende oltre il bordo del rettangolo di visualizzazione. Anche una sequenza di ritorno a capo/avanzamento riga (CR/LF) interrompe la riga.
DT_WORD_ELLIPSIS	Tronca qualsiasi parola che non rientra nel rettangolo di visualizzazione e aggiunge i puntini di sospensione.