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

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

Параметры:

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

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

При успешном завершении, функция возвращает ненулевое значение.

При ошибке возвращается ноль. Для получения дополнительной информации об ошибке, вызовите GetLastError.

Замечания:

Функция SetWindowText отправляет сообщение WM_SETTEXT указанному окну или элементу управления. Если окно является элементом "список" (list box), созданным со стилем WS_CAPTION, то SetWindowText устанавливает текст для элемента управления, а не для элементов списка.

Функция SetWindowText не разворачивает символы табуляции (код ASCII 0x09). Символы табуляции отображаются как вертикальная черта ( | ).

Смотрите также: