翻译：原文地址

一、关于Win32++

​        本文档描述了Win32++9.1版的功能。若要下载Win32++的程序清单，可以点击这里。

        Win32++是一个用于构建windows应用程序的C++库。Win32++是MFC的免费替代品。它还有一个额外的优势，即能够在各种免费编译器上运行，包括Visual Studio Community、Clang以及CodeBlocks和Dev-C++提供的MinGW编译器。

        Win32++在Windows API上提供了一个简单的封装，与MFC类似。然而，MFC有几个不同之处。Win32++使用很少的宏，并且不将宏用于消息映射。Win32++的所有代码都在一组头文件中提供。Win32++有视图窗口，但没有将Doc/view结构暴露给用户。当然，用户也可以自由使用Doc/View架构。

        Win32++支持所有Windows操作系统，从Windows 95到Windows 11和Windows Server 2022。

二、前言  

        Win32++由用于创建窗口应用程序的C++库组成。它是MFC的免费替代品，可用于更广泛的编译器，包括Borland、Microsoft和MinGW的编译器。该库可用于创建各种程序，包括简单的窗口、对话框、属性表以及框架和MDI框架应用程序。教程部分提供了有关如何使用这些类构建自己的Win32应用程序的信息。

        基于框架的应用程序通常有一个通用框架窗口，该窗口可能有例如菜单、工具栏和状态栏，并且在客户端区域上有一个单独的窗口（有时称为视图窗口）。您熟悉的许多windows应用程序都可能是基于框架的应用程序。您可以使用此库不仅生成简单的窗口和对话框，还可以生成外观专业的基于框架的应用程序，包括菜单、工具栏、状态栏和工具提示。

三、Win32++程序特点

        Win32++提供了一个直接使用Windows API开发应用程序的库。它支持所有运行32位和64位Windows的MS操作系统，从Windows 95到Windows 10和Server 2019。Win32++旨在生成与使用MFC创建的程序外观相似的程序。该库可以开发基于简单窗口、对话框、框架和MDI框架的应用程序。Win32++架构有如下特点：

• Rebar control 
• MenuBar  菜单栏(a menu housed inside the rebar control).
• ToolBar  工具栏
• Status bar 状态栏
• Tool tips 工具提示
• Docking  

        Win32++还为直接使用Windows API进行编程提供了一种面向对象的方法。创建的每个窗口都是一个C++类对象，能够有自己的窗口程序来处理路由消息。

        所有Win32++的功能特点可参考原文。

四、开发环境准备

4.1 Win32++必备技能

        为了使用Win32++，您需要以下各项：

• C++编译器 A C++ compiler.
• C++的知识Some knowledge of C++, including how to use classes
• Windows API文档 Documentation for the Windows API.

4.2  代码和工具

        框架库和例子代码可以在这里下载。示例包括Visual Studio 6、Visual Studio Net 2003、VS2013、VS2015、VS2019、Dev-C++和CodeBlock。如果您使用的是其中一个，那么样本是预先配置好的，可以编译了。

        如果您是C++编程新手，并且正在寻找一个免费的编译器来使用，我建议您使用Microsoft's Visual Studio Community。我发现这个编译器是最容易设置和使用的免费编译器。Visual Studio社区包括Windows 7和DirectX11 SDK，以及C++和Windows API文档。

        如果您使用的是较旧的Microsoft Visual Studio 6.0编译器，则可能还需要安装并合并Platform SDK。

五、Win32++如何工作

5.1 使用Win32++

        构成Win32++基础的代码位于include目录中。您不需要修改这些文件，而是从Win32++类继承，并在派生类中添加任何其他代码。例如，要创建SDI（单窗口）架构窗口，通常需要从CFrame派生自己的类，并把对标准框架的任何修改放在你自己类中。您可以重写WndProc成员函数，以包含您想要处理的任何其他消息。

        一个单独的视图窗口放置在框架窗口的工作区上。通常，此视图窗口是通过从CWnd继承类来创建的。CFrame:：SetView函数用于将视图窗口分配给框架。但是，对于MDI（多窗口）框架，CMDIFrame已经使用CMDIClient作为视图窗口，您可以使用CMDIFrame:：AddMDIChild创建MDI子窗口的新实例。

5.2 面向对象方法

        将面向对象的方法直接应用于Windows API编程的关键是要有一个C++类，它可以创建一个窗口，并包含自己的窗口过程作为成员函数。一旦我们有了这个类，我们就可以从它继承并重写窗口过程成员函数，以我们希望的方式处理每个派生窗口类型的消息。

        创建这样的类并不简单，我怀疑这是MFC最初创建的原因之一。问题源于在创建窗口之前注册“窗口类”的方式。（这里的“类”一词指的是Windows API“窗口类”，与C++类不同。）以下代码片段显示了如何使用API注册窗口类：

WNDCLASSEX wc;
memset((WNDCLASSEX*)&wc, 0, sizeof(WNDCLASSEX));

wc.cbSize = sizeof(WNDCLASSEX);
//The name of the window procedure
wc.lpfnWndProc = WindowProc;
wc.hInstance = hInstance;
wc.lpszClassName = "TEST";
wc.hbrBackground = (HBRUSH)(COLOR_WINDOW + 1);

//Register the window class
::RegisterClassEx(&wc);

        注意，我们需要提供窗口执行程序的函数名。窗口执行程序是我们控制接收到窗口消息时要做什么的过程。此函数必须完全符合Windows API所需的预定义标准。回调函数的典型声明如下：

LRESULT CALLBACK WindowProc(HWND wnd, UINT msg, WPARAM wparam, LPARAM lparam);

        我们可能会尝试将WindowProc函数设置为类的成员。不幸的是，每个类成员函数都有一个隐式this指针作为其参数之一，因此不能用作窗口的回调函数。如果这样做，WindowProc函数将不再符合预定义的标准，程序将无法编译。

        我们可以使WindowProc函数成为类的静态成员函数。在静态函数中没有隐式this，这将正确编译。不幸的是，静态成员函数不能访问类对象（即，它没有this指针），也不能访问类的其他成员。正是这一点防止了静态成员函数以面向对象的方式使用。以下代码演示了静态成员函数方法的局限性：

class TestStatic
{
public:
  int member;

  void NormalFunction()
  {
    //We can access member variables in a normal
    //member function
    member = 5;

    //The following line is equivalent to the one above
    this->member = 5;
  }

  void static StaticFunction()
  {
    //We cannot access member variables
    //in a static member function
    //The following line will give a compile error
    member = 5;

    //This will give an error too
    this->member = 5;
  }
};

        如果我们能够获得指向窗口类对象的指针（this指针），那么窗口执行程序的静态成员函数将非常有用。在创建窗口时，我们可以使用许多技术来访问指针。我选择的一个利用线程本地存储Thread Local Storage 来存储我们的指针，稍后将其插入STL（STL 是 C++ 通用库，由迭代器、算法、容器、仿函数、配接器和内存配置器组成）映射中。下面代码是如何做到的：

5.2.1 步骤一: 在CWinApp类中装载/安装线程本地存储（st_dwTlsIndex ）以存储this指针:  

CWinApp::CWinApp(HINSTANCE instance) : m_instance(instance)
{
  if (GetApp() == 0)
  {
    st_dwTlsIndex = ::TlsAlloc();

    //snip

    }
}

5.2.2 Step 2步骤二: 当CreateEx类创建窗口时，将this指针存储在线程本地存储（Thread Local Storage）中 ：

// Ensure this thread has the TLS index set
TLSData* pTLSData = GetApp()->SetTlsIndex();

// Store the CWnd pointer in thread local storage
pTLSData->pCWnd = this;

5.2.3 Step 3步骤三: 在初始创建窗口期间，从线程本地存储中提取指针并将其添加到STL映射中： 

