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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] hDlg

Тип: HWND

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

[in] nIDDlgItem

Тип: int

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

[in] lpString

Тип: LPCTSTR

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

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

Тип: BOOL

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

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

Замечания

Функция SetDlgItemText отправляет WM_SETTEXT сообщение указанному элементу управления.

Примеры

Пример см. в разделе Using List Boxes.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll
набор API	ext-ms-win-ntuser-dialogbox-l1-1-0 (представлено в Windows 8)