Formatieren von Werten
In diesem Abschnitt werden die Werte aufgeführt, die mit dem dwTextFlags Parameter der funktionen DrawThemeText und GetThemeTextExtent verwendet werden. Ein oder mehrere dieser Werte werden verwendet, um anzugeben, wie eine Textzeichenfolge formatiert werden soll. Die DrawThemeText--Funktion zeichnet die Textzeichenfolge in einem Anzeigerechteck, das durch den pRect-Parameter angegeben wird. Die GetThemeTextExtent--Funktion kann verwendet werden, um das erforderliche umgebende Rechteck für Text einer bestimmten Länge und eines bestimmten Formats zu bestimmen.
Formatieren von Werten
In der folgenden Tabelle sind die Formatwerte aufgeführt.
| Wert | Beschreibung |
|---|---|
| DT_BOTTOM | Rendert die Textzeichenfolge am unteren Rand des Anzeigerechtecks. Dieser Wert wird nur mit dem wert DT_SINGLELINE verwendet. |
| DT_CALCRECT | Bestimmt die Breite und Höhe des Anzeigerechtecks. |
| DT_CENTER | Zentriert Text horizontal im Anzeigerechteck. |
| DT_EDITCONTROL | Dupliziert die Textanzeigemerkmale eines mehrzeilen Bearbeitungssteuerelements. Insbesondere wird die durchschnittliche Zeichenbreite auf die gleiche Weise wie für ein Bearbeitungssteuerelement berechnet, und die Funktion zeigt keine teilweise sichtbare letzte Zeile an. |
| DT_END_ELLIPSIS | Schneidet eine Textzeichenfolge ab, die breiter als das Anzeigerechteck ist, und fügt eine Auslassungspunkte hinzu, um die Abkürzung anzugeben. Die Zeichenfolge wird nur geändert, wenn das DT_MODIFYSTRING Flag angegeben ist. |
| DT_EXPANDTABS | Erweitert Tabstoppzeichen. Die Standardanzahl von Zeichen pro Registerkarte beträgt acht. Die werte DT_WORD_ELLIPSIS, DT_PATH_ELLIPSIS und DT_END_ELLIPSIS können nicht mit dem DT_EXPANDTABS wert verwendet werden. |
| DT_EXTERNALLEADING | Enthält den externen Vorzeichen einer Schriftart in der Zeilenhöhe. Normalerweise ist externe Vorleitung nicht in der Höhe einer Textzeile enthalten. |
| DT_HIDEPREFIX | Ignoriert das Präfixzeichen & im Text. Der folgende Buchstabe ist nicht unterstrichen, aber andere Präfixzeichen werden weiterhin verarbeitet. Zum Beispiel: Eingabezeichenfolge: "A&bc&&d" normal: "Abc&d" DT_HIDEPREFIX: "Abc&d" |
| DT_LEFT | Richtet Text links aus. |
| DT_MODIFYSTRING | Ändert eine Zeichenfolge so, dass sie dem angezeigten Text entspricht. Dieser Wert hat keine Auswirkung, es sei denn, DT_END_ELLIPSIS oder DT_PATH_ELLIPSIS wird angegeben. |
| DT_NOCLIP | Zeichnet die Textzeichenfolge, ohne das Anzeigerechteck zu beschneiden. |
| DT_NOFULLWIDTHCHARBREAK | Verhindert einen Zeilenumbruch bei einem Double-Byte-Zeichensatz (DBCS), sodass die Zeilenumbruchregel dem Single-Byte-Zeichensatz (SBCS) entspricht. Dies kann beispielsweise verwendet werden, um Symbolbeschriftungen in koreanischen Text lesbarer zu gestalten. Dieser Wert hat keine Auswirkung, es sei denn, DT_WORDBREAK wird angegeben. |
| DT_NOPREFIX | Deaktiviert die Verarbeitung von Präfixzeichen. Normalerweise interpretiert DrawThemeText das Präfixzeichen & als Direktive, um das folgende Zeichen zu unterstreichen, und die Präfixzeichen && als Direktive zum Drucken eines einzelnen &. Durch Angabe DT_NOPREFIX wird diese Verarbeitung deaktiviert. Zum Beispiel: Eingabezeichenfolge: "A&bc&&d" normal: "Abc&d" DT_NOPREFIX: "A&bc&&d" |
| DT_PATH_ELLIPSIS | Ersetzt Zeichen in der Mitte des Texts durch eine Auslassungspunkte, sodass das Ergebnis in das Anzeigerechteck passt. Wenn die Zeichenfolge umgekehrte Schrägstriche (\) enthält, behält DT_PATH_ELLIPSIS den Text nach dem letzten umgekehrten Schrägstrich so weit wie möglich bei. Die Zeichenfolge wird nur geändert, wenn das DT_MODIFYSTRING Flag angegeben ist. |
| DT_PREFIXONLY | Zeichnet nur eine Unterstreichung an der Position des Zeichens nach dem Präfixzeichen &. Normalerweise interpretiert DrawThemeText die & als Direktive, um das folgende Zeichen und die Präfixzeichen && als Direktive zu unterstreichen, um eine einzelne &zu drucken. Durch Angabe DT_PREFIXONLY werden keine Zeichen gezeichnet, nur eine Unterstreichung. Leerzeichen werden an den Positionen platziert, an denen Zeichen normalerweise angezeigt werden. Zum Beispiel: Eingabezeichenfolge: "A&bc&&d" normal: "Abc&d DT_PREFIXONLY: " " |
| DT_RIGHT | Richtet Text rechts aus. |
| DT_RTLREADING | Legt Text in rechts-nach-links-Reihenfolge für bidirektionalen Text fest, z. B. Text in einer hebräischen oder arabischen Schriftart. Die Standardrichtung für Text ist von links nach rechts. |
| DT_SINGLELINE | Zeigt Text in einer einzelnen Zeile an. Wagenrücklauf und Zeilenfeeds unterbrechen die Linie nicht. |
| DT_TABSTOP | Legt Tabstopps fest. |
| DT_TOP | Rendert den Text oben im Anzeigerechteck. |
| DT_VCENTER | Zentrierung von Text vertikal. Dieser Wert wird nur mit dem wert DT_SINGLELINE verwendet. |
| DT_WORDBREAK | Umbricht Zeilen zwischen Wörtern, wenn ein Wort über den Rand des Anzeigerechtecks hinausgeht. Eine Wagenrücklauf-/Zeilenvorschubsequenz (CR/LF) bricht auch die Linie. |
| DT_WORD_ELLIPSIS | Schneidet alle Wörter ab, die nicht in das Anzeigerechteck passen, und fügt eine Auslassungspunkte hinzu. |