SB_SETTEXT-Nachricht

  • Artikel

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