GetDlgItemText 函数
该函数用于获取对话框中指定控件的标题或文本。
定义
UINT GetDlgItemText(HWND hDlg, int nIDDlgItem, LPTSTR lpString, int nMaxCount);
参数
hDlg
对话框的句柄。
nIDDlgItem
指定控件的标识符(ID)。
lpString
指向用于接收获取结果的缓冲区的指针。
nMaxCount
指定允许拷贝到上述缓冲中的最大字符数(按 TCHAR 字符类型),如果字符串的长度(包含结束空字符)大于指定的最大字符数,则会被截断。
返回值
如果函数调用成功,返回值为拷贝到缓冲区中的 TCHAR 字符个数(不包括结束空字符)。
如果函数调用失败,返回值为 0 。要获取更多错误信息,请调用 GetLastError 函数。
说明
如果字符串的长度大于缓冲区的长度,则会被截断,并以空字符结束。
GetDlgItemText 函数向控件发送一条 WM_GETTEXT 消息。
在 ANSI 版本中,长度指的是字节数,在 Unicode 版本中,长度指的是字符的个数。
系统要求
动态链接库:user32.dll
头文件:在Winuser.h中定义,需包含Windows.h文件
库文件:User32.lib
最低操作系统:Windows 95, Windows NT 3.1
Unicode:实现为ANSI和Unicode两种版本