GetDlgItemText

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两种版本