// Retrieve the pointer to the TLS Data
TLSData* pTLSData = (TLSData*)TlsGetValue(GetApp()->GetTlsIndex());

// Retrieve pointer to CWnd object from Thread Local Storage TLS
w = pTLSData->pCWnd;

// Store the CWnd pointer in the HWND map
GetApp()->AddToMap(hwnd, w);

return w->WndProc(msg, wparam, lparam);

5.2.4 Step 4步骤四: 对于每个后续的窗口消息，我们从STL映射中提取指针，并使用它将消息处理重定向到适当的WndProc函数：

CWnd* w = GetApp()->GetCWndFromMap(hwnd);
return w->WndProc(msg, wparam, lparam);

5.2.5 详细的Window创建  

        现在我们已经了解了窗口过程，是时候在创建窗口时看看这些程序是如何组合在一起的了。这是创建窗口的代码：

inline HWND CWnd::CreateEx(DWORD exStyle, LPCTSTR pClassName, LPCTSTR pWindowName, 
                             DWORD style, int x, int y, int width, int height, HWND parent, 
                             HMENU idOrHMenu, LPVOID lparam /*= NULL*/)
// Creates the window by specifying all the window creation parameters
{
    assert( GetApp() );        // Test if Win32++ has been started
    assert( !IsWindow() );     // Only one window per CWnd instance allowed

    // Ensure a window class is registered
    CString className;
    if (pClassName == 0 || pClassName[0] == _T('\0'))
        className = _T("Win32++ Window");
    else
        className = pClassName;

    WNDCLASS wc;
    ZeroMemory(&wc, sizeof(wc));
    wc.lpszClassName = className;
    wc.hbrBackground = reinterpret_cast(::GetStockObject(WHITE_BRUSH));
    wc.hCursor       = ::LoadCursor(NULL, IDC_ARROW);

    // Register the window class (if not already registered)
    if (RegisterClass(wc) == 0)
    {
        TRACE("*** RegisterClass failed ***\n");
        assert( false );
    }

    // Ensure this thread has the TLS index set
    TLSData* pTLSData = GetApp()->SetTlsData();

    // Store the CWnd pointer in thread local storage
    pTLSData->pWnd = this;
    m_wnd = 0;

    // Create window
    HWND wnd = ::CreateWindowEx(exStyle, className, pWindowName, style, x, y, width, height,
                                hWParent, idOrMenu, GetApp()->GetInstanceHandle(), lparam);

    // Tidy up
    pTLSData->pWnd = NULL;

    if (wnd == 0)
    {
        // Throw an exception when window creation fails
        throw CWinException(g_msgWndCreateEx);
    }

    // Automatically subclass predefined window class types
    if (pClassName)
    {
        ::GetClassInfo(GetApp()->GetInstanceHandle(), pClassName, &wc);
        if (wc.lpfnWndProc != GetApp()->m_callback)
        {
            Subclass(wnd);

            // Override this to perform tasks after the window is attached.
            OnAttach();
        }
    }

    // Clear the CWnd pointer from TLS
    pTLSData->pWnd = NULL;

    // Post a message to trigger a call of OnInitialUpdate
    PostMessage(UWM_WINDOWCREATED);

    return wnd;
}

        下一个代码段是第一次接收消息的窗口过程。我们从映射中提取指向CWnd对象的指针，并使用它将窗口消息的处理重定向到适当的WndProc函数：

inline LRESULT CALLBACK CWnd::StaticWindowProc(HWND wnd, UINT msg, WPARAM wparam, LPARAM lparam)
// All CWnd windows direct their messages here. This function redirects the message
// to the CWnd's WndProc function.
{
    assert( GetApp() );

    CWnd* w = GetApp()->GetCWndFromMap(wnd);
    if (w == 0)
    {
        // The CWnd pointer wasn't found in the map, so add it now

        // Retrieve the pointer to the TLS Data
        TLSData* pTLSData = GetApp()->GetTlsData();
        assert(pTLSData);

        if (pTLSData)
        {
            // Retrieve pointer to CWnd object from Thread Local Storage TLS
            w = pTLSData->pWnd;
            assert(w);              // pTLSData->pCWnd is assigned in CreateEx
            if (w)
            {
                pTLSData->pWnd = NULL;

                // Store the CWnd pointer in the HWND map
                w->m_wnd = wnd;
                w->AddToMap();
            }
        }
    }

    return w->WndProc(msg, wparam, lparam);

}

        最后，下一个代码段显示StaticWindowProc调用的函数。通常，当我们从CWnd派生一个新类时，我们会重写这个函数来控制各种窗口消息的处理方式：

inline LRESULT CWnd::WndProc(UINT msg, WPARAM wparam, LPARAM lparam)
{
    // Override this function in your class derived from CWnd to handle
    //  window messages. A typical function might look like this:

    //	switch (msg)
    //	{
    //	case MESSAGE1:  return OnMessage1();
    //	case MESSAGE2:  return OnMessage2();
    //	}

    // The message functions should return a value recommended by the Windows API documentation.
    // Alternatively, return FinalWindowProc to continue with default processing.

    // Always pass unhandled messages on to WndProcDefault
    return WndProcDefault(msg, wparam, lparam);
}

        使用该技术，我们能够将每个窗口消息转发到适当的CWnd对象。即使在创建窗口期间，也不会丢弃任何消息。该技术还支持所有窗口类型，包括对话框、通用控件、MDI框架和属性表。

六、示例教程

6.1 一个简单窗口 The Simplest Window

#define _WIN32_WINDOWS  0x0410
#define _WIN32_IE       0x0401

#include "wxx_wincore.h"

// Note:
//  * Add the Win32++\include  directory to project's additional include directories


//
// CMyWindow is the application's main window.
class CMyWindow : public CWnd
{
public:
    CMyWindow() {}
    virtual void OnDestroy() { PostQuitMessage(0); }    // Ends the program
    virtual ~CMyWindow() {}
};


// WinMain is the program's entry point. The program starts here.
//此处和window的主入口程序调用一致
int WINAPI WinMain(HINSTANCE, HINSTANCE, LPSTR, int)
{
    // Start Win32++
    CWinApp theApp;

    // Create a CMyWindow object
    CMyWindow myWindow;

    // Create (and display) the window
    myWindow.Create();

    // Run the application's message loop
    return theApp.Run();
}

        此处的 int WINAPI WinMain(HINSTANCE, HINSTANCE, LPSTR, int)和window定义的主入口程序一致。

        该程序有四个关键步骤：

• 启动Win32++。 我们在这里通过创建一个名为MyApp的CWinApp对象来实现这一点。
• 创建名为myWindow的CMyWindow对象。
• 通过调用Create函数创建默认窗口。 
• 通过调用Run函数启动消息循环。

        CMyWindow类继承自CWnd。CWnd是用于创建窗口的所有对象的基类。当窗口关闭时，我们重写CWnd的OnDestroy函数以结束程序。

6.2 使用继承创建窗口 Using Classes and Inheritance

        上一教程中的程序直接调用CWinApp类。然而，通常情况下，我们会从这个类继承，以便对我们创建的CWinApp对象的类型有更多的控制权。

        下面是我们如何从CWinApp派生类的示例。

// A class that inherits from CWinApp. 
// It is used to run the application's message loop.
class CSimpleApp : public CWinApp
{
public:
    CSimpleApp() {}
    virtual ~CSimpleApp() {}
    virtual BOOL InitInstance();

private:
    CView m_View;
};

BOOL CSimpleApp::InitInstance()
{
    // Create the Window
    m_View.Create();

    return TRUE;
}

        请注意，我们重写InitInstance方法以确定应用程序启动时发生的情况。在本例中，我们为m_View成员变量创建窗口。m_View成员变量是从CWnd继承的CView对象。CView的代码如下所示。

//  Add the Win32++\include  directory to project's additional include directories

#include "wxx_wincore.h"


