跳转至

Windows API 中的一个窗口

原文： http://zetcode.com/gui/winapi/window/

窗口是应用显示输出并从用户接收输入的屏幕矩形区域。 一切都是 Windows 中的一个窗口。 至少从程序员的角度来看。 一个主窗口，一个按钮，一个静态文本甚至一个图标； 都是窗口。 静态文本只是窗口的一种特殊类型，桌面区域也是如此。

wWinMain()函数

每个 Windows UI 应用必须至少具有两个函数：WinMain函数和窗口过程。WinMain函数是 Windows UI 应用的入口点。 它初始化应用，在屏幕上显示应用窗口，然后进入主循环。 在我们的示例中，我们使用wWinMain()函数原型，该原型用于创建 Unicode UI 程序。

int WINAPI wWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, 
    PWSTR pCmdLine, int nCmdShow);

hInstance是实例的句柄。 它是一个 32 位数字，用于标识我们在 OS 环境中的程序实例。 Windows 在程序开始执行时给出此数字。 hPrevInstance参数始终为NULL； 它是 16 位 Windows 的传统。 Windows 程序也可以从命令行启动。 给定的参数存储在pCmdLine参数中。 nCmdShow值指定窗口的显示方式：最小化，最大化或隐藏。

wWinMain()函数在收到WM_QUIT消息时终止。

注册窗口类

在创建窗口之前，我们必须在 Windows 中注册其类。 许多控件的窗口类已经注册。 因此，当我们创建按钮或静态文本时，我们不需要为其注册窗口类。 要注册窗口类，我们必须创建并填充WNDCLASS结构。 我们设置窗口样式，额外的分配字节，窗口类名称，程序实例的句柄，背景画笔，可选菜单名称，窗口过程，光标的句柄和图标。 然后调用RegisterClassW()函数。

创建一个窗口

通过调用CreateWindowW()函数创建窗口。

HWND CreateWindowW(LPCWSTR lpClassName, LPCWSTR lpWindowName, 
  DWORD dwStyle, int x, int y, int nWidth, int nHeight, 
  HWND hWndParent, HMENU hMenu, HINSTANCE hInstance, LPVOID lpParam);

lpClassName唯一标识窗口。 它是我们注册窗口的名称。 lpWindowName是窗口名称。 它的效果取决于上下文-它可以是父窗口中的窗口标题，也可以是子窗口中的标签（如按钮或静态文本）。 可以使用多种样式创建 Windows。 为此，我们有dwStyle参数。 x和y指定窗口的初始水平和垂直位置。 nWidth和nHeight指定窗口的宽度和高度。 hWndParent是父窗口的句柄。 对于没有父级的窗口，我们使用NULL。 对于父窗口，hMenu是菜单的可选句柄，对于子窗口，hMenu是控件标识符。 hInstance是程序实例的句柄。 lpParam是最后一个参数，它是在WM_CREATE消息期间传递到窗口的可选值。 CreateWindowW()函数将句柄返回到新创建的窗口。

消息内容

WinMain()函数创建一个消息循环。 在应用的生命周期中，这是一个无休止的循环。 消息循环是一种程序结构，它等待并分派程序中的事件或消息。 Windows 使用消息进行通信。消息是一个整数值，用于标识特定事件-单击按钮，调整窗口大小或关闭应用。 一次可以创建多个消息。 不能同时处理所有消息。 因此，它们存储在消息队列中。 消息进入消息队列并等待直到被处理。 GetMessage()函数从消息队列中检索消息。 DispatchMessage()函数将消息调度到窗口过程。 如果应用获得了字符输入，则在循环中包含TranslateMessage()函数。

窗口过程

LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam);

每个窗口都有一个关联的窗口过程。 它是接收消息的函数。 hwnd是要接收消息的窗口的句柄。 uMsg是消息。 wParam和lParam参数提供其他消息信息。 这些参数的值取决于消息类型。 消息来自用户或操作系统。 我们对消息做出反应，或者我们调用默认的窗口过程来提供默认的处理。 大多数消息发送到默认的窗口过程。 默认的窗口过程称为DefWindowProcW()。 使用与常规窗口过程相同的参数来调用它。

一个简单的窗口

以下示例显示了骨架 Windows 应用。

simplewindow.c

#include <windows.h>

LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);

