Megosztás:


Értékek formázása

Ez a szakasz a DrawThemeText és GetThemeTextExtent függvény dwTextFlags paraméteréhez használt értékeket sorolja fel. Egy vagy több ilyen érték a szöveges sztring formázásának megadására szolgál. A DrawThemeText függvény a szöveges sztringet a pRect paraméter által megadott megjelenítési téglalapon belül rajzolja meg. A GetThemeTextExtent függvénnyel meghatározható egy adott hosszúságú és formátumú szöveghez szükséges határoló téglalap.

Értékek formázása

Az alábbi táblázat a formátumértékeket sorolja fel.

Érték Leírás
DT_BOTTOM Megjeleníti a szöveges sztringet a megjelenítendő téglalap alján. Ez az érték csak a DT_SINGLELINE értékkel használható.
DT_CALCRECT Meghatározza a megjelenítési téglalap szélességét és magasságát.
DT_CENTER Vízszintesen középre igazítja a szöveget a megjelenítendő téglalapban.
DT_EDITCONTROL Duplikálja a többsoros szerkesztési vezérlő szövegmegjelenítő jellemzőit. Pontosabban az átlagos karakterszélesség kiszámítása ugyanúgy történik, mint egy szerkesztési vezérlő esetében, és a függvény nem jelenít meg részlegesen látható utolsó sort.
DT_END_ELLIPSIS Csonkít egy olyan szöveges sztringet, amely szélesebb a megjelenített téglalapnál, és hozzáad egy három pontot a csonkolás jelzéséhez. A sztring csak akkor módosul, ha a DT_MODIFYSTRING jelző meg van adva.
DT_EXPANDTABS Kibontja a tabulátorkaraktereket. A laponkénti karakterek alapértelmezett száma nyolc. A DT_WORD_ELLIPSIS, DT_PATH_ELLIPSIS és DT_END_ELLIPSIS értékek nem használhatók a DT_EXPANDTABS értékkel.
DT_EXTERNALLEADING Tartalmazza a vonalmagasságban lévő betűtípus külső kezdőpontját. A külső bevezető általában nem szerepel a szövegsor magasságában.
DT_HIDEPREFIX Figyelmen kívül hagyja a szövegben & előtagot. Az alábbi betű nincs aláhúzva, de a többi előtag karaktere továbbra is feldolgozásra kerül. Például:
bemeneti sztring: "A&bc&&d"
normal: "Abc&d"
DT_HIDEPREFIX: "Abc&d"
DT_LEFT Balra igazítja a szöveget.
DT_MODIFYSTRING Módosít egy sztringet a megjelenített szövegnek megfelelően. Ez az érték csak akkor lép érvénybe, ha DT_END_ELLIPSIS vagy DT_PATH_ELLIPSIS van megadva.
DT_NOCLIP A szöveges sztring rajzolása a megjelenítendő téglalap kivágása nélkül.
DT_NOFULLWIDTHCHARBREAK Megakadályozza a kétbájtos karakterkészletek (DBCS) sortörését, hogy a sortörési szabály egyenértékű legyen az egybájtos karakterkészlettel (SBCS). Ezzel például olvashatóbbá teheti a koreai szövegben írt ikonfeliratokat. Ez az érték csak akkor lép érvénybe, ha DT_WORDBREAK van megadva.
DT_NOPREFIX Kikapcsolja az előtagkarakterek feldolgozását. Általában DrawThemeText az előtag karakterét & irányelvként értelmezi, amely aláhúzza a következő karaktert, az előtagkarakterek pedig irányelvként && egyetlen &nyomtatásához. A DT_NOPREFIX megadásával ez a feldolgozás ki van kapcsolva. Például:
bemeneti sztring: "A&bc&&d"
normal: "Abc&d"
DT_NOPREFIX: "A&bc&&d"
DT_PATH_ELLIPSIS A szöveg közepén lévő karaktereket három pontra cseréli, hogy az eredmény illeszkedjen a megjelenítendő téglalapba. Ha a sztring fordított perjel (\) karaktereket tartalmaz, DT_PATH_ELLIPSIS az utolsó fordított perjel után a lehető legnagyobb mértékben megőrzi a szöveget. A sztring csak akkor módosul, ha a DT_MODIFYSTRING jelző meg van adva.
DT_PREFIXONLY Csak aláhúzást rajzol a karakter pozíciójára a &előtagot követő karakter után. A DrawThemeTextáltalábanirányelvként értelmezi a &, hogy aláhúzza a következő karaktert, és az előtag karaktereket && irányelvként egyetlen &nyomtatni. A DT_PREFIXONLY megadásával a program nem rajzol karaktereket, csak aláhúzást. A fehér szóközök olyan pozícióba kerülnek, ahol a karakterek általában megjelennek. Például:
bemeneti sztring: "A&bc&&d"
normal: "Abc&d
DT_PREFIXONLY: " "
DT_RIGHT Jobbra igazítja a szöveget.
DT_RTLREADING A szöveget jobbról balra rendezi a kétirányú szöveghez, például héber vagy arab betűtípussal. A szöveg alapértelmezett iránya balról jobbra.
DT_SINGLELINE Egyetlen sorban jeleníti meg a szöveget. A kocsivisszaadások és a vonalcsatornák nem törik meg a vonalat.
DT_TABSTOP Tabulátorok beállítása.
DT_TOP A megjelenítendő téglalap tetején lévő szöveget jeleníti meg.
DT_VCENTER Függőlegesen középre igazítja a szöveget. Ez az érték csak a DT_SINGLELINE értékkel használható.
DT_WORDBREAK Ha egy szó túlnyúlna a megjelenítendő téglalap szélén, sorokat szakítana a szavak között. A kocsivissza-/sorbetöltés (CR/LF) sorozat is megszakítja a vonalat.
DT_WORD_ELLIPSIS Csonkolja azokat a szavakat, amelyek nem férnek el a megjelenített téglalapban, és három pontot ad hozzá.