Win32 API. Функции окна - Функция 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
Unicode WinNT
Замечания по платформе Не имеется