SB_SETTEXT-Nachricht

Legt den Text im angegebenen Teil eines Statusfensters fest.

Parameter

wParam

LOBYTE des niederwertigen Worts gibt den nullbasierten Index des festzulegenden Teils an. Wenn LOBYTE auf SB_SIMPLEID festgelegt ist, wird davon ausgegangen, dass es sich bei dem Statusfenster um eine Statusleiste im einfachen Modus handelt, d. h. eine Statusleiste mit nur einem Teil.

HIBYTE des niederwertigen Worts gibt den Typ des Zeichnungsvorgangs an. Dieser Parameter kann einen der folgenden Werte annehmen.

Das höherwertige Wort von wParam wird ignoriert.

Wert	Bedeutung
0	Der Text wird mit einem Rahmen gezeichnet, der niedriger als die Fläche des Fensters angezeigt wird.
SBT_NOBORDERS	Der Text wird ohne Rahmen gezeichnet.
SBT_OWNERDRAW	Der Text wird vom übergeordneten Fenster gezeichnet. Hinweis: Eine Statusleiste im einfachen Modus unterstützt keine Besitzerzeichnung.
SBT_POPOUT	Der Text wird mit einem Rahmen gezeichnet, der höher als die Fläche des Fensters angezeigt wird.
SBT_RTLREADING	Der Text wird in umgekehrter Richtung zum Text im übergeordneten Fenster angezeigt.
SBT_NOTABPARSING	Tabulatorzeichen werden ignoriert.

lParam

Zeiger auf eine Null-terminierte Zeichenfolge, die den festzulegenden Text angibt. Wenn wParam SBT_OWNERDRAW ist, stellt dieser Parameter 32 Bit Daten dar. Das übergeordnete Fenster muss die Daten interpretieren und den Text zeichnen, wenn es die WM_DRAWITEM-Nachricht empfängt.

Rückgabewert

Gibt TRUE zurück, wenn dies erfolgreich war, oder andernfalls FALSE.

Hinweise

Die Nachricht erklärt den geänderten Teil des Fensters für ungültig, wodurch der neue Text angezeigt wird, wenn das Fenster als Nächstes die WM_PAINT-Nachricht empfängt.

Normale Fenster zeigen Text von links nach rechts (LTR) an. Fenster können gespiegelt werden, um Sprachen wie Hebräisch oder Arabisch anzuzeigen, die von rechts nach links (RTL) gelesen werden. Wenn SBT_RTLREADING festgelegt ist, wird die lParam-Zeichenfolge in umgekehrter Richtung zum Text im übergeordneten Fenster gelesen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Commctrl.h
Unicode- und ANSI-Namen	SB_SETTEXTW (Unicode) und SB_SETTEXTA (ANSI)

Siehe auch

SB_GETTEXT