C语言中SendMessage函数如何正确使用？

这是一个非常常见的概念,但初学者容易混淆，因为它在不同上下文中指代不同的东西，我会从最核心、最常用的 Windows API SendMessage 开始，然后解释其他可能相关的概念。

核心概念：Windows API 的 SendMessage

在 C 语言中，当提到 SendMessage，99% 的情况下都是指 Windows API (应用程序编程接口) 中的一个核心函数，它用于在同一个应用程序内部或不同应用程序之间进行同步的窗口消息通信。

SendMessage 是什么？

SendMessage 是一个 Windows 系统函数，它的作用是直接调用目标窗口的窗口过程函数，并且等待这个窗口过程处理完消息后才会返回。

关键特点：同步和阻塞

• 同步：发送方（调用 SendMessage 的代码）会一直等待，直到接收方（目标窗口）处理完消息。
• 阻塞：在等待期间，发送方的线程会被挂起，无法执行其他操作，如果目标窗口处理消息很慢（比如在一个循环里），发送方的线程就会被“卡住”很长时间。

这与 PostMessage 形成鲜明对比，PostMessage 是异步的，它只是把消息放到目标窗口的消息队列里，然后立即返回，不关心消息何时被处理。

函数原型

LRESULT SendMessage(
  [in] HWND   hWnd,       // 目标窗口的句柄
  [in] UINT   Msg,        // 消息标识符
  [in] WPARAM wParam,     // 消息的附加信息 1
  [in] LPARAM lParam      // 消息的附加信息 2
);

参数详解：

• hWnd (Handle to Window)：一个 HWND 类型的值，代表你要发送消息的那个窗口的“身份证号”，你可以通过窗口标题、类名等找到这个句柄。
• Msg (Message)：一个 UINT 类型的无符号整数，代表你要发送的消息类型，Windows 预定义了很多消息，
  • WM_CLOSE (请求关闭窗口)
  • WM_DESTROY (窗口正在被销毁)
  • WM_PAINT (窗口需要重绘)
  • WM_COMMAND (用户从菜单、按钮或 accelerator 中进行了选择)
  • 你也可以自定义消息（通常定义为 WM_USER + 一个数字）。
• wParam (Word Parameter) 和 lParam (Long Parameter)：这两个参数是传递给窗口过程的附加数据，它们的含义完全取决于你发送的 Msg 是什么，对于 WM_COMMAND 消息，wParam 的低 16 位是控件ID，高 16 位是通知码。
• 返回值：LRESULT (Long Result)，是一个 32 位或 64 位的值，其含义同样取决于 Msg，通常是消息处理的结果。

如何使用 SendMessage (C 语言示例)

下面是一个简单的例子,演示如何在一个按钮的点击事件中，使用 SendMessage 向另一个窗口（比如一个文本框）发送 WM_SETTEXT 消息来设置其文本内容。

场景：我们有一个主窗口，上面有一个按钮（ID为 IDC_SETTEXT_BUTTON）和一个文本框（ID为 IDC_EDIT_BOX），点击按钮，文本框内容变为 "Hello from SendMessage!"。

#include <windows.h>
#include <tchar.h>
// 窗口过程函数的声明
LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow) {
    // ... (标准窗口创建代码，省略 RegisterClass 和 CreateWindow 的细节)
    // 假设我们已经成功创建了主窗口，其句柄为 hWnd
    HWND hEditBox = GetDlgItem(hWnd, IDC_EDIT_BOX); // 获取文本框的句柄
    HWND hButton = GetDlgItem(hWnd, IDC_SETTEXT_BUTTON); // 获取按钮的句柄
    // 在按钮的点击事件处理中（比如在 WM_COMMAND 消息的 case 分支里）
    if (LOWORD(wParam) == IDC_SETTEXT_BUTTON) {
        // 定义要发送的消息和参数
        LPCTSTR lpszText = _T("Hello from SendMessage!");
        // 调用 SendMessage 向文本框发送 WM_SETTEXT 消息
        // WM_SETTEXT 的 lParam 参数是新文本的地址
        SendMessage(hEditBox, WM_SETTEXT, 0, (LPARAM)lpszText);
        // SendMessage 会等待，直到文本框处理完这个消息。
        // 文本框的内容已经被更新了。
    }
    // ... (消息循环代码)
    return 0;
}

SendMessage vs. PostMessage

这是一个非常重要的区别,用一个表格来对比：

其他可能相关的 SendMessage

除了 Windows API，SendMessage 这个名字也可能出现在其他上下文中。

MFC 中的 SendMessage

在微软基础类库中,SendMessage 是一个非常重要的成员函数，它封装了 Windows API 的 SendMessage。

• 对于窗口对象：如果你有一个 CWnd 或其派生类的对象（CButton, CEdit），你可以直接调用它的 SendMessage 成员函数。

  // 假设 m_myEdit 是一个 CEdit 类型的成员变量
  m_myEdit.SendMessage(WM_SETTEXT, 0, (LPARAM)_T("Hello MFC!"));

  这种方式比直接调用 API 更安全，因为 C++ 对象可以帮你处理句柄的有效性等问题。

• 对于控件：对于标准控件（如按钮、列表框等），MFC 提供了更高级、更易用的成员函数，这些函数内部会调用 SendMessage 发送特定的消息。

  // 获取编辑框内容
  CString strText;
  m_myEdit.GetWindowText(strText); // 内部会发送 WM_GETTEXT 消息
  // 设置编辑框内容
  m_myEdit.SetWindowText(_T("Hello MFC!")); // 内部会发送 WM_SETTEXT 消息

  最佳实践：在 MFC 中，优先使用这些封装好的高级函数（如 SetWindowText, GetWindowText, GetDlgItemText），而不是直接调用 SendMessage，除非你需要发送一个没有对应封装函数的自定义消息。

其他平台或库的 SendMessage

• Linux/Unix X11 系统：X Window 系统没有直接叫 SendMessage 的函数，但其核心思想是类似的，你可以使用 XSendEvent 函数来向一个窗口发送事件（消息）。
• 第三方库：一些 GUI 库（如 Qt, wxWidgets）有自己的事件或信号槽机制，它们的名字和实现方式与 Windows API 的 SendMessage 不同，但都实现了跨组件通信的功能，Qt 的 QApplication::postEvent 是异步的，而直接调用目标 widget 的某个槽函数则更像是同步的。

总结与最佳实践

1. 明确上下文：当你在 C 语言（尤其是在 Windows 环境下）看到 SendMessage，首先想到的就是 Windows API 函数。
2. 理解同步与阻塞：SendMessage 是同步的，会阻塞你的代码，不要在性能敏感的循环或主线程中向可能响应缓慢的窗口发送 SendMessage，否则会导致你的程序界面“卡死”。
3. 首选封装函数：如果你在使用 MFC 或其他框架，优先使用它们提供的、更安全、更易用的封装函数（如 SetWindowText），而不是直接调用 SendMessage。
4. 何时使用 SendMessage：
   • 需要获取窗口信息时（如 WM_GETTEXT, WM_GETFONT）。
   • 需要等待操作完成才能继续时（如向一个自定义控件发送一个复杂的绘制命令）。
   • 进行跨进程通信时（虽然 SendMessage 主要用于同进程，但也可以用于跨进程，只是更复杂）。
5. 何时使用 PostMessage：
   • 只想通知,不关心结果时。
   • 不想阻塞当前线程时（在工作线程中通知主窗口更新界面）。

希望这个详细的解释能帮助你完全理解 C 语言中的 SendMessage！