Функция GetDlgItemText извлекает заголовок или текст, связанный с органом управления в диалоговом окне.
Синтаксис
UINT GetDlgItemText( HWND hDlg, int nIDDlgItem, LPTSTR lpString, int nMaxCount ); |
Параметры
hDlg
[in] Дескриптор диалогового окна, которое содержит орган управления.nIDDlgItem
[in] Устанавливает идентификатор органа управления, заголовок или текст которого должен извлечься.lpString
[out] Указатель на буфер, который получает заголовок или текст.nMaxCount
[in] Устанавливает максимальную длину, в TCHARs (в символах), копируемой в буфер строки, на который указывает параметр lpString. Если длина строки включает в себя символ ПУСТО (NULL), нарушается ограничение и символьная строка обрезается.Возвращаемое значение
Если функция завершается успешно, возвращаемое значение устанавливает число TCHARs (символов), скопированных в буфер, не включая символ завершения строки ('0').
Если функция завершается ошибкой, возвращаемое значение равняется нулю. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Если символьная строка очень длинная или она длиннее, чем буфер, то буфер будет содержать обрезанную строку с символом завершения строки ('0').
Функция GetDlgItemText отправляет сообщение WM_GETTEXT органу управления.
Для функции версии ANSI, число TCHARs - число байтов; для версии Unicode, это - число символов.
Windows 95/98/Me: GetDlgItemTextW поддерживается программой Microsoft Layer for Unicode. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.
Пример
Пример, см. в статье Создание модального диалогового окна.
Смотри также
Обзор Диалоговые окна, Функции, используемые диалоговыми окнами, GetDlgItemInt, SetDlgItemInt, SetDlgItemText, WM_GETTEXT
|
Размещение и совместимость GetDlgItemText |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |