WTL开发者指南(4)

最新推荐文章于 2016-10-27 19:49:11 发布

一直学习

最新推荐文章于 2016-10-27 19:49:11 发布

阅读量1.4k

点赞数

文章标签： class c++ mfc 多线程 windows generation

CHyperLink 允许在程序中嵌入web-links，当按下时会打开一个浏览器显示这个URL。

template <class T, class TBase = CWindow,

class TWinTraits = CControlWinTraits>

class CHyperLinkImpl

: public CWindowImpl< T, TBase, TWinTraits >

class CHyperLink : publicCHyperLinkImpl<CHyperLink>

CWaitCursor 可以根据输入参数设置光标，默认值为IDC_WAIT。

class CWaitCursor

CMultiPaneStatusBarCtrl 提供了一个包含了“子分割”的状态条（status bar）不同的“分割”上可以放置不同的文本。

template <class T, class TBase = CStatusBarCtrl>

class CMultiPaneStatusBarCtrlImpl

: public CWindowImpl< T, TBase >

class CMultiPaneStatusBarCtrl

: publicCMultiPaneStatusBarCtrlImpl<CMultiPaneStatusBarCtrl>

Dynamic Data Exchange （altddx.h）

DDX 用来在类的数据成员和对话框控件之间双向交换数据。WTL中的DDX只牵涉到一个模板类CWinDataExchange，和许多和宏，比如DDX_TEXT。

template <class T> class CWinDataExchange

要想使用DDX，你的对话框类应该从CDialogImpl和CWinDataExchange继承并有一个message map，比如

BEGIN_DDX_MAP(CMyDialogDlg)

DDX_INT(IDC_AMOUNT_INT, m_nAmount)

END_DDX_MAP()

目前这个map必须手工创建，但是很有可能在下一版的Visual C++ Wizard中支持通过向导创建（到目前为止VC7仍然不支持——译者注）。

System Dialogs And Property Sheets (atldlgs.h)

WTL 对系统对话框提供了全面的支持

template <class T> class CFileDialogImpl

: public CDialogImplBase

WTL Developer ’s Guide

class CFileDialog : publicCFileDialogImpl<CFileDialog>

template <class T> class CFolderDialogImpl

class CFolderDialog : publicCFolderDialogImpl<CFolderDialog>

class CCommonDialogImplBase : public CWindowImplBase

template <class T> class CFontDialogImpl

: public CCommonDialogImplBase

class CFontDialog : publicCFontDialogImpl<CFontDialog>

class CRichEditFontDialogImpl : publicCFontDialogImpl< T >

class CRichEditFontDialog : public

CRichEditFontDialogImpl<CRichEditFontDialog>

template <class T> class CColorDialogImpl

: public CCommonDialogImplBase

class CColorDialog : publicCColorDialogImpl<CColorDialog>

template <class T> class CPrintDialogImpl

: public CCommonDialogImplBase

class CPrintDialog : publicCPrintDialogImpl<CPrintDialog> template

<class T> class CPrintDialogExImpl

: public CWindow, public CMessageMap,

public IPrintDialogCallback,

public IObjectWithSiteImpl< T >

class CPrintDialogEx : public CPrintDialogExImpl<CPrintDialogEx>

template <class T> class CPageSetupDialogImpl

: public CCommonDialogImplBase

class CPageSetupDialog

: public CPageSetupDialogImpl<CPageSetupDialog>

template <class T> class CFindReplaceDialogImpl

: public CCommonDialogImplBase

class CFindReplaceDialog

: public CFindReplaceDialogImpl<CFindReplaceDialog>

WTL 也为propertysheet提供一系列的支持：

class CPropertySheetWindow : public CWindow

template <class T, class TBase =CPropertySheetWindow>

class CPropertySheetImpl : public CWindowImplBaseT<TBase >

class CPropertySheet : publicCPropertySheetImpl<CPropertySheet>

class CPropertyPageWindow : public CWindow

template <class T, class TBase =CPropertyPageWindow>

class CPropertyPageImpl : public CDialogImplBaseT<TBase >

template <WORD t_wDlgTemplateID> classCPropertyPage

: public CPropertyPageImpl<CPropertyPage<t_wDlgTemplateID>>

Frames (atlframe.h)

下面的类用来支持frames

CFrameWndClassInfo 是frame window的类

class CFrameWndClassInfo

CFrameWindowImpl 是程序级用来管理frames的基本C++类

template <class TBase = CWindow, class TWinTraits =

CFrameWinTraits> class CFrameWindowImplBase

: public CWindowImplBaseT< TBase, TWinTraits >

template <class T, class TBase = CWindow, classTWinTraits =

CFrameWinTraits> class CFrameWindowImpl

: public CFrameWindowImplBase< TBase, TWinTraits >

为了支持MDI，WTL提供了这些类：

class CMDIWindow : public CWindow

template <class T, class TBase = CMDIWindow, classTWinTraits =

CFrameWinTraits>

class CMDIFrameWindowImpl : publicCFrameWindowImplBase<TBase,

TWinTraits >

template <class T, class TBase = CMDIWindow, classTWinTraits =

CMDIChildWinTraits> class CMDIChildWindowImpl

: public CFrameWindowImplBase<TBase, TWinTraits >

COwnerDraw 模板为实现owner draw功能提供帮助。它通常通过多重继承来添加到类中的。COwnerDraw和CCustomDraw是有区别的，CCustomDraw处理通过WM_NOTIFY发送的NM_CUSTOMDRAW通知消息。支持这个通知的有下面的通用控件：

Headers ，list view， rebar，tooltip，trackbar和tree view控件。COwnerDraw处理WM_DRAWITEM，WM_MEASUREITEM，WM_COMPAREITEM和WM_DELETEITEM消息，这些消息一般是发送给owner-draw button，combobox，list view控件或菜单项目（itmes）。

template <class T> class COwnerDraw

CUpdateUI 可以用来动态更新UI元素。菜单项目（items）和toolbar按钮可以用它来实现“可用”和“不可用（禁止）”状态。

class CUpdateUIBase;

template <class T> class CUpdateUI : public CUpdateUIBase

GDI(atlgdi.h)

WTL 提供了管理所有GDI对象的模板。每个模板的逻辑型参数t_bManaged指定这个GDI对象是否在模板的析构函数里被删除（delete）。每个模板有两个typedefs，其中一个t_bManaged置true，另一个置false。这些模板包含了所有的win32 GDI APIs，为它们提供了类型安全的（typesafe）C++接口。

template <bool t_bManaged> class CPenT

typedef CPenT<false> CPenHandle;

typedef CPenT<true> CPen;

template <bool t_bManaged> class CBrushT

typedef CBrushT<false> CBrushHandle;

typedef CBrushT<true> CBrush;

template <bool t_bManaged> class CFontT

typedef CFontT<false> CFontHandle;

typedef CFontT<true> CFont;

template <bool t_bManaged> class CBitmapT

typedef CBitmapT<false> CBitmapHandle;

typedef CBitmapT<true> CBitmap;

template <bool t_bManaged> class CPaletteT

typedef CPaletteT<false> CPaletteHandle;

typedef CPaletteT<true> CPalette;

template <bool t_bManaged> class CRgnT

typedef CRgnT<false> CRgnHandle;

typedef CRgnT<true> CRgn;

template <bool t_bManaged> class CDCT

typedef CDCT<false> CDCHandle;

typedef CDCT<true> CDC;

从CDC还继承出来一些工具类（helperclasses）用来提供额外的功能。CPaintDC用来处理WM_PAINT消息，它在构造函数里调用了Win32的BeginPaint，在析构函数里调用EndPaint。CClientDC和CWindowDC用来取得一个HWND的客户区和窗口DC。CEnhMetaFileDC用来在一个“增强元文件（enhanced metafile）中绘画，它的构造函数调用了Win32的CreateEnhMetaFile，析构函数调用了CloseEnhMetaFile。

class CPaintDC : public CDC

class CClientDC : public CDC

class CWindowDC : public CDC

class CEnhMetaFileDC : public CDC

WTL 还为enhanced metafile提供了额外的支持。CEnhMetaFileT是对一个enhanced metafile句柄的包装。CEnhMetaFileInfo提供了对win32的 GetEnhMetaFileBits 、GetEnhMetaFileDescription ,

GetEnhMetaFileHeader 和 GetEnhMetaFilePixelFormat 的调用

template <bool t_bManaged> class CEnhMetaFileT

typedef CEnhMetaFileT<false> CEnhMetaFileHandle;

typedef CEnhMetaFileT<true> CEnhMetaFile;

class CEnhMetaFileInfo

其他（atlmisch）

WTL 还为常用数据类型提供了包装类。WTL的CString是MFCCString的完美模仿和代替品。还有CSize，CPoint和CRect

class CSize : public tagSIZE

class CPoint : public tagPOINT

class CRect : public tagRECT

class CString;

处理最近文件列表（recent file list）和文件搜索

class CRecentDocumentList;

class CFindFile;

打印（atlprint.h）

WTL 为打印提供了很好的支持。

PrinterInfo 数据被 template <unsigned int t_nInfo> class CPrinterInfo 的支持。下面的模板有来处理打印机句柄：

template <bool t_bManaged> class CPrinterT

typedef CPrinterT<false> CPrinterHandle;

typedef CPrinterT<true> CPrinter;

处理 DEVMODE的模板

template <bool t_bManaged> class CDevModeT;

typedef CDevModeT<false> CDevModeHandle;

typedef CDevModeT<true> CDevMode;

向打印机绘画是使用这个DC类：

class CPrinterDC : public CDC

要获得打印任务（job）的信息，使用

class IPrintJobInfo

class CPrintJobInfo : public IPrintJobInfo

class CPrintJob;

打印预览窗口

class CPrintPreview;

template <class T, class TBase = CWindow, classTWinTraits =

CControlWinTraits>

class CPrintPreviewWindowImpl

:public CWindowImpl<T, TBase, TWinTraits>, publicCPrintPreview

class CPrintPreviewWindow

: publicCPrintPreviewWindowImpl<CPrintPreviewWindow>

滚动（Scrolling）（atlscrl.h）

窗口滚动是被下面这些类和模板支持的:

template <class T> class CScrollImpl

template <class T, class TBase = CWindow,

class TWinTraits = CControlWinTraits>

class CScrollWindowImpl

:public CWindowImpl<T,TBase,TWinTraits>,publicCScrollImpl< T >

template <class T> class CMapScrollImpl: publicCScrollImpl< T >

template <class T, class TBase = CWindow,

class TWinTraits = CControlWinTraits>

class CMapScrollWindowImpl : public CWindowImpl< T,TBase,

TWinTraits >, public CMapScrollImpl< T >

平面分割的滚动条：

template <class TBase = CWindow> class CFSBWindowT

:public TBase, public CFlatScrollBarImpl<CFSBWindowT<TBase > >

typedef CFSBWindowT<CWindow> CFSBWindow;

分割条（splitters）（atlsplit.h ）

水平和垂直的分割条可以用下面的三个模板实现：

template <class T, bool t_bVertical = true> classCSplitterImpl;

template <class T, bool t_bVertical = true, classTBase =

CWindow, class TWinTraits = CControlWinTraits>

class CSplitterWindowImpl : public CWindowImpl< T,TBase, TWinTraits

>, public CSplitterImpl<CSplitterWindowImpl< T ,t_bVertical, TBase,

TWinTraits >, t_bVertical>

template <bool t_bVertical = true> classCSplitterWindowT

: public CSplitterWindowImpl<

CSplitterWindowT<t_bVertical>, t_bVertical>

typedef CSplitterWindowT<true> CSplitterWindow;

typedef CSplitterWindowT<false> CHorSplitterWindow;

菜单（atluser.h）

CMenuItemInfo 类是Win32中MENUITEMINFO结果的包装，CMenuT可以用来管理菜单，它提供了对菜单所有属性的类型安全的访问。

class CMenuItemInfo : public MENUITEMINFO

template <bool t_bManaged> class CMenuT

WTL 中没有什么？

（本节翻译内容并没有完全照搬原文，和原文相比有所删略。——译者注）

在看了WTL中的主要功能后，我们来看看WTL不支持的东西。

WTL 的唯一目标是为开发人员提供用户界面，在这方面它已经做得非常好了。它并没有偏离该目标而设计其他领域。

没有Document支持

WTL 提供了frame和view，但是没有document。WTL所关注的是用户界面，而document是不可见的，所以它不是WTL关心的范围。

没有 Active Document 支持

……

没有ISAPI支持

……

没有WinInet支持

……

没有对线程和同步进行包装

……

没有数据库支持

……

开发的问题

要开始使用WTL，还有下面几个问题需要理解。

最终产品

使用WTL建立的程序体积是很小的，AppWizard生成的默认SDI程序编译后的exe文件大小只有64K，TinyWTL例程由于去掉了多余的功能，编译后只有24K大小。一个真实的商业级程序应该不会超过250K。并且这些文件经过压缩后将会再减少2/3的体积，可以在Internet上快速下载。

在 Build 完成后，如果你没有使用 CRT 和其他的 DirectX 之类的库，那么 WTL 工程编译后的 exe 或 dll 就是你唯一需要发送给最终用户的文件了。 WTL 程序没有额外的依赖。文件少，出现问题的几率就少。

CRT

C-Runtime library 上 Win32 API 之上的一组 C 函数，通常被称作 CRT 。 CRT 的源代码是 VC++ 的一部分（在 src 目录），如果你仔细看一下的话，就会发现这些 CRT 的函数是用 ANSI C 实现的，一些直接调用了 APIs ，一些通过调用中间函数间接调用了 APIs 。 CRT 大部分是来自 ANSI C 标准库的一些函数（ printf ， strok 等），但是也有一些 Win32 平台相关的函数（比如（ beginthreadex 在做了一些 CRT 初始化后调用了 CreateThread API ）

如果你的程序只使用 ANSI C 标准库，你的代码就是可移植的。有许多百万行代码级的工程在经过不到 2 ％的更改后就可以在 Windows 和 UNIX 上顺利通过编译和正常运行。 CRT 确实在某些领域提供了 Win32 所没有的功能，比如 string 形式的浮点数、 C++ 异常和为全局变量调用构造 / 析构函数。

如果你使用 ATL 和 WTL 进行编程，你的代码绝对不可能移植到 UNIX/LINUX 之上，这样有个问题就产生了，我到底有必要连接到 CRT 吗？ CRT 在很大程度上是 Win32 APIs 的重复，所以大部分情况下，大案是“ No ”。离开了 C++ 异常处理和全局变量的构造 / 析构函数，也可以生存，而使用了 CRT ，你的程序体积将增大，并有了额外的外部依赖 (MSVCRT.dll) 而这个库有多个版本，这也可能成为麻烦的根源。

WTLAppWizard 生成的工程的设置使得CRT在debugbuild是可用（为了调用ATLASSERT），而在releasebuild时并不包含进来（预处理指令中的 _ATL_MIN_CRT 宏）。如果你没有注意到这个细节，可能会对“使用了CRT的WTL工程怎么也无法在release模式下编译通过”的问题束手无策。注意：CRT在Release模式下默认是不被包含的。

如果你真的打算使用CRT，只要去掉_ATL_MIN_CRT宏就可以了，（VC7中是把“项目”->“属性”对话框中的“在ATL中最小使用CRT”选项置“否”）。

如果使用了CRT，关于多线程的一个有趣的问题就产生了。CRT有多个版本，一些是静态连接的，一些的动态加载的，一些是用于单线程应用程序的，一些是用于多线程程序的。如果你在不止一个线程中使用CRT，你就必须使用多线程版本的CRT。同一个工程中的所有EXE和DLL也必须使用一致的设置（在DevStudio的 Project settings对话框的Generation类别里）。

错误处理

（本段翻译有删略——译者注）

在WTL程序中要使用C++异常处理，就必须依赖CRT（当然，如果你愿意可以使用）。另外对API可以使用GetLastError和 ATLASSERT

WTL 名称空间（namespace）

新的ISO C++标准引入了名称空间的概念，WTL为了避免和其他类库产生名称冲突，它的每一个头文件都是以下面的代码开始：

namespace WTL

{

并以：

}; //namespace WTL

结束

……

（省略关于名称空间的使用的说明——译者）