// A class that inherits from CWnd. It is used to create the window.
class CView : public CWnd
{
public:
    CView() {}
    virtual void OnDestroy() { PostQuitMessage(0); } // Ends the program
    virtual ~CView() {}
};

        CSimpleApp和CView类在WinMain中使用如下

int APIENTRY WinMain(HINSTANCE, HINSTANCE, LPSTR, int)
{
    // Start Win32++
    CSimpleApp MyApp;

    // Run the application
    return MyApp.Run();
}

6.3 简单涂鸦程序 Using Messages to Create a Scribble Window

        窗口可能需要响应的每个外部事件都通过消息发送到窗口。现在是时候通过处理这些消息来控制窗口的行为了。每个CWnd对象在WndProc函数中处理自己的消息。在本例中，我们将通过处理鼠标左键消息来创建一个简单的涂鸦程序。我们允许用户通过响应鼠标消息在窗口上绘制。当用户在按下鼠标左键的同时移动鼠标时，将在窗口上绘制一条线。

        单击左按钮时，WM_LBUTTONDOWN消息将发送到窗口，并且光标位于窗口的工作区上。我们捕获鼠标输入并将当前鼠标位置存储在m_oldPt成员变量中。

        光标移动时，WM_MOUSEMOVE消息将发布到窗口。如果未捕获鼠标，则消息将发布到包含光标的窗口。否则，消息将发布到捕获鼠标的窗口。我们检查左按钮是否也向下，并调用DrawLine在视图窗口中绘制线。

        在鼠标捕获期间，当鼠标左键从向下变为向上时，WM_LBUTTONUP消息将发送到窗口。

        窗口通过其窗口过程接收消息。我们拦截这些消息，并通过重写WndProc函数来采取自己的行动。

LRESULT CView::WndProc(UINT msg, WPARAM wparam, LPARAM lparam)
{
  switch (uMsg)
  {
    case WM_LBUTTONDOWN: 	return OnLButtonDown(msg, wparam, lparam);
    case WM_MOUSEMOVE:	return OnMouseMove(msg, wparam, lparam);
    case WM_LBUTTONUP:	return OnLButtonUp(msg, wparam, lparam);
  }

  //Use the default message handling for remaining messages
  return WndProcDefault(msg, wparam, lparam);
}

        以下是WndProc中使用的函数的定义。当收到WM_LBUTTONDOWN消息时，我们使用SetCapture捕获鼠标输入。这允许我们的窗口接收鼠标消息，即使鼠标光标移动到我们的窗口之外。当释放鼠标左键时，我们停止使用ReleaseCapture捕捉鼠标输入。

LRESULT CView::OnLButtonDown(UINT, WPARAM, LPARAM lparam)
{
  // Capture mouse input.
  SetCapture();

  m_oldPt.x = GET_X_LPARAM(lparam);
  m_oldPt.y = GET_Y_LPARAM(lparam);

  return 0;
}

LRESULT CView::OnLButtonUp(UINT, WPARAM, LPARAM lparam)
{
  UNREFERENCED_PARAMETER(lparam);

  //Release the capture on the mouse
  ReleaseCapture();

  return 0;
}

LRESULT CView::OnMouseMove(UINT, WPARAM wparam, LPARAM lparam)
{
  // hold down the left mouse button and move mouse to draw lines.
  if (wparam & MK_LBUTTON)
  {
    DrawLine(GET_X_LPARAM(lparam), GET_Y_LPARAM(lparam));
    m_oldPt.x = GET_X_LPARAM(lparam);
    m_oldPt.y = GET_Y_LPARAM(lparam);
  }

  return 0;
}

 运行效果如下：

6.4 重新绘制窗口 Repainting the Window

        上一个示例未能重新绘制窗口。每当窗口被调整大小、从最小化状态恢复或窗口的一部分被另一个窗口覆盖后显示时，都需要重新绘制窗口。

        Windows API自动处理重新绘制。当窗口的一部分需要重新绘制时，窗口会向应用程序发送WM_PAINT消息。通常，您将使用代码来响应此消息，以重新绘制窗口的整个工作区。您不必担心需要重新绘制工作区的哪些部分，因为windows会自动为您处理这一部分。

        Win32++已包含处理CWnd:：WndProc中WM_PAINT消息的代码。我们需要做的就是编写OnDraw函数。对于我们这里的应用程序，我们可以将各个点存储在一个向量中，并让OnDraw函数再次绘制这些线。存储点的函数如下所示。

void CView::StorePoint(int x, int y, bool PenDown)
{
  PlotPoint P1;
  P1.x = x;
  P1.y = y;
  P1.PenDown = PenDown;

  m_points.push_back(P1); //Add the point to the vector
}

        OnDraw函数如下所示。

void CView::OnDraw(CDC& dc)
{
  if (m_points.size() > 0)
  {
    bool bDraw = false;  //Start with the pen up

    for (unsigned int i = 0 ; i < m_points.size(); i++)
    {
      if (bDraw) 
        dc.LineTo(m_points[i].x, m_points[i].y);
      else
        dc.MoveTo(m_points[i].x, m_points[i].y);

      bDraw = m_points[i].PenDown;
    }	
  }
}

6.5 给涂鸦程序一个框架 Wrapping a Frame around our Scribble Window

      本节生成简单框架应用程序。我们从Win32++中的CFrame类继承了一个名为CMainframe的类。注意我们如何使用SetView函数来指定框架的“视图”窗口。这个“视图”窗口恰好是与上一教程中显示的简单涂鸦应用程序相同的代码。通过这种方式，我们在之前的涂鸦应用程序周围包装一个框架。

HWND CMainFrame::Create(HWND parent)
{
    // Set m_View as the view window of the frame
    SetView(m_view);

    return CFrame::Create(parent);
}

        CMainFrame类从CFrame继承OnCommand。此功能响应框架菜单和工具栏的输入。我们还没有实现许多这些输入，所以在这个阶段，大多数输入只是显示一个简单的消息框。

BOOL CMainFrame::OnCommand(WPARAM wparam, LPARAM lparam)
{
  UNREFERENCED_PARAMETER(lparam);

  // Process the messages from the Menu and Tool Bar
  switch (LOWORD(wparam))
  {
    case IDM_FILE_NEW:	  return OnFileNew();
    case IDM_FILE_OPEN:	  return OnFileOpen();
    case IDM_FILE_SAVE:	  return OnFileSave();
    case IDM_FILE_SAVEAS:	  return OnFileSaveAs();
    case IDM_FILE_PRINT:	  return OnFilePrint();
    case IDW_VIEW_STATUSBAR:  return OnViewStatusBar();
    case IDW_VIEW_TOOLBAR:	  return OnViewToolBar();
    case IDM_HELP_ABOUT:	  return OnHelp();
    case IDM_FILE_EXIT:	  return OnFileExit();
  }

  return FALSE;
}

与6.3 比较增加了图标和菜单运行效果如下：

 菜单资源如下图：

6.6 定制化窗口创建 Customising Window Creation

        到目前为止，我们使用Win32++提供的默认参数来创建视图窗口。在这里，我们使用PreRegisterClass在创建窗口之前指定Window Class（不要与C++类混淆）参数。这将允许我们创建一个带有彩色背景的窗口并设置其光标。

void CView::PreRegisterClass(WNDCLASS &wc)
{
  // Set the background brush and cursor
  wc.hbrBackground = m_brush;
  wc.lpszClassName = "Scribble Window";
  wc.hCursor = GetApp()->LoadCursor(IDC_CURSOR1);
}

        我们还可以使用PreCreate为窗口的边框提供凹陷边缘，从而使其具有3D外观。

void CView::PreCreate(CREATESTRUCT &cs)
{
  // Set the extra style to provide a sunken edge
  cs.dwExStyle = WS_EX_CLIENTEDGE;
}

        PreRegisterClass中使用的游标IDC_CURSOR1在resource.rc中指定。资源rc文件是我们的资源脚本，包含各种窗口资源的规范，如位图、对话框、光标、图标、菜单等。资源rc被编译并链接到我们的应用程序中。下面是资源文件中指定的游标。

/
//
// Cursor
//

IDC_CURSOR1             CURSOR                  "res/Cursor.cur"

        我们在CView的构造函数中创建背景笔刷。画笔是一个CBrush对象，当调用其析构函数时，它会自动删除画笔。代码展示了笔刷创建。

// Constructor
CView::CView() : m_penColor(RGB(0,0,0))
{
   m_brush.CreateSolidBrush(RGB(255,255,230));
}

        背景颜色和光标如下图： 

6.7  定制化工具栏 Customising the ToolBar

        我们的框架窗口顶部有一个菜单和一个工具栏。自定义菜单相对简单，因为我们可以使用资源编辑器来执行该任务。然而，自定义工具栏是另一回事。虽然Microsoft Visual Studio附带的资源编辑器可以编辑工具栏资源，但这不是标准的，因此我们需要提出一种符合标准的修改工具栏的方法。

        要为应用程序设置自己的工具栏，需要执行以下步骤：

• 修改工具栏位图。Modify the toolbar bitmap.

• 将工具栏资源ID添加到字符串表中。Add the toolbar resource IDs to to the string table.

• 将资源ID分配给工具栏按钮，如下所示。Assign resource IDs to the toolbar buttons, as shown below.

void CMainFrame::SetupToolBar()
{
  // Define our toolbar
  AddToolBarButton( IDM_FILE_NEW   );
  AddToolBarButton( IDM_FILE_OPEN  );
  AddToolBarButton( IDM_FILE_SAVE  );
  AddToolBarButton( 0 );				// Separator
  AddToolBarButton( IDM_EDIT_CUT,   FALSE );
  AddToolBarButton( IDM_EDIT_COPY,  FALSE );
  AddToolBarButton( IDM_EDIT_PASTE, FALSE );
  AddToolBarButton( IDM_FILE_PRINT );
  AddToolBarButton( 0 );				// Separator
  AddToolBarButton( IDM_PEN_COLOR );
  AddToolBarButton( 0 );				// Separator
  AddToolBarButton( IDM_HELP_ABOUT );
  
  // Note: By default a single bitmap with a resource ID of IDW_MAIN and
  //       a color mask of RGB(192,192,192) is used for the ToolBar. 
  //       The color mask is a color used for transparency.
}

     Windows提供了ChooseColor函数。此功能显示一个对话框，允许我们为笔选择颜色。使用ChooseColor的代码如下：

void CMainFrame::OnPenColor()
{
  // array of custom colors, initialized to white
  static COLORREF custColors[16] = { RGB(255,255,255), RGB(255,255,255), RGB(255,255,255), RGB(255,255,255),
                                     RGB(255,255,255), RGB(255,255,255), RGB(255,255,255), RGB(255,255,255),
                                     RGB(255,255,255), RGB(255,255,255), RGB(255,255,255), RGB(255,255,255),
                                     RGB(255,255,255), RGB(255,255,255), RGB(255,255,255), RGB(255,255,255) };

  CColorDialog colorDlg;
  ColorDlg.SetCustomColors(custColors);

  // Initialize the Choose Color dialog
  if (colorDlg.DoModal(*this) == IDOK)
  {
    // Store the custom colors in the static array
    memcpy(custColors, colorDlg.GetCustomColors(), 16*sizeof(COLORREF));

    // Retrieve the chosen color
    m_view.SetPenColor(colorDlg.GetColor());
  }
}

  运行效果如下：

6.8 文件加载和保存 Loading and Saving Files

        在节教程中，我们将演示如何将数据保存到文件中，然后再次加载。

6.8.1 在CView和CDoc之间传输数据

        在上一节教程中，我们的绘图点数据存储在CView的向量成员变量中。在本教程中，我们将这些数据移动到CDoc类。将数据加载并保存到磁盘文件的代码也添加到CDoc中。像这样从视图中分离数据通常被称为文档/视图体系结构。

        我们的CDoc类是CView类的成员变量。

class CMainFrame : public CFrame
{
public:
  CMainFrame();
  virtual ~CMainFrame();

  CDoc& GetDoc() { return m_view.GetDoc(); }
  void LoadFile(LPCTSTR str);
  
  LRESULT OnDropFile(WPARAM wparam);

  void OnFileExit();
  void OnFileNew();
  void OnFileOpen();
  void OnFilePrint();
  void OnFileSave();
  void OnFileSaveAs();
  void OnPenColor();

protected:
  virtual BOOL OnCommand(WPARAM wparam, LPARAM lparam);
  virtual void SetupToolBar();
  virtual LRESULT WndProc(UINT msg, WPARAM wparam, LPARAM lparam);

private:
  CView m_view;
  CString m_pathName;

};

        我们的CView类将PlotPoint数据存储在CDoc中。它使用以下函数访问CDoc. CView::GetDoc 返回对CDoc的引用，而CView::GetPoints返回对包含PlotPoints的向量的引用

CDoc& CView::GetDoc()
{
  return m_doc;
}

std::vector& CView::GetAllPoints()
{ 
  return GetDoc().GetAllPoints(); 
}

6.8.2 保存数据

        要保存数据，我们执行以下步骤：

• 使用CFileDialog打开对话框，并选择要将数据保存到的文件名。 
• 使用CArchive将数据写入文件。

        下面代码段显示如何使用SaveFileDialog函数选择要写入的文件。

void CMainFrame::OnFileSaveAs()
{
  CFileDialog fileDlg(FALSE, _T("dat"), 0, OFN_OVERWRITEPROMPT, _T("Scribble Files (*.dat)\0*.dat\0\0"));
  fileDlg.SetTitle(_T("Save File"));

  // Bring up the file open dialog retrieve the selected filename
  if (fileDlg.DoModal(*this) == IDOK)
  {
    CString str = fileDlg.GetPathName();

    // Save the file
    if (GetDoc().FileSave(str))
    {
      // Save the file name
      m_pathName = str;
      AddMRUEntry(m_pathName);
    }
  }
}

        下一段代码演示了如何将CDoc的内容写入存档。请注意，写入存档失败会引发FileException。在这里，如果写入存档失败，我们使用捕获来显示相关信息。 

BOOL CDoc::FileSave(LPCTSTR szFilename)
{
  BOOL isFileSaved = FALSE;

  try
  {
    CArchive ar(szFilename, CArchive::store);
    ar << *this;
    isFileSaved = TRUE;
  }
  catch (const CFileException &e)
  {
    // An exception occurred. Display the relevant information.
    ::MessageBox(NULL, e.GetText(), _T("Failed to Save File"), MB_ICONWARNING);
  }

  return isFileSaved;
}

        CDoc继承自CObject。CDoc提供了一个虚拟Serialize函数，我们可以重写该函数来定义CDoc类在存档中的存储方式。在我们定义的Serialize函数中，CArchive的IsStorageing函数用于测试存档是否正在加载或存储，以便我们可以采取适当的操作。

        这是CDoc的Serialize函数。存储时，我们首先存储PlotPoint的数量，然后存储包含每个PlotPoint的ArchiveObject。加载时，我们读取PlotPoint的数量，然后读取包含每个PlotPoint的ArchiveObject。然后将PlotPoints推到我们的向量中。

void CDoc::Serialize(CArchive& ar)
// Uses CArchive to stream data to or from a file
{

  if (ar.IsStoring())
  {
    // Store the number of points
    UINT points = GetPoints().size();
    ar << points;
		
    // Store the PlotPoint data
    std::vector::iterator iter;
    for (iter = GetPoints().begin(); iter < GetPoints().end(); ++iter)
    {
      ArchiveObject ao( &(*iter), sizeof(PlotPoint) );
      ar << ao;
    }
  }
  else
  {
    UINT points;
    PlotPoint pp = {0};
    GetPoints().clear();

    // Load the number of points
    ar >> points;

    // Load the PlotPoint data
    for (UINT u = 0; u < points; ++u)
    {
      ArchiveObject ao( &pp, sizeof(pp) );
      ar >> ao;
      GetPoints().push_back(pp);
    }
  }

}

