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

сообщение SB_SETTEXT

  • Статья

Задает текст в указанной части окна состояния.

Параметры

wParam

LoBYTE слова с низким порядком задает отсчитываемый от нуля индекс заданной части. Если для LOBYTE задано значение SB_SIMPLEID, то предполагается, что окно состояния является простой строкой состояния, то есть строкой состояния с одной частью.

HIBYTE слова с низким порядком указывает тип операции рисования. Этот параметр может принимать одно из указанных ниже значений.

Слово с высоким порядком wParam игнорируется.

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

lParam

Указатель на строку, завершающуюся значением NULL, которая задает заданный текст. Если wParam SBT_OWNERDRAW, этот параметр представляет 32 бита данных. Родительское окно должно интерпретировать данные и рисовать текст при получении сообщения WM_DRAWITEM.

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

Возвращает значение TRUE в случае успешного выполнения или FALSE в противном случае.

Замечания

Сообщение отменяет часть окна, которая изменилась, что приводит к отображению нового текста при следующем получении сообщения WM_PAINT.

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

Requirements

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

См. также

SB_GETTEXT