На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

GetDlgItemInt



The GetDlgItemInt function translates the text of a specified control in a dialog box into an integer value.

UINT GetDlgItemInt(

HWND hDlg, // handle to dialog box
int nIDDlgItem, // control identifier
BOOL *lpTranslated, // points to variable to receive success/failure indicator
BOOL bSigned // specifies whether value is signed or unsigned
);


Parameters

hDlg

Handle to the dialog box that contains the control of interest.

nIDDlgItem

Dialog item identifier that specifies the control whose text is to be translated.

lpTranslated

Points to a Boolean variable that receives a function success/failure value. TRUE indicates success, FALSE indicates failure.
This parameter is optional: it can be NULL. In that case, the function returns no information about success or failure.

bSigned

Specifies whether the function should examine the text for a minus sign at the beginning and return a signed integer value if it finds one. TRUE specifies that this should be done, FALSE that it should not.



Return Values

If the function succeeds, the variable pointed to by lpTranslated is set to TRUE, and the return value is the translated value of the control text.
If the function fails, the variable pointed to by lpTranslated is set to FALSE, and the return value is zero. Note that, since zero is a possible translated value, a return value of zero does not by itself indicate failure.
If lpTranslated is NULL, the function returns no information about success or failure.

If the bSigned parameter is TRUE, specifying that the value to be retrieved is a signed integer value, cast the return value to an int type.

Remarks

The GetDlgItemInt function retrieves the text of the given control by sending the control a WM_GETTEXT message. The function translates the retrieved text by stripping any extra spaces at the beginning of the text and then converting the decimal digits. The function stops translating when it reaches the end of the text or encounters a nonnumeric character.
If the bSigned parameter is TRUE, the GetDlgItemInt function checks for a minus sign (-) at the beginning of the text and translates the text into a signed integer value. Otherwise, the function creates an unsigned integer value.

The GetDlgItemInt function returns zero if the translated value is greater than INT_MAX (for signed numbers) or UINT_MAX (for unsigned numbers).

See Also

GetDlgCtrlID, GetDlgItem, GetDlgItemText, SetDlgItemInt




Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetDlgItemInt



Функция GetDlgItemInt переводится текст определенного управления в диалоговый ящик в величину целого.

UINT GetDlgItemInt(

HWND hDlg, // РУЧКА, чтобы общаться ящик int nIDDlgItem, // управляющий идентификатор BOOL *lpTranslated, // точки на переменную, чтобы получать успех/неудачу указателя BOOL bSigned // определяет что независимо величина подписана или неподписанный
);


Параметры

hDlg

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

nIDDlgItem

Диалоговый идентификатор пункта, который определяет управление, чей текст должен быть переведен.

lpTranslated

Точки на Логическую переменную, которые получают функциональный успех/неудачу величины. ИСТИНА указывает успех, ЛОЖЬ указывает неудачу.
Этот параметр дополнительный: это может быть НЕДЕЙСТВИТЕЛЬНО. В этом случае, функция возвращает никакой информации об успехе или неудаче.

bSigned

Определяет должна функция изучать текст на наличие minus знака в начале и возвращать подписанную величину целого если она находит один. ИСТИНА определяет, что это будет сделан, ЛОЖЬ, которая это было бы нет.



Обратные Величины

Если функция добивается успеха, переменная указывалась, чтобы lpTranslated установлен в ИСТИНУ, и обратная величина является переведенной величиной управляющего текста.
Если функция терпит неудачу, переменная указывалась, чтобы lpTranslated установлен в ЛОЖЬ, и обратная величина нулевая. Отметьтесь, что, с тех пор как нуль - возможно переведенная величина, обратная величина нуля делает с помощью себя указывать неудачу.
Если lpTranslated, НЕДЕЙСТВИТЕЛЬНО, функция возвращает никакой информации об успехе или неудаче.

Если bSigned параметр является ИСТИНОЙ, определяя, что величина, которая нужно извлекать, - подписанная величина целого, бросает обратную величину в int тип.

Замечания

Функция GetDlgItemInt извлекает текст данного управления посылая управление сообщение WM_GETTEXT. Функция переводится извлеченный текст удаляя любые дополнительные пробелы в начале текста и затем преобразовывая десятичные цифры. Функция перестает переводиться когда она достигает конца текста или сталкивается с nonnumeric символом.
Если bSigned параметр является ИСТИНОЙ, функциональные чеки GetDlgItemInt minus знака (-) в начале текста и переводится текст в подписанную величину целого. В противном случае, функция создает без знака величину целого.

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

Смотри Также

GetDlgCtrlID, GetDlgItem, GetDlgItemText, SetDlgItemInt




Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz