Delen via


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.