### 函数功能

该函数把对话框中指定控制的文本转变为一个整型值。

### 函数原型

UINT GetDlgltemlnt(HWND hDlg,int nlDDlgltem,BOOL ★IpTranslated,BOOL bSigned);

### 参数

hDlg：指向含有利益控制的对话框的句柄。
nlDDlgltem：指定文本将被转变的控制的对话项目标识符。
IpTranslated：指向一个Boolean变量的指针。该变量保存函数成功/失败的值。TRUE表示成功，FALSE表示失败。此参数为可选的。它可以为NULL。在这种情况下，函数不返回关于成功和失败的信息。
bSigned：指定函数足否在开始时为一个最小的消息检测文本,且如果发现一个消息整型值，则返回它。TRUE指定应该这样做，FALSE指定不应该这样做。

### 返回值

如果函数调用成功则由IPTranslated指向的变量被设置为TRUE，且返回值为控制文本的转变值。
如果函数调用失败则由IPTranslated指向的变量被设置为FALSE，且返回值为零。注意因为零为一个可能转变的值，返回的零值不能通过它自身来表示失败。如果IpTranslated为NuLL，则表示函数没有返回关于成功和失败的信息。如果bSigned参数为TRUE，指定将被检取的值为一个符号整型值，则把返回值设置为一个整型类型。有关详细的错误信息，请调用GetLastError。
备注：GetDlgltemlnt函数通过发送WM_GETTEXT控制消息来检索给定控制的文本。函数通过去除任何一个文本开头的额外空间来转变要检索的文本，然后转换为数值数据。当函数达到文本的末尾或遇到一个非数值的字符时，则函数停止转变。 如果bSigned参数为TRUE，则GetDlgltemlnt函数检测文本开头的符号"C且把文本转变为符号整型数值。否则，函数创建一个非符号整型数值。如果转变的值大于IN_TMAX（对于有符号数）或UINT_MAX（对于无符号数），则GetDlgltemlnt函数返回零值。Windows CE：对于大于48个字符的文本字符串不能被转变。

### 速查

Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本：头文件：Winuser.h;库文件：user32.lib