Waarden opmaken
Deze sectie bevat de waarden die worden gebruikt met de parameter dwTextFlags van de functies DrawThemeText en GetThemeTextExtent. Een of meer van deze waarden worden gebruikt om op te geven hoe een tekenreeks moet worden opgemaakt. De functie DrawThemeText tekent de tekenreeks in een weergaverechthoek, opgegeven door de parameter pRect. De functie GetThemeTextExtent kan worden gebruikt om de benodigde begrenzingsrechthoek voor tekst van een bepaalde lengte en opmaak te bepalen.
Waarden opmaken
De volgende tabel bevat de notatiewaarden.
Waarde | Beschrijving |
---|---|
DT_BOTTOM | Hiermee wordt de tekenreeks onder aan de weergaverechthoek weergegeven. Deze waarde wordt alleen gebruikt met de DT_SINGLELINE waarde. |
DT_CALCRECT | Bepaalt de breedte en hoogte van de weergaverechthoek. |
DT_CENTER | Centreert tekst horizontaal in de weergaverechthoek. |
DT_EDITCONTROL | Hiermee worden de tekstweergavekenmerken van een besturingselement voor meerdere regels gedupliceerd. De gemiddelde tekenbreedte wordt met name op dezelfde manier berekend als voor een bewerkingsbesturingselement en de functie geeft geen gedeeltelijk zichtbare laatste regel weer. |
DT_END_ELLIPSIS | Kapt een tekenreeks af die breder is dan de weergaverechthoek en voegt een beletselteken toe om de afkapping aan te geven. De tekenreeks wordt niet gewijzigd, tenzij de vlag DT_MODIFYSTRING is opgegeven. |
DT_EXPANDTABS | Hiermee worden tabtekens uitgevouwen. Het standaardaantal tekens per tabblad is acht. De waarden DT_WORD_ELLIPSIS, DT_PATH_ELLIPSIS en DT_END_ELLIPSIS kunnen niet worden gebruikt met de DT_EXPANDTABS waarde. |
DT_EXTERNALLEADING | Bevat de externe voorloop van een lettertype in de lijnhoogte. Normaal gesproken wordt externe voorloop niet opgenomen in de hoogte van een tekstregel. |
DT_HIDEPREFIX | Hiermee wordt het voorvoegsel & in de tekst genegeerd. De volgende letter wordt niet onderstreept, maar andere voorvoegseltekens worden nog steeds verwerkt. Bijvoorbeeld: invoertekenreeks: "A&bc&&d" normaal: "Abc&d" DT_HIDEPREFIX: "Abc&d" |
DT_LEFT | Hiermee wordt tekst links uitgelijnd. |
DT_MODIFYSTRING | Hiermee wijzigt u een tekenreeks zodat deze overeenkomt met de weergegeven tekst. Deze waarde heeft geen effect, tenzij DT_END_ELLIPSIS of DT_PATH_ELLIPSIS is opgegeven. |
DT_NOCLIP | Hiermee tekent u de tekenreeks zonder de weergaverechthoek te knippen. |
DT_NOFULLWIDTHCHARBREAK | Hiermee voorkomt u een regeleinde bij een DBCS-tekenset (double-byte character set), zodat de regel voor regeleinde gelijk is aan SBCS (Single-Byte Character Set). Dit kan bijvoorbeeld worden gebruikt om pictogramlabels die in Koreaanse tekst zijn geschreven beter leesbaar te maken. Deze waarde heeft geen effect tenzij DT_WORDBREAK is opgegeven. |
DT_NOPREFIX | Hiermee schakelt u de verwerking van voorvoegseltekens uit. Normaal gesproken interpreteert DrawThemeText het voorvoegselteken & als richtlijn om het volgende teken te onderstrepen en de voorvoegseltekens && als richtlijn om één &af te drukken. Door DT_NOPREFIX op te geven, is deze verwerking uitgeschakeld. Bijvoorbeeld: invoertekenreeks: "A&bc&&d" normaal: "Abc&d" DT_NOPREFIX: "A&bc&&d" |
DT_PATH_ELLIPSIS | Vervangt tekens in het midden van tekst door een beletselteken, zodat het resultaat in de weergaverechthoek past. Als de tekenreeks backslashtekens (\) bevat, behoudt DT_PATH_ELLIPSIS zoveel mogelijk tekst na de laatste backslash. De tekenreeks wordt niet gewijzigd, tenzij de vlag DT_MODIFYSTRING is opgegeven. |
DT_PREFIXONLY | Hiermee tekent u alleen een onderstreping op de positie van het teken na het voorvoegsel &. Normaal gesproken DrawThemeText de & interpreteert als richtlijn om het volgende teken te onderstrepen en de voorvoegseltekens && als richtlijn om één &af te drukken. Door DT_PREFIXONLY op te geven, worden er geen tekens getekend, alleen een onderstreping. Spaties worden in de posities geplaatst waar normaal gesproken tekens worden weergegeven. Bijvoorbeeld: invoertekenreeks: "A&bc&&d" normaal: "Abc&d DT_PREFIXONLY: " " |
DT_RIGHT | Hiermee wordt tekst rechts uitgelijnd. |
DT_RTLREADING | Hierin wordt tekst in de volgorde van rechts naar links voor bidirectionele tekst weergegeven, bijvoorbeeld tekst in een Hebreeuws of Arabisch lettertype. De standaardrichting voor tekst is van links naar rechts. |
DT_SINGLELINE | Hiermee wordt tekst op één regel weergegeven. Regelterugloop en regelfeeds breken de lijn niet. |
DT_TABSTOP | Hiermee stelt u tabstops in. |
DT_TOP | Hiermee wordt de tekst boven aan de weergaverechthoek weergegeven. |
DT_VCENTER | Centreert tekst verticaal. Deze waarde wordt alleen gebruikt met de DT_SINGLELINE waarde. |
DT_WORDBREAK | Hiermee worden regels tussen woorden verbroken als een woord voorbij de rand van de weergaverechthoek zou worden weergegeven. Een regelterugloop/regelinvoerreeks (CR/LF) breekt ook de regel af. |
DT_WORD_ELLIPSIS | Kapt een woord af dat niet in de weergaverechthoek past en voegt een beletselteken toe. |