DrawStatusTextA-Funktion (commctrl.h)

Artikel
02/26/2024

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

Syntax

void DrawStatusTextA(
  HDC     hDC,
  LPCRECT lprc,
  LPCSTR  pszText,
  UINT    uFlags
);

Parameter

hDC

Typ: HDC

Handle mit dem 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 direkt innerhalb der Kanten des angegebenen Rechtecks.

pszText

Typ: LPCTSTR

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

uFlags

Typ: UINT

Textzeichnungsflags. Dieser Parameter kann eine Kombination aus diesen Werten sein:

Wert	Bedeutung
SBT_NOBORDERS	Verhindert, dass Rahmen um den angegebenen Text herum gezeichnet werden.
SBT_POPOUT	Zeichnet hervorgehobene Rahmen, die den Text hervorhebt.
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. Windows kann gespiegelt werden, um Sprachen wie Hebräisch oder Arabisch anzuzeigen, 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, wird die pszText-Zeichenfolge in die entgegengesetzte Richtung vom Text im übergeordneten Fenster gelesen.

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 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 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