SB_GETTEXT Nachricht

Ruft den Text aus dem angegebenen Teil eines status-Fensters ab.

Parameter

wParam

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

lParam

Zeiger auf den Puffer, der den Text als null-endende Zeichenfolge empfängt. Verwenden Sie die SB_GETTEXTLENGTH Meldung, um die erforderliche Größe des Puffers zu bestimmen.

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_POPOUT	Der Text wird mit einem Rahmen gezeichnet, der höher als die Ebene des Fensters angezeigt wird.
SBT_RTLREADING	Der Text wird in entgegengesetzter Richtung des Texts im übergeordneten Fenster angezeigt.

Bemerkungen

Sicherheitswarnung: Wenn Sie diese Nachricht falsch verwenden, kann die Sicherheit Ihres Programms beeinträchtigt werden. Diese Meldung bietet ihnen keine Möglichkeit, die Größe des Puffers zu kennen. Wenn Sie diese Nachricht verwenden, rufen Sie zuerst SB_GETTEXTLENGTH auf, um die erforderliche Anzahl von Zeichen abzurufen, und rufen Sie dann die Nachricht auf, um die Zeichenfolge abzurufen. Wenn Sie warten, bevor Sie SB_GETTEXT aufrufen, kann sich der Text ändern, wodurch der Rückgabewert von SB_GETTEXTLENGTH ungültig wird. Lesen Sie die Sicherheitsüberlegungen: Microsoft Windows-Steuerelemente , bevor Sie fortfahren.

Diese Nachricht gibt maximal 65.535 Zeichen zurück. Wenn die Textzeichenfolge länger ist, wird sie abgeschnitten.

Wenn der Text über den SBT_OWNERDRAW Zeichnungstyp verfügt, gibt diese Meldung den 32-Bit-Wert zurück, der dem Text zugeordnet ist, anstelle der Länge und des Vorgangstyps.

Normale Fenster zeigen Text von links nach rechts (LTR) an. Fenster können in Anzeigesprachen wie Hebräisch oder Arabisch gespiegelt werden, die von rechts nach links (RTL) gelesen werden. Wenn SBT_RTLREADING festgelegt ist, liest sich die lParam-Zeichenfolge in entgegengesetzter Richtung vom Text im übergeordneten Fenster.

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_GETTEXTW (Unicode) und SB_GETTEXTA (ANSI)

Siehe auch

SB_SETTEXT