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. |