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

Статья
08/28/2023

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

Синтаксис

BOOL SetWindowTextA(
  [in]           HWND   hWnd,
  [in, optional] LPCSTR lpString
);

Параметры

[in] hWnd

Тип: HWND

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

[in, optional] lpString

Тип: LPCTSTR

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

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

Тип: BOOL

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

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

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

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

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

Примеры

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

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	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)