Функция SetDlgItemTextA (winuser.h)
Задает заголовок или текст элемента управления в диалоговом окне.
Синтаксис
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 сообщение указанному элементу управления.
Примеры
Пример см. в разделе Использование списков.
Примечание
Заголовок 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) |
См. также раздел
Основные понятия
Справочные материалы