起因

直接用裸 Win32 API 写界面，代码量集中在三块重复劳动上：注册窗口类、在 WndProc 里维护漫长的 switch-case、逐个 CreateWindow 创建控件。tlib 这类轻量封装的目标就是把这三块收进框架，开发者只写“某个按钮被按下时干什么”。

需求

  • 用 C++ 在 Windows 上做一个带按钮的小图形程序
  • 界面用 ResEdit 可视化绘制，代码只处理业务动作
  • 不引入 MFC/Qt 这类大框架，保持小体积

tlib 是什么

tlib是一个轻便、精小的win32窗口程序框架，配合ResEdit工具来绘制图形程序的用户界面，仅仅通过少量的代码来实现对图形界面的控制。

它的封装围绕 Win32 消息机制的三个固定件展开：

  1. 消息循环：Win32 GUI 程序的心脏是 GetMessage → TranslateMessage → DispatchMessage 循环，tlib 把它藏进 TApp::Run()；
  2. 窗口过程：系统把每条消息回调给窗口过程，裸写是一个巨型 switch；tlib 把它拆成一族可覆写的虚函数——EvCreate（窗口创建）、EvCommand（命令/控件通知）、EvClose（关闭）等，子类只覆写关心的那几个；
  3. 资源：控件不用代码一个个创建，而是在 ResEdit 里画成 Resource Script（*.rc），编译成 .res 链接进 exe，程序里用资源 ID（IDD_DIALOG1、IDM_OK）引用。

这个 Demo 采用“对话框当主窗口”的写法，是小型工具省事的做法：对话框的控件由系统按 .rc 模板自动创建，连布局代码都省了。

Demo

使用ResEdit新建一个Resource script(*.rc)工程，并绘制一个窗口界面，保存文件为resource.res（ResEdit 会同步生成 resource.h，里面是全部控件的 ID 宏——代码里 IDM_OK 这些名字的来源）

编写程序（注意使用GB2312编码）

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105

#include "resource.h"
#include "tlib.h"

/*----------------------------------------------------------------------
|   TMainWin
+---------------------------------------------------------------------*/
class TMainWin : public TDlg {
 public:
  TMainWin(TWin *_parent = NULL);
  virtual ~TMainWin() override;

  TMainWin(const TMainWin &) = delete;
  TMainWin &operator=(const TMainWin &) = delete;

  virtual BOOL EvCommand(WORD wNotifyCode, WORD wID,
                         LPARAM hwndCtl) override final;
  virtual BOOL EvCreate(LPARAM lParam) override final;

  virtual void Destroy(void) override final;
  virtual BOOL EvClose(void) override final;

 private:
  HWND btn1Wnd;
  HWND btn2Wnd;
  HWND btn3Wnd;
};

TMainWin::TMainWin(TWin *_parent)
  : TDlg(IDD_DIALOG1, _parent) {
  hAccel = ::LoadAccelerators(TApp::GetInstance(), MAKEINTRESOURCE(IDR_ACCELERATOR1));
}

TMainWin::~TMainWin() {
}

BOOL TMainWin::EvCreate(LPARAM lParam) {

  btn1Wnd = GetDlgItem(IDM_OK);
  btn2Wnd = GetDlgItem(IDM_CANCEL);
  btn3Wnd = GetDlgItem(IDM_EXIT);

  return TRUE;
}

BOOL TMainWin::EvCommand(WORD wNotifyCode, WORD wID, LPARAM hwndCtl) {
  int wmId = LOWORD(wID);
  switch (wmId) {
    case IDM_OK:
      ::MessageBox(NULL, "你按下了确认键", "提示", MB_OK);
      break;
    case IDM_CANCEL:
      ::MessageBox(NULL, "你按下了取消键", "提示", MB_OK);
      break;
    case IDM_EXIT:
      ::MessageBox(NULL, "关闭界面", "提示", MB_OK);
      DestroyWindow(hWnd);
      break;
    default:
      return FALSE;
  }
  return TRUE;
}

void TMainWin::Destroy(void) { PostQuitMessage(0); }

BOOL TMainWin::EvClose(void) {
  EndDialog(0);
  PostQuitMessage(0);
  return TRUE;
}

/*----------------------------------------------------------------------
|   SimpleUIApp
+---------------------------------------------------------------------*/
class SimpleUIApp : public TApp {
 public:
  explicit SimpleUIApp(HINSTANCE _hI);
  virtual ~SimpleUIApp() override;

  SimpleUIApp(const SimpleUIApp &) = delete;
  SimpleUIApp &operator=(const SimpleUIApp &) = delete;

  virtual void InitWindow(void) override final;
};

SimpleUIApp::SimpleUIApp(HINSTANCE _hI)
  : TApp(_hI) {
}

SimpleUIApp::~SimpleUIApp() {
}

void SimpleUIApp::InitWindow(void) {
  mainWnd = new TMainWin();
  mainWnd->Create();
  mainWnd->Show();
}

auto main(int argc, char **argv) -> int {

  HINSTANCE hInstance = GetModuleHandle(NULL);
  SimpleUIApp app(hInstance);

  return app.Run();;
}

代码说明

  • TMainWin : public TDlg：对话框当主窗口。构造函数把对话框模板 ID IDD_DIALOG1 和加速键表传给基类，控件随模板创建；
  • EvCreate：窗口创建完毕的钩子，GetDlgItem(IDM_OK) 按资源 ID 取控件句柄存起来备用；
  • EvCommand：按钮点击、菜单命令在 Win32 里都走 WM_COMMAND，tlib 把它封装成这个虚函数——wID 就是 ResEdit 里定义的控件 ID，switch 分发到对应动作；不认识的命令 return FALSE 交回基类默认处理；
  • EvClose / Destroy：EndDialog 结束对话框，PostQuitMessage(0) 往消息队列投一条 WM_QUIT——GetMessage 收到它返回 0，循环退出、进程结束。漏了这一句，窗口关了进程还挂在任务管理器里；
  • SimpleUIApp::InitWindow：应用初始化钩子，创建并显示主窗口；main 里 GetModuleHandle(NULL) 取实例句柄传给 TApp，app.Run() 内部就是消息循环本体。

程序源码

https://gitee.com/silentdxx/tlib.git

踩坑记录与注意事项

  • 编码必须统一：注意使用GB2312编码——源文件和 .rc 都存 ANSI（GB2312）代码页。资源编译器按本地代码页解释 .rc 里的中文字符串，一边 UTF-8 一边 ANSI，就是界面中文乱码、按钮文字变问号的根因；
  • 工程字符集选“多字节字符集”：tlib 是窄字符 API 风格，"你按下了确认键" 这种字面量在 Unicode 字符集下传不进 MessageBoxW，直接编译报错；
  • resource.h 与 .rc 要同步：在 ResEdit 里增删控件后它会重写这两个文件；只改一边不改另一边，控件 ID 对不上，表现为“按钮点了没反应”——EvCommand 的分支永远不命中；
  • PostQuitMessage 不能省：原理见代码说明，这是“窗口关了进程不退出”的经典根因。