WTL 概述-Aet

Bingliaolong 2025-03-10 12:59 Aet | 隐藏边栏 | 抢沙发 | 4 0

文章评分 1 次，平均分 5.0 ：

WTL下载

WTL 基础概念

定位与优势

基于 ATL 的扩展库，专注于高效 Win32 GUI 开发，无 MFC 的臃肿
优势
1. 模板驱动：零成本抽象，代码体积小
2. 兼容 Win32 API：直接操作窗口句柄，灵活性高。
3. 现代 C++ 风格：支持 RAII、模板元编程

WTL 与 ATL 的关系

依赖关系：
1. WTL 依赖 ATL 的窗口类（如 CWindow）和 COM 支持
扩展功能：
1. WTL 在 ATL 基础上添加了高级控件（如 CListViewCtrl）、UI 布局工具（如 CSplitterWindow）

窗口与消息处理

窗口模板类

CWindowImpl：窗口基类，支持消息映射
CDialogImpl：对话框封装
CFrameWindowImpl：主框架窗口

`CWindow`

轻量级句柄封装
1. CWindow是对窗口句柄（HWND）的薄封装，提供对窗口操作API的直接映射，如ShowWindow、MoveWindow等
2. 仅包含m_hWnd作为窗口句柄，无额外冗余数据，确保对象占用最小内存
3. 通过重载operator HWND()，允许将CWindow对象隐式转换为HWND，实现与原生API的无缝兼容
方法封装策略
1. 将SendMessage等函数封装为成员方法，例如SendMessage变为CWindow::SendMessage，并利用模板参数校验消息参数类型
2. 提供Attach和Detach方法，显式控制句柄所有权，避免MFC中隐含的资源管理开销
与CWindowImpl的协作
1. CWindowImpl通常以CWindow作为模板基类（TBase参数），继承其窗口操作方法，同时扩展窗口创建和消息处理功能
2. CWindow仅负责窗口操作，而窗口的生命周期管理（如注册窗口类、创建窗口）由CWindowImpl处理

`CWindowImpl`

用途
1. 用于创建自定义窗口，处理窗口消息（如 WM_PAINT、WM_CREATE 等）
继承关系
1. 继承自CWindowImpl → CWindowImplBaseT → CWindowImplRoot → CMessageMap
2. 继承自 CWindow（ATL 的窗口句柄封装类），通过模板实现消息映射
特性
1. 消息映射宏：通过 BEGIN_MSG_MAP 和 END_MSG_MAP 定义消息处理逻辑
2. 窗口类注册：支持动态注册窗口类（通过 DECLARE_WND_CLASS）
3. 灵活性：可以自定义窗口样式、扩展样式和窗口过程
场景
1. 需要完全自定义的窗口（如游戏界面、绘图工具）
2. 实现非标准控件（如自定义按钮、图表控件）
示例

#include <atlbase.h>

#include <atlapp.h>

#include <atlwin.h>

class CMyWindow : public CWindowImpl<CMyWindow> {

public:

// 1. 声明窗口类（自动注册）

DECLARE_WND_CLASS(L"MyWindowClass")

// 2. 消息映射表

BEGIN_MSG_MAP(CMyWindow)

MESSAGE_HANDLER(WM_PAINT, OnPaint)

MESSAGE_HANDLER(WM_DESTROY, OnDestroy)

END_MSG_MAP()

// 3. 消息处理函数

LRESULT OnPaint(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled) {

PAINTSTRUCT ps;

HDC hdc = BeginPaint(&ps);

TextOut(hdc, 10, 10, L"Hello WTL!", 10);

EndPaint(&ps);

bHandled = TRUE; // 标记消息已处理

return 0;

}

LRESULT OnDestroy(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled) {

PostQuitMessage(0); // 退出消息循环

bHandled = TRUE;

return 0;

}

};

// 创建并显示窗口

CMyWindow wnd;

wnd.Create(NULL, CWindow::rcDefault, L"WTL Window", WS_OVERLAPPEDWINDOW);

wnd.ShowWindow(SW_SHOW);

`CDialogImpl`

功能
1. 用于创建模态或非模态对话框，支持对话框资源模板和控件消息处理
继承关系
1. CDialogImpl<T, TBase> → CDialogImplBaseT<TBase> → CWindowImplRoot<TBase>
2. CDialogImplBaseT<TBase>
  为对话框提供基础的消息处理框架和窗口过程（DialogProc），并通过模板参数 TBase 支持基类扩展（默认基类为 CWindow）
3. CWindowImplRoot<TBase>
  作为继承链的根类，确保窗口对象销毁时关联的窗口句柄（HWND）已被正确销毁
特性
1. 对话框资源绑定：通过 enum { IDD = IDD_MYDIALOG } 关联资源文件中的对话框模板
2. 控件消息处理：使用 COMMAND_HANDLER 或 NOTIFY_HANDLER 响应按钮点击、列表项选择等事件
3. 数据交换（DDX）：通过 BEGIN_DDX_MAP 和 END_DDX_MAP 简化控件与变量的数据同步
场景
1. 配置窗口（如设置选项、用户登录）
2. 数据输入表单（如新建文件、编辑属性）
示例

#include <atlbase.h>

#include <atlapp.h>

#include <atlwin.h>

#include "resource.h" // 对话框资源头文件

class CMyDialog : public CDialogImpl<CMyDialog> {

public:

// 1. 关联对话框资源

enum { IDD = IDD_MYDIALOG };

// 2. 消息映射表

BEGIN_MSG_MAP(CMyDialog)

COMMAND_ID_HANDLER(IDOK, OnOK)

COMMAND_ID_HANDLER(IDCANCEL, OnCancel)

END_MSG_MAP()

// 3. 消息处理函数

LRESULT OnOK(WORD wNotifyCode, WORD wID, HWND hWndCtl, BOOL& bHandled) {

EndDialog(IDOK); // 关闭对话框并返回 IDOK

return 0;

}

LRESULT OnCancel(WORD wNotifyCode, WORD wID, HWND hWndCtl, BOOL& bHandled) {

EndDialog(IDCANCEL); // 关闭对话框并返回 IDCANCEL

return 0;

}

};

// 显示模态对话框

CMyDialog dlg;

INT_PTR nResult = dlg.DoModal();

`CFrameWindowImpl`

用途
1. 用于创建应用程序的主窗口，支持菜单、工具栏、状态栏等复杂 UI 元素
继承关系
1. CFrameWindowImpl → CFrameWindowImplBase → CWindowImplBaseT<TBase>
特性
1. 框架布局：支持嵌入子窗口（如视图、工具栏）
2. 消息链（Message Chaining）：通过 CHAIN_MSG_MAP 将消息路由到子控件
3. UI 更新机制：通过 CUpdateUI 自动启用/禁用菜单项和工具栏按钮
场景
1. 应用程序主窗口（如文本编辑器、资源管理器）
2. 多文档界面（MDI）的框架窗口
示例

#include <atlbase.h>

#include <atlapp.h>

#include <atlwin.h>

#include <atlframe.h>

#include <atlctrls.h>

class CMyFrame : public CFrameWindowImpl<CMyFrame> {

public:

// 1. 声明框架窗口类

DECLARE_FRAME_WND_CLASS(L"MyFrameClass", IDR_MAINMENU)

// 2. 消息映射表

BEGIN_MSG_MAP(CMyFrame)

MESSAGE_HANDLER(WM_CREATE, OnCreate)

COMMAND_ID_HANDLER(ID_FILE_EXIT, OnFileExit)

CHAIN_MSG_MAP(CFrameWindowImpl<CMyFrame>) // 继承基类消息处理

END_MSG_MAP()

// 3. 消息处理函数

LRESULT OnCreate(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled) {

// 创建工具栏和状态栏

m_toolbar.Create(m_hWnd, NULL, L"工具栏", ATL_SIMPLE_TOOLBAR_STYLE);

m_statusbar.Create(m_hWnd);

// 初始化 UI

UIAddToolBar(m_toolbar);

UISetCheck(ID_VIEW_TOOLBAR, TRUE);

return 0;

}

LRESULT OnFileExit(WORD wNotifyCode, WORD wID, HWND hWndCtl, BOOL& bHandled) {

PostMessage(WM_CLOSE); // 关闭窗口

return 0;

}

private:

CToolBarCtrl m_toolbar;

CStatusBarCtrl m_statusbar;

};

// 创建并显示主窗口

CMyFrame frame;

frame.Create(NULL, CWindow::rcDefault, L"WTL 主窗口");

frame.ShowWindow(SW_SHOW);

消息映射机制

BEGIN_MSG_MAP(CMyWindow)

MESSAGE_HANDLER(WM_PAINT, OnPaint)

COMMAND_ID_HANDLER(ID_BUTTON_OK, OnOK)

CHAIN_MSG_MAP(CMyParentWindow) // 消息链

END_MSG_MAP()

消息链

将消息路由到父窗口或子控件

BEGIN_MSG_MAP(CMyWindow)

MESSAGE_HANDLER(WM_PAINT, OnPaint)

CHAIN_MSG_MAP_MEMBER(m_childControl) // 将消息传递给子控件

END_MSG_MAP()

消息处理函数

LRESULT OnPaint(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled) {

// 处理 WM_PAINT

bHandled = TRUE;

return 0;

}

动态 UI 更新

CUpdateUI 机制：自动更新菜单项和工具栏状态

BEGIN_MSG_MAP(CMyFrame)

CHAIN_MSG_MAP(CUpdateUI<CMyFrame>)

CHAIN_MSG_MAP(CFrameWindowImpl<CMyFrame>)

END_MSG_MAP()

自定义窗口样式

修改窗口样式：在 PreCreateWindow 中调整 CREATESTRUCT。

BOOL PreCreateWindow(CREATESTRUCT& cs) {

cs.style |= WS_CLIPCHILDREN; // 添加样式

return TRUE;

}

控件封装

常用控件

CButton、CEdit、CListBox、CComboBox。

高级控件

CListViewCtrl、CTreeViewCtrl、CStatusBarCtrl

控件操作

CEdit m_edit;

m_edit.Create(m_hWnd, rcDefault, L"输入框", WS_VISIBLE | WS_CHILD);

m_edit.SetWindowText(L"Hello WTL!");

资源管理

资源文件.rc
1. 定义对话框、菜单、图标等资源
对话框数据交换（DDX）：

BEGIN_DDX_MAP(CMyDialog)

DDX_TEXT(IDC_EDIT_NAME, m_strName)

DDX_CHECK(IDC_CHECK_ENABLE, m_bEnable)

END_DDX_MAP()

高级 UI 功能

多文档界面（MDI）：

CMDIFrameWindowImpl：MDI 主框架
CMDIChildWindowImpl：MDI 子窗口

分割窗口

CSplitterWindow m_splitter;

m_splitter.Create(m_hWnd, rcDefault, NULL, WS_CHILD | WS_VISIBLE);

m_splitter.SetSplitterPane(0, m_leftPane);

m_splitter.SetSplitterPane(1, m_rightPane);

工具栏与状态栏

CToolBarCtrl、CStatusBarCtrl

GDI与绘图

封装类
1. CDC（设备上下文）、CPen、CBrush
双缓冲绘图

CDC memDC;

CBitmap bitmap;

memDC.CreateCompatibleDC(dc);

bitmap.CreateCompatibleBitmap(dc, width, height);

memDC.SelectBitmap(bitmap);

// 在 memDC 上绘制

dc.BitBlt(0, 0, width, height, memDC, 0, 0, SRCCOPY);

多线程与UI

UI线程安全

通过 PostMessage 或 SendMessage 跨线程更新 UI

std::thread([this]() {

// 执行耗时操作

::PostMessage(m_hWnd, WM_USER_UPDATE, 0, (LPARAM)result);

}).detach();

现代 C++ 特性集成

Lambda 表达式：简化消息处理

MESSAGE_HANDLER(WM_TIMER, [](UINT, WPARAM, LPARAM, BOOL&) {

// 处理 WM_TIMER

return 0;

})

智能指针：结合 std::unique_ptr 管理资源

自定义控件与 Owner-Draw

自定义绘制
1. 重写 OnPaint 或响应 WM_DRAWITEM

BEGIN_MSG_MAP(CMyButton)

MSG_WM_DRAWITEM(OnDrawItem)

END_MSG_MAP()

void OnDrawItem(LPDRAWITEMSTRUCT lpDrawItem) {

// 自定义按钮绘制

}

国际化与本地化

多语言资源：通过资源 DLL 切换语言。
动态字符串加载：

1 2	CString strTitle; strTitle.LoadStringW(IDS_TITLE);

示例程序

#include <atlbase.h>

#include <atlapp.h>

#include <atlwin.h>

class CMyWindow : public CWindowImpl<CMyWindow> {

public:

DECLARE_WND_CLASS(L"MyWTLWindow")

BEGIN_MSG_MAP(CMyWindow)

MESSAGE_HANDLER(WM_PAINT, OnPaint)

MESSAGE_HANDLER(WM_DESTROY, OnDestroy)

END_MSG_MAP()

LRESULT OnPaint(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled) {

CPaintDC dc(m_hWnd);

CRect rc;

GetClientRect(&rc);

dc.DrawText(L"Hello WTL!", -1, &rc, DT_CENTER | DT_VCENTER);

bHandled = TRUE;

return 0;

}

LRESULT OnDestroy(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled) {

PostQuitMessage(0);

bHandled = TRUE;

return 0;

}

};

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE, LPSTR, int nCmdShow) {

CMyWindow wnd;

wnd.Create(NULL, CWindow::rcDefault, L"WTL Demo");

wnd.ShowWindow(nCmdShow);

MSG msg;

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

TranslateMessage(&msg);

DispatchMessage(&msg);

}

return 0;

}

WTL下载
WTL 基础概念
定位与优势
WTL 与 ATL 的关系
窗口与消息处理
窗口模板类
CWindow
CWindowImpl
CDialogImpl
CFrameWindowImpl
消息映射机制
消息链
消息处理函数
动态 UI 更新
自定义窗口样式
控件封装
常用控件
高级控件
控件操作
资源管理
高级 UI 功能
多文档界面（MDI）：
分割窗口
工具栏与状态栏
GDI与绘图
多线程与UI
UI线程安全
现代 C++ 特性集成
自定义控件与 Owner-Draw
国际化与本地化
示例程序

本文为原创文章，版权归Aet所有，欢迎分享本文，转载请保留出处！

Bingliaolong 关注：0 粉丝：0

Everything will be better.

一	二	三	四	五	六	日
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

WTL下载

WTL 基础概念

定位与优势

WTL 与 ATL 的关系

窗口与消息处理

窗口模板类

`CWindow`

`CWindowImpl`

`CDialogImpl`

`CFrameWindowImpl`

消息映射机制

消息链

消息处理函数

动态 UI 更新

自定义窗口样式

控件封装

常用控件

高级控件

控件操作

资源管理

高级 UI 功能

多文档界面（MDI）：

分割窗口

工具栏与状态栏

GDI与绘图

多线程与UI

UI线程安全

现代 C++ 特性集成

自定义控件与 Owner-Draw

国际化与本地化

示例程序

你可能也喜欢

热评文章

发表评论

标签云集