Функция
SetWindowTextФункция
SetWindowText изменяет текст заголовка заданного окна (если таковой имеется). Если определяемое окно - орган управления, то изменяется его текст. Однако SetWindowText не может изменить текст органа управления в другом приложении.Синтаксис
hWnd, // дескриптор окна или элемента управления LPCTSTR lpString // адрес строчки ); |
Параметры
hWnd
[in] Дескриптор окна или органа управления, текст которого должен быть изменен.
lpString
[in] Указатель на строку с нулевым символом в конце, которую нужно использовать как новый заголовок или текст органа управления.
Возвращаемые значения
Если функция завершилась успешно, возвращается значение не нуль.
Если функция потерпела неудачу, возвращаемое значение - нуль. Чтобы получить расширенную информацию об ошибке, вызовите
GetLastError.Замечания
Если намеченное окно принадлежит текущему процессу, функция
SetWindowText вызывает сообщение WM_SETTEXT, которое будет отправлено в заданное окно или орган управления. Если орган управления является окном со списком, созданным в стиле WS_CAPTION, то, не смотря на это, SetWindowText устанавливает текст для органа управления, а не для ввода в поле окна со списком.Чтобы установить текст органа управления в другом процессе, отправьте сообщение
WM_SETTEXT непосредственно вместо вызова функции SetWindowText.Функция
SetWindowText не увеличивает размер символов табуляции (код ASCII 0x09). Символы табуляции отображаются как символы вертикальной черты (|).Windows 98/Me функция
SetWindowTextW поддерживается Microsoft ® Layer for Unicode (MSLU). Чтобы использовать его, Вы должны добавить некоторые файлы к вашему приложению, как изложено в MSLU для системы Windows 95/98/Me.Пример
Пример смотри в статье
Отправка сообщений.Смотри также
Краткий обзор Окна, GetWindowText, WM_SETTEXT
Размещение и совместимость SetWindowText |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Да |
Используемая библиотека |
User32.lib |
Заголовочный файл |
|
- объявлено в |
Winuser.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |