getdlgitem_GetDlgItemText -函数说明
CWnd类的成员函数。
getdlgitem_GetDlgItemText -函数原型
int GetDlgItemText( HWND hDlg , int nID, LPTSTR lpStr, int nMaxCount) const;
int GetDlgItemText( int nID, CString& rString) const;
getdlgitem_GetDlgItemText -参数说明
调用这个函数以获得与对话框中的控件相关的标题或文本。GetDlgItemText成员函数将文本拷贝到lpStr指向的位置并返回拷贝的字节的数目。
参数nID 指定了要获取其标题的控件的整数标识符。 lpStr 指向要接收控件的标题或文本的缓冲区。 nMaxCount 指定了要拷贝到lpStr的字符串的最大长度(以字节为单位)。如果字符串比nMaxCount要长,它将被截断。 rString 对一个CString对象的引用。
返回值如果函数调用成功,返回值为拷贝到缓冲区中的 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两种版本