Formatera värden
I det här avsnittet visas de värden som används med parametern dwTextFlags för funktionerna DrawThemeText och GetThemeTextExtent. Ett eller flera av dessa värden används för att ange hur en textsträng ska formateras. Funktionen DrawThemeText ritar textsträngen inuti en visningsrektangel som anges av parametern pRect. Funktionen GetThemeTextExtent kan användas för att fastställa vilken rektangel som krävs för text med en viss längd och ett visst format.
Formatera värden
I följande tabell visas formatvärdena.
| Värde | Beskrivning |
|---|---|
| DT_BOTTOM | Renderar textsträngen längst ned i visningsrektangeln. Det här värdet används endast med värdet DT_SINGLELINE. |
| DT_CALCRECT | Avgör bredden och höjden på skärmrektangeln. |
| DT_CENTER | Centrerar texten vågrätt i visningsrektangeln. |
| DT_EDITCONTROL | Duplicerar textvisningsegenskaperna för en redigeringskontroll med flera rader. Mer specifikt beräknas den genomsnittliga teckenbredden på samma sätt som för en redigeringskontroll, och funktionen visar inte en delvis synlig sista rad. |
| DT_END_ELLIPSIS | Trunkerar en textsträng som är bredare än visningsrektangeln och lägger till en ellips för att indikera trunkeringen. Strängen ändras inte om inte flaggan DT_MODIFYSTRING har angetts. |
| DT_EXPANDTABS | Expanderar tabbtecken. Standardantalet tecken per flik är åtta. Värdena DT_WORD_ELLIPSIS, DT_PATH_ELLIPSIS och DT_END_ELLIPSIS kan inte användas med värdet DT_EXPANDTABS. |
| DT_EXTERNALLEADING | Innehåller den externa inledningen av ett teckensnitt i linjehöjden. Normalt ingår inte extern inledande i höjden på en textrad. |
| DT_HIDEPREFIX | Ignorerar prefixtecknet & i texten. Bokstaven som följer är inte understruken, men andra prefixtecken bearbetas fortfarande. Till exempel: indatasträng: "A&bc&&d" normal: "Abc&d" DT_HIDEPREFIX: "Abc&d" |
| DT_LEFT | Justerar text till vänster. |
| DT_MODIFYSTRING | Ändrar en sträng så att den matchar den text som visas. Det här värdet har ingen effekt om inte DT_END_ELLIPSIS eller DT_PATH_ELLIPSIS har angetts. |
| DT_NOCLIP | Ritar textsträngen utan att urklippa visningsrektangeln. |
| DT_NOFULLWIDTHCHARBREAK | Förhindrar en radbrytning vid en teckenuppsättning med dubbla byte (DBCS), så att den radbrytningsregel som motsvarar en bytes teckenuppsättning (SBCS). Detta kan till exempel användas för att göra ikonetiketter skrivna i koreansk text mer läsbara. Det här värdet har ingen effekt om inte DT_WORDBREAK har angetts. |
| DT_NOPREFIX | Inaktiverar bearbetning av prefixtecken. Normalt tolkar DrawThemeText prefixtecknet & som ett direktiv för att understryka tecknet nedan, och prefixtecken && som ett direktiv för att skriva ut en enda &. Genom att ange DT_NOPREFIX inaktiveras den här bearbetningen. Till exempel: indatasträng: "A&bc&&d" normal: "Abc&d" DT_NOPREFIX: "A&bc&&d" |
| DT_PATH_ELLIPSIS | Ersätter tecken i mitten av texten med en ellips så att resultatet får plats i visningsrektangeln. Om strängen innehåller omvänt snedstreck (\) tecken bevarar DT_PATH_ELLIPSIS så mycket som möjligt av texten efter det senaste omvänt snedstrecket. Strängen ändras inte om inte flaggan DT_MODIFYSTRING har angetts. |
| DT_PREFIXONLY | Ritar bara en understrykning vid tecknets position efter prefixtecknet &. Normalt DrawThemeText tolkar & som ett direktiv för att understryka tecknet som följer och prefixtecken && som ett direktiv för att skriva ut en enda &. Genom att ange DT_PREFIXONLY ritas inga tecken, bara en understrykning. Blanksteg placeras i de positioner där tecken normalt skulle visas. Till exempel: indatasträng: "A&bc&&d" normal: "Abc&d DT_PREFIXONLY: " " |
| DT_RIGHT | Justerar text till höger. |
| DT_RTLREADING | Lägger ut text i höger-till-vänster-ordning för dubbelriktad text, till exempel text i ett hebreiskt eller arabiskt teckensnitt. Standardriktningen för text är från vänster till höger. |
| DT_SINGLELINE | Visar text på en enda rad. Vagnreturer och linjematningar bryter inte linjen. |
| DT_TABSTOP | Ställer in tabbstopp. |
| DT_TOP | Renderar texten överst i visningsrektangeln. |
| DT_VCENTER | Centrera text lodrätt. Det här värdet används endast med värdet DT_SINGLELINE. |
| DT_WORDBREAK | Radbrytningar mellan ord om ett ord skulle sträcka sig förbi kanten på visningsrektangeln. En vagnretur-/linjematningssekvens (CR/LF) bryter också linjen. |
| DT_WORD_ELLIPSIS | Trunkerar alla ord som inte får plats i visningsrektangeln och lägger till en ellips. |