GetDlgItemInt

【勇芳软件工作室】汉化HomePreviousNext

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函数返回零。

也可以看看

GetDlgCtrlID, GetDlgItem, GetDlgItemText, SetDlgItemInt