TB_GETBUTTONTEXT訊息

擷取工具列上按鈕的顯示文字。

參數

wParam

要擷取其文字之按鈕的命令識別碼。

lParam

接收按鈕文字之緩衝區的指標。

傳回值

傳回 lParam所指向字串的長度，以字元為單位。 長度不包含終止的 Null 字元。 如果失敗，則傳回值為 -1。

備註

安全性警告： 使用此訊息不正確可能會危害程式的安全性。 此訊息不會提供一種方式讓您知道緩衝區的大小。 如果您使用此訊息，請先呼叫在lParam中傳遞Null的訊息，這會傳回字元數，但不包括必要的Null。 然後再次呼叫訊息以擷取字串。 您應該先檢閱 安全性考慮：Microsoft Windows 控制項 ，再繼續進行。

傳回的字串會對應至按鈕目前顯示的文字。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	Commctrl.h
Unicode 與 ANSI 名稱	TB_GETBUTTONTEXTW (Unicode ) 和 anSI TB_GETBUTTONTEXTA (ANSI)

另請參閱

參考

TB_GETBUTTONINFO

TB_GETSTRING

TB_SETBUTTONINFO