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