сообщение TB_GETBUTTONTEXT

Извлекает отображаемый текст кнопки на панели инструментов.

Параметры

wParam

Идентификатор команды кнопки, текст которой требуется извлечь.

lParam

Указатель на буфер, получающий текст кнопки.

Возвращаемое значение

Возвращает длину (в символах) строки, на которую указывает lParam. Длина не включает завершающий символ NULL. В случае неудачи возвращается значение -1.

Комментарии

Предупреждение системы безопасности: Неправильное использование этого сообщения может поставить под угрозу безопасность программы. Это сообщение не позволяет узнать размер буфера. Если вы используете это сообщение, сначала вызовите сообщение, передавающее значение NULL в lParam, при этом возвращается количество символов, за исключением обязательных значений NULL . Затем вызовите сообщение во второй раз, чтобы получить строку. Прежде чем продолжить, ознакомьтесь с разделом Вопросы безопасности: Элементы управления Microsoft Windows .

Возвращаемая строка соответствует тексту, который в данный момент отображается кнопкой.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Заголовок	Commctrl.h
Имя в кодировке Юникод и ANSI	TB_GETBUTTONTEXTW (Юникод) и TB_GETBUTTONTEXTA (ANSI)

См. также раздел

Справочные материалы

TB_GETBUTTONINFO

TB_GETSTRING

TB_SETBUTTONINFO