Sdílet prostřednictvím


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.