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

Статья
08/28/2023

Задает заголовок или текст элемента управления в диалоговом окне.

Синтаксис

BOOL SetDlgItemTextA(
  [in] HWND   hDlg,
  [in] int    nIDDlgItem,
  [in] LPCSTR lpString
);

Параметры

[in] hDlg

Тип: HWND

Дескриптор диалогового окна, содержащего элемент управления .

[in] nIDDlgItem

Тип: int

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

[in] lpString

Тип: LPCTSTR

Текст, копируемый в элемент управления .

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

Тип: BOOL

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

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

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

Требования


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