6.8.3 加载数据

        从文件中读取数据的过程相当类似。涉及的步骤如下：

• 使用CFile::OpenFileDialog打开对话框并选择要加载的文件。
• 使用CArchive从文件中检索数据。

        下面的代码段演示了如何使用OpenFileDialog选择要加载的文件。

void CMainFrame::OnFileOpen()
{
  CFileDialog fileDlg(TRUE, _T("dat"), 0, OFN_FILEMUSTEXIST, _T("Scribble Files (*.dat)\0*.dat\0\0"));
  fileDlg.SetTitle(_T("Open File"));

  // Bring up the file open dialog retrieve the selected filename
  if (fileDlg.DoModal(*this) == IDOK)
  {
    // Load the file
    LoadFile(fileDlg.GetPathName());
  }
}

        下面代码从所选文件的内容加载PlotPoint矢量的代码。如果归档文件未能写入文件，我们再次捕获异常并显示结果。

void CMainFrame::LoadFile(LPCTSTR fileName)
{
  // Retrieve the PlotPoint data
  if (GetDoc().FileOpen(fileName))
  {
    // Save the filename
    m_fileName = fileName;
  }
  else
    m_filehName=_T("");

  GetView().Invalidate();
}

BOOL CDoc::FileOpen(LPCTSTR fileName)
{
  GetPoints().clear();
  BOOL isFileOpened = FALSE;

  try
  {
    CArchive ar(fileName, CArchive::load);
    ar >> *this;
    isFileOpened = TRUE;
  }

  catch (const CWinException& e)
  {
    // An exception occurred. Display the relevant information.
    ::MessageBox(NULL, e.GetText(), _T("Failed to Load File"), MB_ICONWARNING);
		
    GetPoints().clear();
  }

  return isFileOpened;
}

 6.8.4 支持文件拖拉 

        加载文件的另一种方法是将其拖拉到视图窗口中。这就是所谓的拖放。支持拖放所需的步骤如下：

• 在 CView::OnCreate方法中增加DragAcceptFiles支持

int CView::OnCreate(CREATESTRUCT&)
{
  // Support Drag and Drop on this window
  DragAcceptFiles(TRUE);
  return 0;
}

• 将WM_DROPFILES消息的处理程序添加到CView::WndProc 

LRESULT CView::WndProc(UINT msg, WPARAM wparam, LPARAM lparam)
{
  switch (uMsg)
  {
    case WM_DROPFILES:	return OnDropFiles(msg, wparam, lparam);
    case WM_LBUTTONDOWN:	return OnLButtonDown(msg, wparam, lparam);
    case WM_MOUSEMOVE:	return OnMouseMove(msg, wparam, lparam);
    case WM_LBUTTONUP:	return OnLButtonUp(msg, wparam, lparam);
  }

  //Use the default message handling for remaining messages
  return WndProcDefault(msg, wparam, lparam);
}

• 添加 CView::OnDropFiles成员函数。  

LRESULT CView::OnDropFiles(UINT msg, WPARAM wparam, LPARAM lparam)
{
  UNREFERENCED_PARAMETER(msg);
  UNREFERENCED_PARAMETER(lparam);

  HDROP drop = (HDROP)wparam;
  UINT length = DragQueryFile(drop, 0, 0, 0);

  if (length > 0)
  {
    CString fileName;
    DragQueryFile(drop, 0, fileName.GetBuffer(length), length+1);
    fileName.ReleaseBuffer();

    // Send a user defined message to the frame window
    GetParent().SendMessage(UWM_DROPFILE, (WPARAM)fileName.c_str(), 0);

    DragFinish(drop);
  }

  return 0;
}

6.9 打印Printing

        在本节教程，我们将演示如何将位图发送到打印机。本例中的位图将是我们在视图窗口中绘制的位图。生成的打印输出将调整大小以匹配原始图形的大小。此任务可分为几个步骤：

6.9.1 从视图窗口提取位图

        当我们在视图窗口上绘制时，实际上是在绘制附加到视图窗口的设备上下文的位图。在这里，我们将此位图复制到兼容位图 compatible bitmap。

   // Copy the bitmap from the View window
  CClientDC viewDC(GetView());
  CMemDC memDC(viewDC);
  memDC.CreateCompatibleBitmap(viewDC, width, height);
  memDC.SelectObject(viewBitmap);
  memDC.BitBlt(0, 0, width, height, viewDC, 0, 0, SRCCOPY);
  CBitmap bmView = memDC.DetachBitmap();

6.9.2 选择打印机

        这一步相当直接。我们声明一个PRINTDLG结构，并在PRINTDLG函数中使用它。PrintDlg函数打开一个对话框，允许我们选择打印机，并将其设备上下文存储在PrintDlg结构中。

   CPrintDialog printDlg;

  // Bring up a dialog to choose the printer
  if (printDlg.DoModal(GetView()) == IDOK) // throws exception if there is no default printer

        注意：如果没有配置打印机或无法创建对话框，CPrintDialog::DoModal 将引发CResourceException。应使用try/catch块来捕获DoModal引发的异常。

6.9.3 启动打印作业

        在将输出发送到打印机之前，应调用StartDoc函数。此功能可确保多页文档不会与其他打印作业穿插在一起。然后为打印输出的每一页调用StartPage（和相应的EndPage）。

   // Zero and then initialize the members of a DOCINFO structure.
  DOCINFO di = {0};
  di.cbSize = sizeof(DOCINFO);
  di.lpszDocName = _T("Scribble Printout");

  // Begin a print job by calling the StartDoc function.
  StartDoc(pd.hDC, &di);

  // Inform the driver that the application is about to begin sending data.
  StartPage(pd.hDC);

6.9.4 从位图中提取位图图像数据

        为了使用StretchDIBits功能函数（下文使用），我们首先需要位图图像数据。这通过使用GetDIBits返回。在下面的代码示例中，它被调用两次，第一次是获取大小字节数组以保存数据，第二次是填充字节数组。

   // Get the dimensions of the View window
  CRect viewRect = GetView().GetClientRect();
  int width = viewRect.Width();
  int height = viewRect.Height();
	
  // Fill the BITMAPINFOHEADER structure
  BITMAPINFOHEADER bih;
  ZeroMemory(&bih, sizeof(BITMAPINFOHEADER));
  bih.biSize = sizeof(BITMAPINFOHEADER);
  bih.biHeight = height;
  bih.biWidth = width;
  bih.biPlanes = 1;
  bih.biBitCount =  24;
  bih.biCompression = BI_RGB;
  
  // Note: BITMAPINFO and BITMAPINFOHEADER are the same for 24 bit bitmaps
  // Get the size of the image data
  BITMAPINFO* pBI = reinterpret_cast<BITMAPINFO*>(&bih);
  memDC.GetDIBits(bmView, 0, height, NULL, pBI, DIB_RGB_COLORS);

  // Retrieve the image data
  std::vector imageData(bih.biSizeImage, 0);	// a vector to hold the byte array
  byte* byteArray = &imageData.front();
  memDC.GetDIBits(bmView, 0, height, byteArray, pBI, DIB_RGB_COLORS);

6.9.5 将调整大小的图像数据复制到打印机的设备上下文

        StretchDIBits是此处用于将位图信息复制到打印机的设备上下文的函数，因为位图需要调整大小，以便在打印页面上保持与原件相同的尺寸。以下代码段显示如何计算缩放因子并调用StretchDIBits函数。

  // Determine the scaling factors required to print the bitmap and retain its original proportions.
 double viewPixelsX = double(viewDC.GetDeviceCaps(LOGPIXELSX));
 double viewPixelsY = double(viewDC.GetDeviceCaps(LOGPIXELSY));
 double printPixelsX = double(printDC.GetDeviceCaps(LOGPIXELSX));
 double printPixelsY = double(printDC.GetDeviceCaps(LOGPIXELSY));
 double scaleX = printPixelsX / viewPixelsX;
 double scaleY = printPixelsY / viewPixelsY;

 int scaledWidth = int(width * scaleX);
 int scaledHeight = int(height * scaleY);

 // Use StretchDIBits to scale the bitmap and maintain its original proportions
 printDC.StretchDIBits(0, 0, scaledWidth, scaledHeight, 0, 0, width, height,
                       byteArray, pBI, DIB_RGB_COLORS, SRCCOPY);

6.9.6 结束打印作业

        要完成打印作业，将调用EndPage以指示打印到此页面已完成，然后调用EndDoc结束打印作业。

   // Inform the driver that the page is finished.
  EndPage(pd.hDC);
		
  // Inform the driver that document has ended.
  EndDoc(pd.hDC);

6.9.7 在CDoc中访问CView类

  CDoc::Print方法使用GetView访问CView类。GetView的定义如下。

const CView& CDoc::GetView() const
{
  CMainFrame& frame = GetScribbleApp().GetMainFrame();
  return static_cast(frame.GetView());
}

6.10 打印预览

        在前面的教程中，我们看到了如何将输出发送到打印机。在本教程中，我们将演示如何在将打印页发送到打印机之前预览打印页。

        许多支持打印的应用程序也支持打印预览。打印预览为用户提供了一个机会，可以在打印前查看输出的效果，并进行任何必要的调整。

6.10.1 申明CPrintPreview类变量

        CPrintPreview的工作原理与打印页面的功能相同。用于打印页面的函数称为PrintPage，声明如下。

void PrintPage(CDC& dc, UINT page = 1);

        当我们声明CPrintPreview变量时，我们将PrintPage函数的源指定为模板参数。在下面的代码中，PrintPage是CView的成员函数，因此我们将CView指定为模板参数。

CPrintPreview m_preview<CView>;

6.10.2 初始化 Print Preview

        当我们使用CPrintPreview时，我们使用SetSource来指定PrintPage函数的源。然后，我们使用DoPrintPreview指定所有者窗口，以从CPrintPreview接收消息并创建预览。

        以下代码显示了如何在框架视图中显示打印预览。我们使用SetView将框架的视图更改为CPrintPreview变量。

// Previews a print job before sending it to the printer.
void CMainFrame::OnFilePreview()
{
    try
    {
        // Get the device contect of the default or currently chosen printer
        CPrintDialog printDlg;
        CDC printerDC = printDlg.GetPrinterDC();

        // Create the preview window if required
        if (!m_preview.IsWindow())
            m_preview.Create(*this);

        // Specify the source of the PrintPage function
        m_preview.SetSource(m_view);

        // Set the preview's owner (for messages)
        m_preview.DoPrintPreview(*this);

        // Swap views
        SetView(m_preview);

        // Hide the menu and toolbar
        ShowMenu(FALSE);
        ShowToolBar(FALSE);

        // Update status
        CString status = _T("Printer: ") + printDlg.GetDeviceName();
        SetStatusText(status);
    }

    catch (const CException& e)
    {
        // An exception occurred. Display the relevant information.
        MessageBox(e.GetText(), _T("Print Preview Failed"), MB_ICONWARNING);
        SetView(m_view);
        ShowMenu(GetFrameMenu() != 0);
        ShowToolBar(GetToolBar().GetButtonCount() > 0);
    }

}

6.10.3Handling Messages from CPrintPreview

        CPrintPreview类向其所有者窗口发送以下消息。

• UWM_PREVIEWCLOSE   - 按下CPrintPreview的“关闭”按钮时发送。
• UWN_PREVIEWNOW      - 按下CPrintPreview的“立即打印”按钮时发送。
• UWM_PREVIEWSETUP   - 按下CPrintPreview的“打印设置”按钮时发送。

// Handle the frame's messages.
LRESULT CMainFrame::WndProc(UINT msg, WPARAM wparam, LPARAM lparam)
{
    switch (msg)
    {
    case UWM_PREVIEWCLOSE:      OnPreviewClose();   break;
    case UWM_PREVIEWNOW:        OnPreviewPrint();   break;
    case UWM_PREVIEWSETUP:      OnPreviewSetup();   break;
    }

    return WndProcDefault(msg, wparam, lparam);
}

        在下面的代码中，我们通过显示一个对话框来响应UWM_PREVIEWSETUP消息，该对话框允许用户选择打印选项，如纸张大小。一旦用户做出选择，我们调用DoPrintPreview以显示带有新选项的页面。

// Called when the Print Preview's "Print Setup" button is pressed.
void CMainFrame::OnPreviewSetup()
{
    // Call the print setup dialog.
    CPrintDialog printDlg(PD_PRINTSETUP);
    try
    {
        // Display the print dialog
        if (printDlg.DoModal(*this) == IDOK)
        {
            CString status = _T("Printer: ") + printDlg.GetDeviceName();
            SetStatusText(status);
        }
    }

    catch (const CException& e)
    {
        // An exception occurred. Display the relevant information.
        MessageBox(e.GetErrorString(), e.GetText(), MB_ICONWARNING);
    }

    // Initiate the print preview.
    m_preview.DoPrintPreview(*this);
}

        在下面的代码中，我们通过向打印机发送页面而不启动对话框来响应UWM_PREVIEWNOW消息。

// Called when the Print Preview's "Print Now" button is pressed.
void CMainFrame::OnPreviewPrint()
{
    m_view.QuickPrint(_T("Frame Sample"));
}

        在下面的代码中，我们通过将帧的视图恢复为正常来响应UWM_PREVIEWCLOSE消息。无需销毁CPrintPreview窗口，因为当我们使用SetView选择m_view作为帧的视图时，它是隐藏的。

// Called when the Print Preview's "Close" button is pressed.
void CMainFrame::OnPreviewClose()
{
    // Swap the view
    SetView(m_view);

    // Show the menu and toolbar
    ShowMenu(GetFrameMenu() != 0);
    ShowToolBar(GetToolBar().IsWindow());

    SetStatusText(LoadString(IDW_READY));
}

6.11 最后调整 

构成Win32++基础的代码位于include目录中。您不需要修改这些文件，而是从Win32++类继承，并在派生类中添加任何其他代码。例如，要创建SDI（单窗口）架构窗口，通常需要从CFrame派生自己的类，并把对标准框架的任何修改放在你自己类中。您可以重写WndProc成员函数，以包含您想要处理的任何其他消息。

        一个单独的视图窗口放置

6.11.1 保存程序windows位置大小

        用户将期望现代应用程序保存其设置，例如框架窗口的位置和大小。这些设置存储在注册表中。LoadRegistrySettings用于设置注册表项的名称。通常，名称采用“CompanyName\\ApplicationName”的形式，如下所示。

HWND CMainFrame::Create(HWND parent)
{
    // Set m_View as the view window of the frame
    SetView(m_view);

    // Set the registry key name, and load the initial window position
    // Use a registry key name like "CompanyName\\Application"
    LoadRegistrySettings(_T("Win32++\\Scribble Sample"));

    return CFrame::Create(parent);
}

        如果使用LoadRegistrySetting函数设置了注册表项名称，则应用程序启动时将从注册表加载注册表设置，并在应用程序结束时将其存储在注册表中。如果希望在注册表中存储其他设置，请重写CMainFrame中的LoadRegistrySettings和SaveRegistrySettings函数。

6.11.2 保存最近使用清单

        加载和存储文件的应用程序通常允许用户从最近使用的文件名列表中进行选择。该MRU列表也存储在注册表中。要将此功能添加到Win32++应用程序，请使用LoadRegistryMRUSettings函数指定MRU列表中的条目数（最多16个），如下所示。

HWND CMainFrame::Create(HWND parent)
{
    // Set m_View as the view window of the frame
    SetView(m_view);

    // Set the registry key name, and load the initial window position
    // Use a registry key name like "CompanyName\\Application"
    LoadRegistrySettings(_T("Win32++\\Scribble Sample"));

    // Load the settings from the registry with 4 MRU entries
    LoadRegistryMRUSettings(4);

    return CFrame::Create(parent);
}

        要查看菜单中列出的MRU条目，请将“最近使用的文件”菜单项添加到资源中的菜单定义中。rc如下：

MENUITEM "Recent Files",                IDW_FILE_MRU_FILE1, GRAYED

6.11.3 命令行参数

        当程序启动时，命令行参数被传递给程序。GetCommandLine函数用于检索命令行字符串。CommandLineToArgvW可以解析此字符串并将其转换为LPWSTR指针数组。

        以下代码演示了当文件名作为命令行参数提供时如何加载文件。

void CMainFrame::OnInitialUpdate()
{
  // Here we process the command line arguments, and automatically load a file if one is specified.
  // GetCommandLineArgs retrieves our command line arguments and stores them in a vector of CString.

  std::vector<CString> args = GetCommandLineArgs();
  // The second argument (if any) contains our file name.
  if (args.size() > 1)
  {
    GetDoc().FileOpen(args[1]);
  }
}

        这允许应用程序在从Windows资源管理器中选择并打开文件时启动并加载该文件。这也可以通过将数据文件拖放到程序的图标或.exe文件上，为运行应用程序提供拖放支持。

6.11.4 使用跟踪（Tracing）调试应用程序

        一种重要的调试技术是跟踪应用程序运行时发生的情况。跟踪允许您在Visual Studio的输出窗格（或您使用的任何集成开发环境）中显示消息或变量的内容。

        为了利用这一点，您需要执行以下操作：

•  在调试模式下运行应用程序 （见下文）
• 使用TRACE函数显示消息

        要在调试模式下运行应用程序，需要定义_debug变量。当您在调试模式下编译时，Microsoft的Visual Studio产品会为您定义此变量。对于其他编译器，应使用适当的编译器选项来设置此变量。此示例的源代码以及下载部分中的示例，包括用于DevC++和CodeBlock调试模式的项目文件，以使此任务更容易。

        如果未在调试模式下运行，TRACE语句将无效。如果您愿意，可以将它们保留在释放模式中。

        在本节的示例代码中，我们将跟踪添加到涂鸦应用程序，以显示我们绘制的线的鼠标位置。

        下面代码是添加到CView::OnMouseMove进行跟踪的代码。

CString str;
str.Format( _T("Draw Point: %hd, %hd\n"), GET_X_LPARAM(lParam), GET_Y_LPARAM(lParam) );
TRACE(str);

6.11.5 处理异常

        Win32++框架在无法执行某些任务时会引发异常。可能引发异常的任务示例包括：

• 无法创建窗口或对话框。Failure to create a window or dialog.
• 创建线程失败。Failure to create a thread.
• 无法创建GDI资源，如笔或画笔。Failure to create a GDI resource such as a pen or brush.
• 在设备上下文中选择GDI资源（如位图）失败。Failure to select a GDI resource such as a bitmap into a device context.
• 无法打开或读取文件。Failure to open or read from a file.

        我们可以使用异常处理来警告这些问题，并可能允许我们的程序继续运行。

        以下代码显示了如何显示程序启动时可能引发的异常。

// WinMain is the program's entry point. The program starts here.
int WINAPI WinMain(HINSTANCE, HINSTANCE, LPSTR, int)
{
  try
  {
    // Start Win32++
    CScribbleApp theApp;

    // Run the application.
    return theApp.Run();
  }

  // Catch all unhandled CException types.
  catch (const CException &e)
  {
    // Display the exception and quit.
    ::MessageBox(0, e.GetErrorString(), e.GetText(), MB_ICONWARNING);

    return -1;
  }
}

         下面的代码显示了如何处理程序处理窗口消息时可能引发的异常。

// Handle the frame's messages.
LRESULT CMainFrame::WndProc(UINT msg, WPARAM wparam, LPARAM lparam)
{
    try
    {
        switch (msg)
        {
        case UWM_DROPFILE:          OnDropFile(wparam); break;
        case UWM_PREVIEWCLOSE:      OnPreviewClose();   break;
        case UWM_PRINTNOW:          OnPreviewPrint();   break;
        case UWM_PRINTSETUP:        OnPreviewSetup();   break;
        }

        return WndProcDefault(msg, wparam, lparam);
    }

    // Catch all CException types.
    catch (const CException& e)
    {
        // Display the exception and continue.
        ::MessageBox(0, e.GetText(), AtoT(e.what()), MB_ICONERROR);

        return 0;
    }
}

        请注意，此代码还将处理WndProcDefault调用的函数中引发的异常，如OnCommand、OnDraw、OnNotify等。预期引发异常的代码（如使用文件或存档）也可能需要自己的异常处理。 

七、其他例子

        本小结的源代码例子可以在源代码samples目录中找到.

7.1 浏览器 

        此示例演示如何使用CWebBrowser类在Win32++框架内显示internet浏览器。浏览器不需要ATL或任何特定于Microsoft的代码

7.2 对话框

        在创建自己的基于对话框的应用程序时，请将此作为起点。

7.3 DirectX

          该程序显示了如何覆盖消息循环以适应DirectX。 

7.4 Docking 

        这个示例的集合演示了docking, container docking and TabbedMDIs.

7.5 资源管理器

        本程序演示了一些shell编程技术。它的外观和行为与windows资源管理器非常相似，并支持上下文菜单。

7.6 框架的应用程序 Frame

        在创建自己的基于框架的应用程序时，请将此作为起点。框架有一个菜单和工具栏，以及状态栏。

          

7.7 表单

        表单是框架内的对话框。它允许对话框具有菜单、工具栏和状态栏。在创建自己的基于表单的应用程序时，请将此作为起点。

7.8 MDI框架的应用

        在创建自己的基于MDI框架的应用程序时，请将此作为起点。

7.9 了MDI（多文档界面）框架

        该程序演示了MDI（多文档界面）框架的一些功能。功能包括创建最大化的MDI子窗口，以及在关闭MDI子窗口之前进行确认。

 

7.10 简单窗口

        此示例演示了创建和自定义简单窗口的基本原理。在创建自己的简单窗口应用程序时，请将此作为起点。

7.11 主题

        演示Win32++支持的各种主题的程序。主题允许您自定义具有一系列样式和渐变填充背景，以及您选择的颜色。主题还使用自定义绘制技术来自定义工具栏的颜色。 

 

7.12 多线程

        该程序演示如何使用CThread创建多个窗口，每个窗口都在一个单独的线程中。

八、Win32++ 重要类清单

类名称	描述
CAnimation	创建动画控件的类。
CArchive	用于将对象保存到文件的类。
CBitmap	用于创建位图资源的类。
CBitmapInfoPtr	用于创建BITMAPINFO结构的类
CBrush	用于创建画笔资源的类。
CButton	用于创建按钮控件的类。
CClientDC	用于为窗口的客户端区域设置控件的类。
CColorDialog	用于显示“颜色”公共对话框的类。
CComboBox	用于创建组合框控件的类。
CComboBoxEx	用于创建ComboBoxEx控件的类。
CCommonDialog	公共对话框的基类。
CCriticalSection	此类为多线程应用程序提供线程同步。
CDateTime	此类用于创建日期和时间选择器控件。
CDC	表示设备上下文的类。它简化了windows GDI的工作。
CDataExchange	此类用于提供对对话框数据交换（DDX）和对话框数据验证（DDV）的支持。
CDialog	负责创建模态和非模态对话框的类。它由CFrame使用，也可用于创建对话应用程序。
CDockContainer	该类用于创建停靠容器。
CDocker	用于停靠docking窗口的类。停靠窗口也可以用作拆分器窗口。
CDockFrame	此类将普通的CFrame与停靠docking相结合。
CEdit	用于创建编辑控件的类。
CEnhMetaFile	用于管理HENHMETAFILE的类。
CEnhMetaTileDC	用于创建增强型图元文件设备上下文的类。
CEvent	用于创建事件对象的类。
CException	这是Win32++中使用的异常的基类。
CFile	用于读取和写入文件的类。
CFileDialog	用于显示FileOpen和FileSave公共对话框的类。
CFileException	此异常由CArchive和CFile引发。
CFileFind	用于查找与指定字符串匹配的一个或多个文件的类。
CFindReplaceDialog	用于显示FindText和ReplaceText公共对话框的类。
CFolderDialog	用于显示对话框以选择文件夹的类。
CFont	用于创建字体资源的类。
CFontDialog	用于显示字体公用对话框的类。
CFrame	此类生成一个框架窗口，其中包含、菜单栏、工具栏和状态栏。框架窗口的工作区应由单独的CWnd对象占据。
CGDIObject	GDI对象的基类，包括CBitmap、CBrush、CFont、CPalette、CPen和CRgn。
CHeader	用于创建标题控件的类。
CHotKey	用于创建热键控件的类。
CImageList	用于创建和管理图像列表的类。
CIPAddress	用于创建IP地址控件的类。
CListBox	用于创建列表框控件的类。
CListView	用于创建列表视图控件的类。
CMDIChild	这是用于MDI子级的类。每个MDI子级都应从该类继承。
CMDIDockFrame	此类将普通CMDIFrame与停靠相结合。
CMDIFrame	此类负责创建MDI框架窗口。它继承自CFrame。
CMemDC	用于创建内存设备上下文的类。
CMenu	用于创建和修改菜单的类。
CMenuBar	此类负责创建菜单栏。菜单栏是位于rebar 控件内的菜单。
CMetaFile	用于管理HMETAFILE的类。
CMetaFileDC	用于创建图元文件设备上下文的类。
CMonthCalendar	用于创建月历控件的类。
CMutex	用于创建互斥对象的类。
CNotSupportedException	无法启动Win32++时引发此异常。
CPageSetupDialog	用于显示“页面设置”公用对话框的类。
CPaintDC	用于为WM_PAINT消息创建设备上下文的类。
CPalette	用于创建调色板资源的类。
CPen	用于创建笔资源的类。
CPoint	可以用来代替POINT结构的类。
CPrintDialog	用于显示打印公共对话框的类。
CPrintPrintPreview	用于提供打印预览的类。
CProgressBar	用于创建进度条控件的类。
CPropertyPage	用于创建属性页的类。属性页包含一个或多个属性页。
CPropertySheet	此类表示属性页。它由CPropertySheet使用。
CReBar	此类负责创建rebar。它由CFrame使用。
CRect	可以用来代替RECT结构的类。
CRgn	用于创建区域的类。
CResourceException	当无法创建GDI资源时引发此异常。
CRibbon	用于将Window7功能区框架添加到窗口的类。
CRibbonDockFrame	用于添加支持停靠的框架和Window 7 ribbon框架的类。如果操作系统不支持ribbon框架，将使用菜单和工具栏。
CRibbonFrame	用于创建带有window 7功能区框架的框架窗口的类如果操作系统不支持功能区框架，将使用菜单和工具栏。
CRichEdit	用于创建富编辑控件的类。
CScrollBar	用于创建滚动条控件的类。
CScrollView	用于向视图窗口添加滚动条的类。
CSemaphore	用于创建信号量对象的类。
CSize	可以用来代替SIZE结构的类。
CSlider	用于创建滑块控件（有时称为轨迹条控件）的类。
CSocket	此类为Win32++添加了网络支持。
CSpinButton	用于创建旋转按钮控件（有时称为上下控件）的类。
CStatic	用于创建静态控件的类。The class used to create a static control.
CStatusBar	负责创建状态栏的类。它由CFrame使用。
CString	用于创建和修改字符串的类。
CTab	用于创建Tab控件的类。
CTabbedMDI	用于选项卡式MDI窗口的类。
CTaskDialog	用于创建任务对话框的类。
CThreadLock	此类为拥有CCcriticalSection提供了一种方便的RAII样式机制。
CToolBar	负责创建工具栏的类。它由CFrame使用。
CToolTip	用于创建工具提示控件的类。
CTreeView	用于创建树视图控件的类。
CUserException	当验证失败时，CDataExchange抛出并捕获此异常。
CWebBrowser	用于在窗口中创建web浏览器的类。
CWinApp	负责初始化Win32++的类，还提供了我们的消息循环。您应该从该类继承以启动应用程序。
CWindowDC	用于为整个窗口（包括非客户端区域）创建设备上下文的类。
CWinException	处理异常的类。
CWinThread	用于创建工作线程和GUI线程的类。窗口可以在GUI线程中运行。
CWnd	负责窗口对象的类。它是更专门的窗口对象（如CDialog、CFrame、CToolbar等）的基类。
Shared_Ptr	可以在STL容器（如向量）中使用的智能指针。A smart pointer that can be used in a STL container such as a vector.

九、相关资源连接

9.1 免费编译和工具 

Dev-C++	Dev-C++ is a Integrated Development Environment (IDE) for  C/C++. It includes the MinGW port of GCC as it's compiler.
Code::Blocks	Code::Blocks is an IDE for C/C++.  It includes the MinGW port of GCC, and also supports the MS Visual Toolkit, and the free command line compiler from Borland.
Microsoft Visual Community	A free C++ Win32 compiler and IDE from Microsoft. It includes the DirectX11 and Windows 7 SDKs, as well as the C++ and Windows API documentation.
Borland C++ Builder	A free C++ Win32 compiler from Borland.  You will need to register before downloading.
Resource Hacker	A freeware resource compiler and decompiler for Windows庐 applications.
GDIView	A utility that displays list a of GDI handles used by each process. It's useful for spotting GDI leaks.
Nullsoft Scriptable Install System	NSIS (Nullsoft Scriptable Install System) is a professional open source system to create Windows installers.
Pixelformer	Pixelformer is a bitmap editor, specifically optimized for creating, modifying, and converting small and medium-sized images, such as icons, buttons, web graphics, sprites, etc.
Visual Leak Detector	An open-source memory leak detection system for Visual C++.

9.2 教程和参考

MSDN Library	The Microsoft Developers Network.  Microsoft's online reference.
About Messages and Message Queues	The section in MSDN describing the messages available in Windows.
MS Platform SDK	Provides the documentation, samples, header files, libraries, and tools designed to help you develop Windows applications (XP and below).
MS Windows SDK	Provides the documentation, samples, header files, libraries, and tools designed to help you develop Windows applications (Vista and above).
MS DirectX SDK	Contains the additional header files and libraries for DirectX programming.
SourceForge	SourceForge hosts a large collection of open source projects.
Code Project	Forums and Code samples for software developers.
Cfanatic	A forum for C, Win32, C++, MFC, C# developers.
Reliable Software	A Win32 tutorial for advanced C++ users.
the Forger	A Win32 tutorial for C++.
Get Started with Win32 and C++	A Win32 tutorial from Microsoft.
Google	Internet Search Engine.
Wikipedia	Web based encyclopedia.
C++ FAQ	C++ Frequently Asked Questions

十、代码及其相关资源下载

        源代码下载

        Win32++ version 9.1 帮助

        百度网盘下载地址：链接：https://pan.baidu.com/s/1XxlcJm-d_Ah7MdaEya_dQA 
                                        提取码：wne3