Функция GetDlgItemInt

Функция GetDlgItemInt преобразует текст заданного органа управления в диалоговом окне в целочисленное значение.

Синтаксис

UINT GetDlgItemInt(
    HWND hDlg,
    int nIDDlgItem,
    BOOLlpTranslated,
    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 (для чисел без знака).

Пример

Пример, см. в статье Создание немодального диалогового окна.

Смотри также 

Обзор Диалоговые окнаФункции, используемые диалоговыми окнами, GetDlgCtrlIDGetDlgItemGetDlgItemTextSetDlgItemInt

 

Размещение и совместимость 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz