Windows 窗口与消息：消息与消息队列

当系统与应用交流时，它会发送或投递（send or post，两者的区别见下文） 系统定义消息 。它使用这些消息来控制应用的操作，并为应用提供输入和其他让应用处理的信息。应用也可以发送或投递系统定义消息。应用一般使用这些消息来控制用预定义窗口类创建的窗口的操作。

每个系统定义消息都有一个唯一的标识符和一个对应的符号常量（在软件开发 kit（SDK）的头文件中），符号常量说明了消息的目的。例如，WM_PAINT 常数要求窗口绘制它的内容。

符号常量指定了系统定义消息的归属。常量标识符的前缀确定了能够解释和处理消息的窗口类型。关于各式各样的前缀，可以参考这里。

一般窗口消息覆盖了广泛的信息和请求，包括鼠标和键盘的输入，菜单和对话框的输入，窗口创建和管理，以及动态数据交换（DDE）。

应用可以创建消息供自己的窗口使用或与其他进程中的窗口交流。如果应用创建了自己的消息，接收消息的窗口过程必须对消息进行解释并提供合理的处理。

消息标识符的值使用方法如下：

• 系统保留的消息标识符值的范围是 0x0000 到 0x03FF（WM_USER - 1）。应用不能使用这些值作为私有消息
• 在 0x0400（WM_USER）到 0x7FFFF 范围内的值用于私有窗口类的消息标识符
• 调用 RegisterWindowMessage 函数注册一个消息时，系统会返回一个在 0xC000 到 0xFFFF 范围内的消息标识符。这个返回的消息标识符保证在整个系统中是唯一的。通过使用这个函数，如果其他应用以不同的目的使用了这个函数，可以避免冲突。

系统可以在同一时间显示任意数量的窗口。要将鼠标和键盘输入路由到合适的窗口，系统使用了消息队列。

系统维护了一个系统消息队列，也为每个 GUI 线程维护了一个线程指定的消息队列。为了避免给非 GUI 线程创建多余的消息队列，所有的线程创建时是没有消息队列的。仅当线程第一次调用了特定的用户函数，系统才创建线程的消息队列。GUI 函数的调用不会导致消息队列的创建。

当用户移动鼠标，按下鼠标按键，或在键盘上打字，鼠标或键盘的设备驱动会将输入转化为消息并放入系统消息队列。每隔一段时间，系统会从系统消息队列中移除消息，对其测试并决定其目标窗口，随后将消息投递到创建目标窗口的线程的消息队列。线程的消息队列会接收线程创建的窗口的所有鼠标和键盘消息。线程从队列中删除消息，并指示系统将它们发送到合适的窗口过程进行处理。

除了 WM_PAINT，WM_TIMER，和 WM_QUIT 这三个消息之外，系统总是会将消息投递到消息队列的末尾。窗口是以 FIFO 的顺序接收它的输入消息的。 然而 WM_PAINT 消息，WM_TIMER 消息和 WM_QUIT 消息会被保留在消息队列中，仅当队列不包含其他消息时再发送到窗口过程。另外，一个窗口的多个 WM_PAINT 消息会被组合为单个 WM_PAINT 消息，并把客户区的所有无效区域整合为单个区域。对 WM_PAINT 消息的组合减少了窗口对客户区内容的重绘次数。

系统通过填充一个 MSG 结构来将消息投递到线程的消息队列，随后将其拷贝到消息队列中。 MSG 结构的信息包括：指定窗口的句柄，消息标识符，两个消息参数，消息投递的时间，以及鼠标光标的位置。通过使用 PostMessage 和 PostThreadMessage 函数，线程可以将一个消息投递到自己的消息队列或其他线程的消息队列。

应用可以使用 GetMessage 来删除队列中的消息。要在不删除消息的情况下检查队列消息，应用可以使用 PeekMessage 函数，该函数会使用消息填充 MSG 。

在从队列删除消息后，应用可以使用 DispatchMessage 函数来指示系统把消息发送给窗口过程进行处理。DispatchMessage 接收一个 MSG 结构的指针，该结构已经使用 GetMessage 或 PeekMessage 填充过。DispatchMessage 将窗口句柄，消息标识符，和两个消息参数传递给窗口过程，但它不会传递时间和鼠标光标位置。应用在处理消息时可以通过 GetMessageTime 和 GetMessagePos 函数检索时间和位置信息。

如果消息队列中没有消息，线程可以使用 WaitMessage 将控制权交给其他的线程。该函数会挂起线程，直到新的消息被放在线程的消息队列中才会返回。

你可以使用 SetMessageExtraInfo 函数来将一个值与当前线程消息队列关联起来。随后调用 GetMessageExtraInfo 来获得与最后一个使用 GetMessage 或 PeekMessage 检索的消息关联的值。

非队列消息直接发送到目标窗口的窗口过程，绕过系统消息队列和线程消息队列。系统一般会向窗口发送非队列消息来提醒影响到窗口的事件。例如，当用户激活一个新的应用窗口时，系统会发送一系列消息给窗口，包括 WM_ACTIVATE，WM_SETFOCUS，和 WM_SETCURSOR。这些消息会通知窗口它已经被激活了，键盘输入被指向窗口，鼠标光标也移入了窗口范围内。非队列消息也可由应用调用某些系统函数产生。例如，在应用使用 SetWindowPos 函数移动窗口后，系统会发送 WM_WINDOWPOSCHANGED 消息。

一些可以发送非队列消息的函数是 BroadcastSystemMessage，BroadcastSystemMessage，SendMessage，SendMessageTimeOut，和 SendNotifyMessage。

简单的消息循环由对下列三个函数的调用完成：GetMessage，TranslateMessage 和 DispatchMessage。注意，如果存在错误，GetMessage 会返回 -1，因此需要对其进行测试：

MSG msg;
BOOL bRet;

while((bRet = GetMessage( &msg, NULL, 0, 0 )) != 0)
{
    if (bRet == -1)
    {
        // handle the error and possibly exit
    }
    else
    {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }
}

GetMessage 从消息队列中检索消息，并将其拷贝到一个 MSG 结构中。除了遇到了 WM_QUIT 时返回 FALSE 并终止循环，它的返回值为一个非 0 值。在单线程应用中，结束消息循环通常是关闭应用的第一步。应用使用 PostQuitMessage 来结束它的循环，这通常是对主窗口窗口过程的 WM_DESTROY 消息的响应。

如果你在 GetMessage 函数的第二参数指定了一个窗口句柄，只有指定窗口的消息才会被从窗口中检索。GetMessage 能够对队列消息进行过滤，只对指定范围的那些消息进行检索。

如果线程要从键盘中接收字符输入，线程的消息循环必须包括 TranslateMessage。每当用户按下一个键时，系统会生成虚拟键消息（WM_KEYDOWN 和 WM_KEYUP）。虚拟键消息包括一个标识按下按键的虚拟键代码，这不是它的字符值。要检索这个值，消息循环必须包含 TranslateMessage，它将虚拟键消息翻译为字符消息（WM_CHAR），并将它放入应用消息队列中。字符消息可以在随后的消息循环中被删除和发送到窗口过程。

DispatchMessage 函数将消息发送到由 MSG 结构指定的窗口句柄的窗口过程。如果窗口句柄是 HWND_TOPMOST，DispatchMessage 会将消息发送到系统中所有的顶级窗口的窗口过程中。

应用的主线程在初始化应用和创建至少一个窗口后开始它的消息循环。在开始后，消息循环持续从线程的消息队列中检索消息并派发到合适的窗口。当 GetMessage 从消息队列中删除 WM_QUIT 消息后，消息循环就结束了。

每一个线程队列只需要一个消息循环，即便应用包含多个窗口。DispatchMessage 总是会将消息派发到合适的窗口；这是因为队列中的每个消息都是包含标识了消息归属的窗口句柄的 MSG 结构。

你可以用多种方式修改一个消息循环。例如，你可以从队列中检索消息而不派发给窗口。这对于投递（post）不指定窗口的消息是有用的。你可以指示 GetMessage 搜索特定的消息，把其他消息留在队列中。如果你必须暂时绕过通常的 FIFO 顺序，这是很有用的。

使用加速键的应用必须能够将键盘消息翻译为命令消息。要做到这一点，应用消息循环必须包含一个对 TranslateAccelerator 函数的调用。更多关于加速键的信息，可见于 Keyboard Accelerators。

如果线程使用了一个模态对话框，消息循环必须包含一个 IsDialogMessage 函数以便对话框能够接收键盘输入。

应用一般对指定窗口投递一个消息来执行一个任务。PostMessage 为消息创建一个 MSG 结构并将它拷贝到消息队列中。应用的消息循环最终会检索到该消息并派发到合适的窗口过程。

应用可以在不指定窗口的情况下投递消息。如果在调用 PostMessage 时，应用以 NULL 作为窗口句柄参数的值，消息会被投递到与当前线程关联的队列中。因为没有指定窗口句柄，应用必须在消息循环中处理这个消息，而不是在指定的窗口中。

有时，你可能想要将一个消息投递到系统所有的顶级窗口中。应用可以在调用 PostMessage 时指定 HWND_TOPMOST 作为 hwnd 参数。

一个通常的编程错误是假定 PostMessage 总是会投递一个消息。当消息队列已经满了的时候这是不对的。应用应该对 PostMessage 的返回值进行检查来决定消息是否被投递了，如果还没有，再投递一次。

应用通常向窗口发送消息，来提醒窗口过程立即执行任务。函数 SendMessage 将消息发送到指定窗口的窗口过程。该函数会等待窗口过程完成处理，并在之后返回消息结果。父窗口和子窗口通常通过互相发送消息来交流。例如，父窗口有一个编辑控件子窗口，它可以通过向子窗口发送消息来设置文本。控件也可以通过向父窗口发送消息来通知父窗口由用户带来的文本改变。

函数 SendMessageCallback 也向指定的窗口的窗口过程发送消息。但不同的是，这个函数会立即返回。在窗口处理消息后，系统会调用指定的回调函数。更多关于回调函数的信息，可见于 SendAsynaProc 。

有时，你可能想要对在系统中的所有顶级窗口发送消息。例如，如果应用改变了系统时间，它必须发送 WM_TIMECHANGE 通知所有的顶级窗口。这可以通过在 SendMessage 调用中指定 HWND_TOPMOST 作为 hwnd 参数。你也可以指定 lpdwRecipients 为 BSM_APPLICATIONS，通过调用 BroadcastSystemMessage 来对所有应用广播消息。

通过使用 InSendMessage 和 InSendMessageEx 函数，窗口过程可以判断是否在处理由其他线程发送的消息。当消息处理依赖于消息来源时，这个功能是有用的。

当应用通过调用 CreateWindow 或 CreateWindow 要求创建一个窗口时，会发送这个消息（在函数返回前消息就被发送）。新窗口的窗口过程在窗口创建后会接收到这个消息，但是是在窗口可见之前。

这是窗口过程接收到的第一个消息。

接收该消息时，窗口过程的 wParam 参数值不被使用，它的 lParam 是一个指向 CREATESTRUCT 结构的指针。这个结构包含了窗口初始化的参数。

处理该消息后，窗口过程应该返回 0 以继续窗口的创建。如果窗口过程返回 -1，窗口会被销毁，CreateWindow 或 CreateWindowEx 会返回空句柄。

在窗口尺寸改变后向窗口发送该消息。

wParam 是尺寸改变的类型，它可以是下列值中的一个；

• SIZE_MAXHIDE，当其他窗口最大化时，该消息会发送到所有弹出（pop-up)窗口
• SIZE_MAXIMIZED，窗口已经最大化了
• SIZE_MAXSHOW，当其他窗口恢复到之前尺寸时，该消息会发送到所有弹出窗口
• SIZE_MINIMIZED，窗口已经最小化了
• SIZE_RESTORED，窗口的尺寸改变了，但不是最大化和最小化

lParam 的低位是客户区的新宽度，高位是客户区的新高度。虽然窗口的宽度和高度是 32 位值， lParam 只包含宽高值的低 16 位。

窗口过程处理该消息后应该返回 0。

当系统或其他应用要求对应用窗口的部分进行绘制时，会发送该消息。调用 UpdateWindow 或 RedrawWindow 函数时，或在应用通过使用 GetMessage 或 PeekMessage 获得 WM_PAINT 并调用 DispatchMessage 函数后，消息会被发送到窗口过程。

lParam 和 wParam 都不被使用。

WM_PAINT 消息由系统生成，它不应由应用发送。要想强制应用绘制特定的设备上下文，可以使用 WM_PRINT 或 WM_PRINTCLIENT 消息。

当应用消息队列中没有其他消息时，系统会把该消息送入队列。当应用消息队列中没有其他消息时，调用 GetMessage 会返回 WM_PAINT，DispatchMessage 会把消息发送到合适的窗口。

DefWindowProc 函数会将绘制区域有效化。

窗口可能因使用 RDW_INTERNALPAINT 调用 RedrawWindow 而受到内部绘制消息。在这种情况下，窗口可能没有更新区域。应用可以调用 GetUpdateRect 来判断窗口是否存在更新区域。如果 GetUpeateRect 返回 0，则窗口不必调用 BeginPaint 和 EndPaint。

当窗口将被销毁时发送该消息。在窗口被从屏幕删除后，它会被发送到删除的窗口的窗口过程。

该消息首先被发送到被销毁的窗口，之后发送到子窗口（如果有的话）。在消息的主窗口处理过程中，可以假设所有子窗口还是存在的。

wParam 和 lParam 不被使用。如果处理了该消息，窗口过程应返回 0。

如果被销毁的窗口是剪切板链的一部分，在 WM_DESTROY 消息处理返回前，窗口必须将它从链条中移除。

当用户从菜单选中一个命令时会发送，当控件向它的父窗口发送提醒消息时会发送，当加速键被翻译时会发送。

如果应用处理了该消息，它应该返回 0。

在消息来源是菜单时， wParam 的高位是 0，低位是菜单标识符（IDM_*）， lParam 是 0。

消息来源是加速键时， wParam 的高位是 1，低位是加速键标识符（IDM_*）， lParam 是 0。

消息来源是控件时， wParam 的高位是控件特定的通知码，低位是控件标识符， lParam 是控件窗口句柄。

窗口获得键盘输入焦点后会接收该消息。

wParam 是失去键盘输入焦点的窗口的句柄。这个参数可以是 NULL。

lParam 不被使用。

处理消息后，窗口过程应返回 0。

在一个窗口即将失去键盘焦点前，会向它发送该消息。

wParam 是接收键盘焦点的窗口。它可以是 NULL。

lParam 不被使用。

处理消息后，窗口过程应返回 0。