Win32 API. Функции окна
Страница 55. Функция SetWindowText


Функция SetWindowText

(УстановитьТекстовоеОкно)

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

Синтаксис

BOOL SetWindowText
(
HWND hWnd,// дескриптор окна или элемента управления
LPCTSTR lpString // адрес строчки
);

Параметры
hWnd
Идентифицирует окно или элемента управления, чей текст должен быть изменен.
lpString
Указывает на строку с нулевым символом в конце, которую нужно использовать как новый заголовок или текст элемента управления.

Возвращаемые значения
Если функция завершилась успешно, возвращается значение отличное от нуля. Если функция потерпела неудачу, возвращаемое значение - ноль. Чтобы получить расширенную информацию об ошибке, вызовите GetLastError.

Замечания
Функция SetWindowText вызывает сообщение WM_SETTEXT, которое будет послано определяемому окну или элементу управления. Если окно - элемент управления окна со списком, созданное в стиле WS_CAPTION, то, не смотря на это, SetWindowText устанавливает текст для элемента управления, а не для ввода в окно списка. Функция SetWindowText не увеличивает размер символов табуляции (код ASCII 0x09). Символы табуляции отображаются как символы вертикальной черты (|).

Смотри также
GetWindowText, WM_SETTEXT

Размещение и совместимость SetWindowText

Windows NTДа 
Win95Да
Win32sДа
Импортируемая библиотекаuser32.lib
Заголовочный файлwinuser.h
UnicodeWinNT
Замечания по платформеНе имеется

 
« Предыдущая статья   Следующая статья »