Formátování hodnot
V této části jsou uvedeny hodnoty, které se používají s parametrem dwTextFlags funkce DrawThemeText a GetThemeTextExtent. Jedna nebo více těchto hodnot slouží k určení způsobu formátování textového řetězce. Funkce DrawThemeText nakreslí textový řetězec uvnitř obdélníku zobrazení určeného parametrem pRect. Funkci GetThemeTextExtent lze použít k určení potřebného ohraničujícího obdélníku pro text s danou délkou a formátem.
Formátování hodnot
Následující tabulka uvádí hodnoty formátu.
Hodnota | Popis |
---|---|
DT_BOTTOM | Vykreslí textový řetězec v dolní části obdélníku zobrazení. Tato hodnota se používá pouze s hodnotou DT_SINGLELINE. |
DT_CALCRECT | Určuje šířku a výšku obdélníku zobrazení. |
DT_CENTER | Zarovná text vodorovně do obdélníku zobrazení. |
DT_EDITCONTROL | Duplikuje vlastnosti zobrazení textu ovládacího prvku pro víceřádkové úpravy. Konkrétně se průměrná šířka znaků vypočítá stejným způsobem jako u ovládacího prvku pro úpravy a funkce nezobrazuje částečně viditelný poslední řádek. |
DT_END_ELLIPSIS | Zkrátí textový řetězec, který je širší než obdélník zobrazení, a přidá tři tečky, které označují zkrácení. Řetězec není upraven, pokud není zadán příznak DT_MODIFYSTRING. |
DT_EXPANDTABS | Rozbalí znaky tabulátoru. Výchozí početznakůch Hodnoty DT_WORD_ELLIPSIS, DT_PATH_ELLIPSIS a DT_END_ELLIPSIS nelze s hodnotou DT_EXPANDTABS použít. |
DT_EXTERNALLEADING | Zahrnuje vnější začátek písma ve výšce řádku. Za normálníchokolnostch |
DT_HIDEPREFIX | Ignoruje znak předpony & v textu. Následující písmeno není podtržené, ale další znaky předpony se stále zpracovávají. Například: vstupní řetězec: "A&bc&&d" normální: "Abc&d" DT_HIDEPREFIX: "Abc&d" |
DT_LEFT | Zarovná text doleva. |
DT_MODIFYSTRING | Upraví řetězec tak, aby odpovídal zobrazenému textu. Tato hodnota nemá žádný vliv, pokud není zadána DT_END_ELLIPSIS nebo DT_PATH_ELLIPSIS. |
DT_NOCLIP | Nakreslí textový řetězec bez oříznutí obdélníku zobrazení. |
DT_NOFULLWIDTHCHARBREAK | Zabrání zalomení řádku v dvoubabajtů znakové sadě (DBCS), aby pravidlo dělení řádku bylo ekvivalentní jednobabajtů znakové sadě (SBCS). Můžete ho použít například k tomu, aby popisky ikon napsané v korejském textu byly čitelnější. Tato hodnota nemá žádný vliv, pokud není zadána DT_WORDBREAK. |
DT_NOPREFIX | Vypne zpracování znaků předpony. Za normálních okolností DrawThemeText interpretuje znak předpony & jako direktivu podtržítko znaku, který následuje, a předpony && jako direktiva pro tisk jednoho &. Zadáním DT_NOPREFIX je toto zpracování vypnuté. Například: vstupní řetězec: "A&bc&&d" normální: "Abc&d" DT_NOPREFIX: "A&bc&&d" |
DT_PATH_ELLIPSIS | Nahradí znaky uprostřed textu třemi tečkami, aby se výsledek vešl do obdélníku zobrazení. Pokud řetězec obsahuje znaky zpětného lomítka (\), DT_PATH_ELLIPSIS zachová co nejvíce textu za posledním zpětným lomítkem. Řetězec není upraven, pokud není zadán příznak DT_MODIFYSTRING. |
DT_PREFIXONLY | Nakreslí pouze podtržení na pozici znaku za znakem předpony &. Za normálních okolností DrawThemeText interpretuje & jako direktivu podtržení znaku, který následuje, a předpony && jako direktivy k tisku jednoho &. Zadáním DT_PREFIXONLY nejsou nakresleny žádné znaky, pouze podtržení. Prázdné mezery jsou umístěny do pozic, kde by se normálně zobrazovaly znaky. Například: vstupní řetězec: "A&bc&&d" normální: "Abc&d DT_PREFIXONLY: " " |
DT_RIGHT | Zarovná text doprava. |
DT_RTLREADING | Obsahuje text v pořadí zprava doleva pro obousměrný text, například text v hebrejštině nebo arabském písmu. Výchozí směr textu je zleva doprava. |
DT_SINGLELINE | Zobrazí text na jednom řádku. Návraty na začátek řádku a odřádkování nerušují čáru. |
DT_TABSTOP | Nastaví zarážky tabulátoru. |
DT_TOP | Vykreslí text v horní části obdélníku zobrazení. |
DT_VCENTER | Zacentruje text svisle. Tato hodnota se používá pouze s hodnotou DT_SINGLELINE. |
DT_WORDBREAK | Zalomí řádky mezi slovy, pokud by se slovo prodloužilo kolem okraje obdélníku zobrazení. Sekvence návratu na začátek řádku nebo odřádkování (CR/LF) také přeruší čáru. |
DT_WORD_ELLIPSIS | Zkrátí všechna slova, která se nevejdou do obdélníku zobrazení, a přidá tři tečky. |