SB_GETTEXTLENGTH Nachricht

  • Artikel

Ruft die Länge des Texts in Zeichen aus dem angegebenen Teil eines status-Fensters ab.

Parameter

wParam

Nullbasierter Index des Teils, aus dem Text abgerufen werden soll.

lParam

Muss Null sein.

Rückgabewert

Gibt einen 32-Bit-Wert zurück, der aus zwei 16-Bit-Werten besteht. Das niedrige Wort gibt die Länge des Texts in Zeichen an. Das hohe Wort gibt den Typ des Vorgangs an, der zum Zeichnen des Texts verwendet wird. Der Typ kann einer der folgenden Werte sein:

Rückgabecode Beschreibung
0
 Der Text wird mit einem Rahmen gezeichnet, der niedriger als die Ebene des Fensters angezeigt wird.
SBT_NOBORDERS
 Der Text wird ohne Rahmen gezeichnet.
SBT_OWNERDRAW
 Der Text wird vom übergeordneten Fenster gezeichnet.
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.

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. Wenn SBT_RTLREADING festgelegt ist, wird der angegebene status Fenstertext in die entgegengesetzte Richtung vom Text im übergeordneten Fenster gelesen.

Diese Nachricht gibt eine maximale Zeichenfolgenlänge von 65.535 Zeichen zurück. Wenn die tatsächliche Textzeichenfolge länger ist, wird sie von der SB_GETTEXT-Nachricht abgeschnitten.

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-Name
 SB_GETTEXTLENGTHW (Unicode) und SB_GETTEXTLENGTHA (ANSI)