Поделиться через

сообщение SB_GETTEXT

  • Статья

Извлекает текст из указанной части окна состояния.

Параметры

wParam

Отсчитываемый от нуля индекс части, из которой извлекается текст.

lParam

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

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

Возвращает 32-разрядное значение, состоящее из двух 16-разрядных значений. Слово low указывает длину текста в символах. Высокое слово указывает тип операции, используемой для рисования текста. Тип может иметь одно из следующих значений.

Код возврата Описание
0
 Текст рисуется с границей, чтобы показаться ниже плоскости окна.
SBT_NOBORDERS
 Текст рисуется без границ.
SBT_POPOUT
 Текст рисуется с рамкой, отображаемой выше плоскости окна.
SBT_RTLREADING
 Текст отображается в направлении, противоположном тексту в родительском окне.

Комментарии

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

Это сообщение возвращает не более 65 535 символов. Если текстовая строка длиннее, она усекается.

Если текст имеет тип рисования SBT_OWNERDRAW, это сообщение возвращает 32-битовое значение, связанное с текстом, а не длину и тип операции.

Обычные окна отображают текст слева направо (LTR). Windows можно зеркально отображать на таких языках, как иврит или арабский язык, которые читают справа налево (RTL). Если задано SBT_RTLREADING, строка lParam считывается в направлении, противоположном тексту в родительском окне.

Требования

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

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

SB_SETTEXT