DrawStatusTextW-Funktion (commctrl.h)

Artikel
02/28/2024

Die DrawStatusText-Funktion zeichnet den angegebenen Text im Stil eines status Fensters mit Rahmen.

Syntax

void DrawStatusTextW(
  HDC     hDC,
  LPCRECT lprc,
  LPCWSTR pszText,
  UINT    uFlags
);

Parameter

hDC

Typ: HDC

Handle für den Anzeigekontext für das Fenster.

lprc

Typ: LPCRECT

Zeiger auf eine RECT-Struktur , die die Position des Rechtecks in Clientkoordinaten enthält, in dem der Text gezeichnet wird. Die Funktion zeichnet die Rahmen nur innerhalb der Ränder des angegebenen Rechtecks.

pszText

Typ: LPCTSTR

Zeiger auf eine NULL-endende Zeichenfolge, die den anzuzeigenden Text angibt. Tabulatorzeichen in der Zeichenfolge bestimmen, ob die Zeichenfolge linksbündig, rechtsbündig oder zentriert ist.

uFlags

Typ: UINT

Textzeichnungsflags. Dieser Parameter kann eine Kombination dieser Werte sein:

Wert	Bedeutung
SBT_NOBORDERS	Verhindert, dass Rahmen um den angegebenen Text gezogen werden.
SBT_POPOUT	Zeichnet hervorgehobene Rahmen, die den Text hervorheben.
SBT_RTLREADING	Gibt an, dass die Zeichenfolge, auf die von pszText verwiesen wird, in der entgegengesetzten Richtung zum Text im übergeordneten Fenster angezeigt wird.

Rückgabewert

Keine

Bemerkungen

Normale Fenster zeigen Text von links nach rechts (LTR) an. Fenster können in Anzeigesprachen wie Hebräisch oder Arabisch gespiegelt werden, die von rechts nach links (RTL) gelesen werden. Normalerweise wird die pszText-Zeichenfolge in derselben Richtung wie der Text im übergeordneten Fenster angezeigt. Wenn SBT_RTLREADING festgelegt ist, liest sich die pszText-Zeichenfolge in entgegengesetzter Richtung vom Text im übergeordneten Fenster.

Hinweis

Der Commctrl.h-Header definiert DrawStatusText 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 Code, der nicht Codierungsneutral ist, 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 Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commctrl.h
Bibliothek	Comctl32.lib
DLL	Comctl32.dll

Share via