Функция SetWindowText

Функция SetWindowText изменяет текст заголовка заданного окна (если таковой имеется). Если определяемое окно - орган управления, то изменяется его текст. Однако SetWindowText не может изменить текст органа управления в другом приложении.

Синтаксис

BOOL SetWindowText(

HWND 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки
Перевод 17.11.2000 08:58 ©Copyright V. Sokovikov
Hosted by uCoz