函数说明

函数原型

参数说明(参数 返回值 系统要求)

函数说明

CWnd类的成员函数。

函数原型

int GetDlgItemText( HWND hDlg , int nID, LPTSTR lpStr, int nMaxCount) const;

int GetDlgItemText( int nID, CString& rString) const;

参数说明

调用这个函数以获得与对话框中的控件相关的标题或文本。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两种版本