Функция GetDlgItemInt преобразует текст заданного органа управления в диалоговом окне в целочисленное значение.
Синтаксис
UINT GetDlgItemInt( HWND hDlg, int nIDDlgItem, BOOL* lpTranslated, BOOL bSigned ); |
Параметры
hDlg
[in] Дескриптор диалогового окна, который содержит интересующий орган управления.nIDDlgItem
[in] Устанавливает идентификатор органа управления, текст которого должен быть преобразован.lpTranslated
[out] Указатель на переменную, которая получает значение успешного завершения или значение сбоя (успешное завершение обозначается - ИСТИНА (TRUE), сбой обозначается как ЛОЖЬ (FALSE)).Если этот параметр - ПУСТО (NULL), функция не возвращает информацию об успехе или сбое.
bSigned
[in] Устанавливает, должна ли функция вначале проверять текст на знак минус и возвратить значение целого числа со знаком, если она находит этот минус (значение ИСТИНА (TRUE) устанавливает, что это должно быть сделано, ЛОЖЬ (FALSE), - что не должно).Возвращаемое значение
Если функция завершается успешно, переменная, на которую указывает lpTranslated устанавливается в значение ИСТИНА (TRUE), а возвращаемое значение - преобразованное значение текста органа управления.
Если функция завершается ошибкой, переменная, на которую указывает параметр lpTranslated устанавливается в ЛОЖЬ (FALSE), а возвращаемое значение равняется нулю.
| Обратите внимание! на то, что поскольку нуль - возможное переведенное значение, возвращение нуля, не указывает на сбой. |
Если lpTranslated равняется ПУСТО (NULL), функцией не возвращается информация об успехе или сбое.
| Обратите внимание! на то, что если параметр bSigned - ИСТИНА (TRUE) и в начале текста имеется - знак минус (-), GetDlgItemInt преобразует текст в значение целого числа со знаком. В противном случае функция создает целочисленное значение без знака. Чтобы получать надлежащее значение в этой ситуации, приведите возвращаемое значение к типу int. |
Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Функция GetDlgItemInt извлекает текст заданного органа управления, посылая управляющее сообщение WM_GETTEXT. Функция преобразует извлеченный текст, исключая любые дополнительные пробелы в начале текста и затем преобразовывая десятичные цифры. Функция прекращает переводить, когда она достигает конца текста или сталкивается с нечисловым символом.
Функция GetDlgItemInt возвращает нуль, если переведенное значение больше чем INT_MAX (для чисел со знаком) или UINT_MAX (для чисел без знака).
Пример
Пример, см. в статье Создание немодального диалогового окна.
Смотри также
Обзор Диалоговые окна, Функции, используемые диалоговыми окнами, GetDlgCtrlID, GetDlgItem, GetDlgItemText , SetDlgItemInt
|
Размещение и совместимость GetDlgItemInt |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |