GetDlgItemInt函数将对话框中指定控件的文本转换为整数值。
UINT GetDlgItemInt(
HWND 【hDlg】, | //对话框的句柄 |
INT 【nIDDlgItem】, | //控制标识符 |
BOOL 【* lpTranslated】, | //指向变量以接收成功/失败指示符 |
BOOL 【bSigned】 | //指定值是否已签名或无符号 |
); |
参数
【hDlg】
处理包含感兴趣的控件的对话框。
【nIDDlgItem】
对话框项目标识符,指定要翻译其文本的控件。
【lpTranslated】
指向接收函数成功/失败值的布尔变量。TRUE表示成功,FALSE表示失败。
此参数是可选的:它可以为NULL。在这种情况下,该函数不会返回有关成功或失败的信息。
【bSigned】
指定函数是否应该在开始时检查文本中的减号,如果找到一个,返回一个带符号的整数值。TRUE指定这应该完成,FALSE它不应该。
返回值
如果函数成功,则【lpTranslated】指向的变量设置为TRUE,返回值为控件文本的翻译值。
如果函数失败,则【lpTranslated】指向的变量设置为FALSE,返回值为零。请注意,由于零是可能的转换值,返回值零并不表示失败。
如果【lpTranslated】为NULL,则该函数不会返回有关成功或失败的信息。
如果【bSigned】参数为TRUE,则指定要检索的值为有符号整数值,则将返回值转换为INT类型。
备注
GetDlgItemInt函数通过发送控件WM_GETTEXT消息来检索给定控件的文本。该函数通过剥离文本开头的任何额外的空格,然后转换十进制数字来翻译检索到的文本。该函数在到达文本末尾或遇到非数字字符时停止翻译。
如果【bSigned】参数为TRUE,则GetDlgItemInt函数将检查文本开头的减号( - ),并将文本转换为带符号的整数值。否则,该函数创建无符号整数值。
如果转换的值大于INT_MAX(对于带符号)或UINT_MAX(对于无符号数字),则GetDlgItemInt函数返回零。
也可以看看