DrawTextExA-Funktion (winuser.h)

Die DrawTextEx-Funktion zeichnet formatierten Text im angegebenen Rechteck.

Syntax

int DrawTextExA(
  [in]      HDC              hdc,
  [in, out] LPSTR            lpchText,
  [in]      int              cchText,
  [in, out] LPRECT           lprc,
  [in]      UINT             format,
  [in]      LPDRAWTEXTPARAMS lpdtp
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext, in dem gezeichnet werden soll.

[in, out] lpchText

Ein Zeiger auf die Zeichenfolge, die den zu zeichnenden Text enthält. Wenn der cchText-Parameter -1 ist, muss die Zeichenfolge null-terminated sein.

Wenn dwDTFormat DT_MODIFYSTRING enthält, kann die Funktion dieser Zeichenfolge bis zu vier zusätzliche Zeichen hinzufügen. Der Puffer, der die Zeichenfolge enthält, sollte groß genug sein, um diese zusätzlichen Zeichen aufzunehmen.

[in] cchText

Die Länge der Zeichenfolge , auf die lpchText verweist. Wenn cchText den Wert -1 aufweist, wird angenommen, dass der lpchText-Parameter ein Zeiger auf eine Zeichenfolge mit NULL-Beendigung ist, und DrawTextEx berechnet die Zeichenanzahl automatisch.

[in, out] lprc

Ein Zeiger auf eine RECT-Struktur , die das Rechteck in logischen Koordinaten enthält, in dem der Text formatiert werden soll.

[in] format

Die Formatierungsoptionen. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert Bedeutung
DT_BOTTOM
Rechtfertigt den Text am unteren Rand des Rechtecks. Dieser Wert wird nur mit dem wert DT_SINGLELINE verwendet.
DT_CALCRECT
Bestimmt die Breite und Höhe des Rechtecks. Wenn mehrere Textzeilen vorhanden sind, verwendet DrawTextEx die Breite des Rechtecks, auf das der lprc-Parameter verweist, und erweitert die Basis des Rechtecks, um die letzte Textzeile zu binden. Wenn nur eine Textzeile vorhanden ist, ändert DrawTextEx die rechte Seite des Rechtecks, sodass das letzte Zeichen in der Zeile gebunden wird. In beiden Fällen gibt DrawTextEx die Höhe des formatierten Texts zurück, zeichnet den Text jedoch nicht.
DT_CENTER
Zentriert Text horizontal im Rechteck.
DT_EDITCONTROL
Dupliziert die Textanzeigeeigenschaften eines mehrlineigen 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
Ersetzt bei angezeigtem Text das Ende einer Zeichenfolge durch Auslassungspunkte, sodass das Ergebnis in das angegebene Rechteck passt. Jedes Wort (nicht am Ende der Zeichenfolge), das über die Grenzen des Rechtecks hinausgeht, wird ohne Auslassungspunkte abgeschnitten. Die Zeichenfolge wird nur geändert, wenn das flag DT_MODIFYSTRING angegeben ist.

Vergleichen Sie mit DT_PATH_ELLIPSIS und DT_WORD_ELLIPSIS.

DT_EXPANDTABS
Erweitert Tabstoppzeichen. Die Standardanzahl von Zeichen pro Tabstopp beträgt acht.
DT_EXTERNALLEADING
Schließt die externe Schriftartgröße in die Zeilenhöhe ein. Normalerweise ist externes Führendes nicht in der Höhe einer Textzeile enthalten.
DT_HIDEPREFIX
Ignoriert das Präfixzeichen ampersand (&) im Text. Der folgende Buchstabe wird nicht unterstrichen, aber andere mnemonische Präfixzeichen werden weiterhin verarbeitet.

Beispiel:

Eingabezeichenfolge: "A&bc&&d"

normal: "Abc&d"

DT_HIDEPREFIX: "Abc&d"

Vergleichen Sie mit DT_NOPREFIX und DT_PREFIXONLY.

DT_INTERNAL
Berechnet mit der Systemschriftart die Textmetrik.
DT_LEFT
Richtet Text links aus.
DT_MODIFYSTRING
Ändert die angegebene Zeichenfolge so, dass sie mit dem angezeigten Text übereinstimmt. Dieser Wert hat keine Auswirkung, es sei denn, DT_END_ELLIPSIS oder DT_PATH_ELLIPSIS wird angegeben.
DT_NOCLIP
Zeichnet ohne Beschneidung. DrawTextEx ist etwas schneller, wenn DT_NOCLIP verwendet wird.
DT_NOFULLWIDTHCHARBREAK
Verhindert einen Zeilenumbruch an einem DBCS (double-wide character string), sodass die Zeilentrennungsregel SBCS-Zeichenfolgen entspricht. Dies kann beispielsweise in koreanischen Fenstern verwendet werden, um die Lesbarkeit von Symbolbezeichnungen zu verbessern. Dieser Wert hat keine Auswirkung, es sei denn, es wird DT_WORDBREAK angegeben.
DT_NOPREFIX
Deaktiviert die Verarbeitung von Präfixzeichen. Normalerweise interpretiert DrawTextEx das mnemonische Präfixzeichen amper und (&) als Direktive, um das folgende Zeichen zu unterstreichen, und die mnemonischen Präfixzeichen (&&) als Direktive zum Drucken eines einzelnen Ampersands. Durch Angabe DT_NOPREFIX wird diese Verarbeitung deaktiviert. Vergleich mit DT_HIDEPREFIX und DT_PREFIXONLY
DT_PATH_ELLIPSIS
Für angezeigten Text ersetzt Zeichen in der Mitte der Zeichenfolge durch Auslassungspunkte, sodass das Ergebnis in das angegebene Rechteck 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 flag DT_MODIFYSTRING angegeben ist.

Vergleichen Sie mit DT_END_ELLIPSIS und DT_WORD_ELLIPSIS.

DT_PREFIXONLY
Zeichnet nur eine Unterstreichung an der Position des Zeichens nach dem Präfixzeichen amper und (&). Zeichnet kein Zeichen in der Zeichenfolge.

Beispiel:

Eingabezeichenfolge: "A&bc&&d"

normal: "Abc&d"

PREFIXONLY: " _ "

Vergleichen Sie mit DT_NOPREFIX und DT_HIDEPREFIX.

DT_RIGHT
Richtet Text rechts aus.
DT_RTLREADING
Layout in Leserichtung von rechts nach links für bidirektionalen Text, wenn die im hdc ausgewählte Schriftart eine hebräische oder arabische Schriftart ist. Die Standardlesereihenfolge für den gesamten Text ist von links nach rechts.
DT_SINGLELINE
Zeigt Text nur in einer einzelnen Zeile an. Wagenrückläufe und Zeilenfeeds unterbrechen die Linie nicht.
DT_TABSTOP
Legt Tabstopps fest. Die DRAWTEXTPARAMS-Struktur , auf die der lpDTParams-Parameter verweist, gibt die Anzahl der durchschnittlichen Zeichenbreiten pro Tabstopp an.
DT_TOP
Rechtfertigt den Text am oberen Rand des Rechtecks.
DT_VCENTER
Zentriert Text vertikal. Dieser Wert wird nur mit dem wert DT_SINGLELINE verwendet.
DT_WORDBREAK
Unterbricht Wörter. Zeilen werden automatisch zwischen Wörtern unterbrochen, wenn sich ein Wort über den Rand des durch den lprc-Parameter angegebenen Rechtecks erstreckt. Eine Wagenrücklaufvorschubsequenz unterbricht auch die Linie.
DT_WORD_ELLIPSIS
Schneidet jedes Wort ab, das nicht in das Rechteck passt, und fügt Auslassungspunkte hinzu.

Vergleichen Sie mit DT_END_ELLIPSIS und DT_PATH_ELLIPSIS.

[in] lpdtp

Ein Zeiger auf eine DRAWTEXTPARAMS-Struktur , die zusätzliche Formatierungsoptionen angibt. Dieser Parameter kann NULL sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Texthöhe in logischen Einheiten. Wenn DT_VCENTER oder DT_BOTTOM angegeben wird, ist der Rückgabewert der Offset von lprc->top zum Unteren Rand des gezeichneten Texts.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Die DrawTextEx-Funktion unterstützt nur Schriftarten, deren Escape und Ausrichtung jeweils null sind.

Der Textausrichtungsmodus für den Gerätekontext muss die Flags TA_LEFT, TA_TOP und TA_NOUPDATECP enthalten.

Hinweis

Der winuser.h-Header definiert DrawTextEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (einschließlich Windows.h)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-misc-l1-2-0 (eingeführt in Windows 8.1)

Weitere Informationen

DRAWTEXTPARAMS

Drawtext

Schriftart- und Textfunktionen

Übersicht über Schriftarten und Text