DrawStatusTextA-Funktion (commctrl.h)

Artikel
11/18/2024

Die DrawStatusText--Funktion zeichnet den angegebenen Text im Format eines Statusfensters mit Rahmen.

Syntax

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

Parameter

hDC

Typ: HDC-

Behandeln Sie den Anzeigekontext für das Fenster.

lprc

Typ: LPCRECT-

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

pszText

Typ: LPCTSTR-

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den anzuzeigenden Text angibt. Tabstoppzeichen in der Zeichenfolge bestimmen, ob die Zeichenfolge linksbündig, rechtsbündig oder zentriert ist.

uFlags

Typ: UINT-

Kennzeichnungen für Textzeichnungen. Dieser Parameter kann eine Kombination dieser Werte sein:

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

Rückgabewert

Nichts

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 der gleichen Richtung wie der Text im übergeordneten Fenster angezeigt. Wenn SBT_RTLREADING festgelegt ist, liest die pszText- Zeichenfolge in entgegengesetzter Richtung aus dem Text im übergeordneten Fenster.

Anmerkung

Der commctrl.h-Header definiert DrawStatusText als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commctrl.h
Library	Comctl32.lib
DLL-	Comctl32.dll

Freigeben über