SB _ SETTEXT-Nachricht

Legt den Text im angegebenen Teil eines Statusfensters fest.

Parameter

wParam

Der LOBYTE-Wert des niedrig geordneten Worts gibt den nullbasierten Index des zu setzenden 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.> eine Statusleiste mit nur _ einem Teil.

Der HIBYTE-Wert des niedrig geordneten Worts gibt den Typ des Zeichnungsvorgang an. Dieser Parameter kann einen der folgenden Werte annehmen.

Das obere Wort von wParam wird ignoriert.

Wert Bedeutung
0
Der Text wird mit einem Rahmen gezeichnet, der unter der Ebene des Fensters angezeigt wird.
SBT_NOBORDERS
Der Text wird ohne Rahmen gezeichnet.
SBT_OWNERDRAW
Der Text wird vom übergeordneten Fenster gezeichnet.
[!Note]
Eine Statusleiste im einfachen Modus unterstützt keine Besitzerzeichnung.

SBT_POPOUT
Der Text wird mit einem Rahmen gezeichnet, der höher als die Ebene des Fensters angezeigt wird.
SBT_RTLREADING
Der Text wird in der entgegengesetzten Richtung zum Text im übergeordneten Fenster angezeigt.
SBT_NOTABPARSING
Tabstoppzeichen werden ignoriert.

lParam

Zeiger auf eine auf NULL beendete Zeichenfolge, die den festgelegten Text angibt. Wenn wParam SBT _ OWNERDRAW ist, stellt dieser Parameter 32 Datenbits 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 erfolgreich, andernfalls FALSE.

Bemerkungen

Die Meldung macht den geänderten Teil des Fensters ungültig, sodass 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. Windows kann gespiegelt werden, um Sprachen wie Hebräisch oder Arabisch anzuzeigen, die von rechts nach links (RTL) lesen. Wenn SBT RTLREADING festgelegt ist, liest die _ lParam-Zeichenfolge in umgekehrter Richtung aus dem Text im übergeordneten Fenster.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur [ Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Commctrl.h
Unicode- und ANSI-Name
SB _ SETTEXTW (Unicode) und SB _ SETTEXTA (ANSI)

Weitere Informationen

SB _ GETTEXT