Функция SetWindowTextW (winuser.h)

Статья
03/11/2023

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

Синтаксис

BOOL SetWindowTextW(
  [in]           HWND    hWnd,
  [in, optional] LPCWSTR lpString
);

Параметры

[in] hWnd

Тип: HWND

Дескриптор окна или элемента управления, текст которого требуется изменить.

[in, optional] lpString

Тип: LPCWSTR

Новый текст заголовка или элемента управления.

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

Тип: BOOL

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

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

Если целевое окно принадлежит текущему процессу, SetWindowText приводит к отправке сообщения WM_SETTEXT в указанное окно или элемент управления. Если элемент управления является элементом управления "Список", созданным в стиле WS_CAPTION , setWindowText задает текст для элемента управления, а не для записей в списке.

Чтобы задать текст элемента управления в другом процессе, отправьте сообщение WM_SETTEXT напрямую вместо вызова SetWindowText.

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

Примеры

Пример см. в разделе Отправка сообщения.

Примечание

Заголовок winuser.h определяет SetWindowText в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-window-l1-1-3 (представлено в Windows 10 версии 10.0.10240)