GetDlgItemInt

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

(UINT GetDlgItemInt HWND  hDlg, / / обработать диалоговое окноintnIDDlgItem, / / управления идентификаторBOOL* lpTranslated,  / / указывает на переменную для получения успеха / / индикаторBOOLbSigned / / указывает, является ли значение подписали или без знака);
 

Параметры

hDlg

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

nIDDlgItem

Идентификатор элемента диалогового окна, указывающий элемент управления, текст которого должен быть переведен.

lpTranslated

Указатель логического переменную, которая получит значение успеха функция. Значение TRUE указывает на успех, FALSE указывает на сбой.

Этот параметр является необязательным: это может быть значение NULL. В этом случае функция возвращает сведения об успехе или неудаче.

bSigned

Определяет ли функция должна изучить этот текст для знак минус в начале и возвращать целочисленное значение, если он находит один. Значение TRUE указывает, что это должно быть сделано, ложь, что оно не должно.

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

Если функция успешно, переменная, который указывает lpTranslated имеет значение TRUE, и возвращаемое значение является значением переведенного текста элемента управления.

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

Если lpTranslated имеет значение NULL, функция возвращает сведения об успехе или неудаче.

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

Примечания

GetDlgItemInt функция извлекает текст данного элемента управления путем отправки элемента управления WM_GETTEXT. Функция преобразует полученный текст, зачистки любые лишние пробелы в начале текста и преобразовав десятичных цифр. Функция прекращает перевод когда он достигает конца текста или нечисловые символа.

Если параметр bSigned имеет значение TRUE, функция проверки GetDlgItemInt на знак минус (-) в начале текста и преобразует текст в целочисленное значение. В противном случае функция создает беззнаковое целочисленное значение.

Функция GetDlgItemInt возвращает ноль, если перевод значение больше чем INT_MAX (для подписанных чисел) или UINT_MAX (для чисел без знака).

Windows CE: Нельзя преобразовать текстовые строки с более чем 48 символов.

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Требует версии 1.0 или более поздней версии.
Заголовок:Объявленные в winuser.h.
Импорта библиотеки:Использование user32.lib.

Родственные слова

Обзор полей диалогового окна, диалогового окна функций, GetDlgCtrlID, GetDlgItem, GetDlgItemText, SetDlgItemInt

Index