int WINAPI wWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, 
    PWSTR pCmdLine, int nCmdShow) {

    MSG  msg;    
    HWND hwnd;
    WNDCLASSW wc;

    wc.style         = CS_HREDRAW | CS_VREDRAW;
    wc.cbClsExtra    = 0;
    wc.cbWndExtra    = 0;
    wc.lpszClassName = L"Window";
    wc.hInstance     = hInstance;
    wc.hbrBackground = GetSysColorBrush(COLOR_3DFACE);
    wc.lpszMenuName  = NULL;
    wc.lpfnWndProc   = WndProc;
    wc.hCursor       = LoadCursor(NULL, IDC_ARROW);
    wc.hIcon         = LoadIcon(NULL, IDI_APPLICATION);

    RegisterClassW(&wc);
    hwnd = CreateWindowW(wc.lpszClassName, L"Window",
                WS_OVERLAPPEDWINDOW | WS_VISIBLE,
                100, 100, 350, 250, NULL, NULL, hInstance, NULL);  

    ShowWindow(hwnd, nCmdShow);
    UpdateWindow(hwnd);

    while (GetMessage(&msg, NULL, 0, 0)) {

        DispatchMessage(&msg);
    }

    return (int) msg.wParam;
}

LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, 
    WPARAM wParam, LPARAM lParam) {

    switch(msg) {

      case WM_DESTROY:

          PostQuitMessage(0);
          break;
    }

    return DefWindowProcW(hwnd, msg, wParam, lParam);
}

我们将逐步解释示例代码。

#include <windows.h>

这是 C 编程语言的头文件。 它包含 API 中的所有函数声明，所有公共宏和所有数据类型。 通过链接必要的库kernel32.lib，user32.lib和gdi32.lib并包含<windows.h>头文件，将 Windows API 添加到 C 编程项目中。

wc.style = CS_HREDRAW | CS_VREDRAW;

我们在这里设置窗口样式。 CS_HREDRAW和CS_VREDRAW标志意味着只要对窗口的高度或宽度进行移动或大小调整，就会重新绘制整个窗口。

wc.cbClsExtra    = 0;
wc.cbWndExtra    = 0;

在我们的示例中，我们不使用其他字节。 因此，我们将成员设置为零。 这两个属性最常见的用法是窗口子类化。

wc.lpszClassName = L"Window";

Window 是此特定窗口类型的类名。 创建窗口时，我们将使用此类名称。 L字符在宽字符串之前。

wc.hInstance = hInstance;

我们设置程序的实例。

wc.hbrBackground = GetSysColorBrush(COLOR_3DFACE);

在这里，我们设置背景画笔。 它是用来绘制窗口客户区域的颜色。

wc.lpszMenuName  = NULL;

在我们的示例中，我们不创建菜单。

wc.lpfnWndProc = WndProc;

我们为窗口类提供了窗口过程。

wc.hCursor = LoadCursor(NULL, IDC_ARROW);

我们为应用设置光标。 我们使用LoadCursor()函数从系统资源中加载光标。 IDC_ARROW是标准箭头光标的值。

wc.hIcon   = LoadIcon(NULL, IDI_APPLICATION);

我们为应用设置图标。 使用LoadIcon()函数从系统资源中检索图标。 IDI_APPLICATION是默认应用图标的值。

RegisterClassW(&wc);

我们向系统注册窗口类。

ShowWindow(hwnd, nCmdShow);
UpdateWindow(hwnd);

这两行显示了屏幕上的窗口。 nCmdShow指定我们如何在屏幕上显示窗口。

while (GetMessage(&msg, NULL, 0, 0)) {

  DispatchMessage(&msg);
}

这是消息循环。 我们使用GetMessage()函数从消息队列中接收消息，并使用DispatchMessage()函数将它们分发到窗口过程。

return (int) msg.wParam;

在应用结束时，退出代码将返回到系统。

switch(msg) {

  case WM_DESTROY:

    PostQuitMessage(0);
    break;
}

return DefWindowProcW(hwnd, msg, wParam, lParam);

在窗口过程中，我们对WM_DESTROY消息作出反应。 PostQuitMessage()将WM_QUIT消息发送到消息队列。 使用DefWindowProcW()函数将所有其他消息发送到默认处理。

A window

图：窗口

在 Windows API 教程的这一部分中，我们创建了一个基本窗口。

回到顶部