C++：GetDlgltemText()取对话框控件文本函数

陈一男学习网站[ ChenYinan.com ] - CCF - NOI - 菜鸟教程 - 编程题库 - C++语言

1. 函数功能

GetDlgItemText函数用于获取对话框中指定控件的文本内容。在Windows编程中，对话框包含多种控件，如编辑框（Edit Control）、静态文本（Static Text）、组合框（ComboBox）等，这个函数可以方便地获取这些控件中的文本。例如，从一个用户输入信息的编辑框中获取用户输入的字符串，或者从一个用于显示提示信息的静态文本控件中获取显示的文本。

2. 函数原型和参数

函数原型如下：

UINT GetDlgItemText(
    HWND hDlg,
    int nIDDlgItem,
    LPTSTR lpString,
    int nMaxCount
);

参数说明：

hDlg：对话框句柄，用于指定包含目标控件的对话框。它确定了要从哪个对话框中获取控件的文本，是一个必需的参数。例如，在一个包含多个对话框的应用程序中，通过这个句柄可以准确地定位到包含目标控件的对话框。

nIDDlgItem：控件标识符（ID），用于指定要获取文本的控件。在对话框资源定义中，每个控件都被分配了一个唯一的标识符，通过这个标识符来确定要获取文本的具体控件。例如，在资源脚本文件中定义编辑框控件时会给定一个ID，通过这个ID就能找到对应的编辑框。

lpString：指向一个缓冲区的指针，用于接收获取到的文本内容。这个缓冲区需要由调用者分配足够的内存空间，以确保能够容纳控件中的文本。通常可以使用char数组来作为这个缓冲区，例如char buffer[100];。

nMaxCount：指定lpString缓冲区的最大字符数，用于防止缓冲区溢出。函数最多会将nMaxCount个字符（包括结束符\0）复制到缓冲区中。应该根据预期的最大文本长度合理设置这个参数，例如，如果预计控件中的文本不会超过100个字符，就可以设置nMaxCount为100。

3. 返回值

函数返回值是一个无符号整数（UINT），表示实际复制到缓冲区中的字符数（不包括结束符\0）。如果返回值为0，表示获取文本失败，可能是因为控件没有文本、控件句柄无效或者缓冲区太小等原因；如果返回值大于nMaxCount，则表示缓冲区太小，无法完全容纳控件中的文本。

4. 使用示例

假设存在一个对话框，其中有一个编辑框控件，其标识符为IDC_EDIT1，以下示例展示了如何获取该编辑框中的文本：

#include <windows.h>
#include <iostream>
INT_PTR CALLBACK DialogProc(HWND hDlg, UINT message, WPARAM wParam, LPARAM lParam)
{
    switch (message)
    {
        case WM_INITDIALOG:
        {
            char buffer[100];
            UINT length = GetDlgItemText(hDlg, IDC_EDIT1, buffer, 100);
            if (length > 0)
            {
                std::cout << "编辑框中的文本为: " << buffer << std::endl;
            }
        }
        return TRUE;
        case WM_COMMAND:
        if (LOWORD(wParam) == IDOK)
        {
            EndDialog(hDlg, LOWORD(wParam));
            return TRUE;
        }
    }
    return FALSE;
}
int main()
{
    DialogBox(NULL, MAKEINTRESOURCE(IDD_MYDIALOG), NULL, DialogProc);
    return 0;
}

在这个示例中，在WM_INITDIALOG消息处理过程中，创建了一个缓冲区buffer，然后使用GetDlgItemText函数从标识符为IDC_EDIT1的编辑框中获取文本。根据返回值判断是否获取成功，如果成功就将获取到的文本输出到控制台。DialogBox函数用于创建并显示对话框，DialogProc是对话框的过程函数，用于处理对话框的消息。