基于wxWindows的“hello world”

基于wxWindows的“helloworld”
很多人需要一个简单的例程，用来对wxWindows快速的入门，了解其程序的组织形式和法则。
同其他的很多库（比如STL、Boost）一样，我们要使用wxWindows的组件就得在代码中包含wxWindows相关的头文件。
一般来说，只要我们的编译器支持预编译的功能就可以包含wxprec.h（＃inlcude“wx/wxprec.h”），如果不支持就
可以包含wx.h，
这个头文件包含了通常我们能用到的wxWindows标准库（＃include“wx/wx.h”）。这使得我们用wxWindows做界面
的时候基本上就不用在做＃include操作了。
在这下面的例程可以生成一个类似于MFC的单文档程序框架，由于为了例程尽量简单就没有增加文档类wxDocument，
只是用了应用程序类wxApp和框架类wxFrame，实现了一个最简单的windows窗口基本功能，并在用一个菜单弹出一个about…对话框。

/////////////////////////////////////////////////////////////////////

//filename:hworld.cpp

//

//purpose:wxWindows"Helloworld"

//

//Forcompilersthatsupportprecompilation,includes"wx/wx.h".

#include"wx/wxprec.h"

///////////////////////////

#ifdef__BORLANDC__

#pragmahdrstop

#endif

///////////////////////////

#ifndefWX_PRECOMP

#include"wx/wx.h"

#endif

在这一段代码中，首先是包含了头文件wxprec.h，如果我们的编译器不支持预编译的功能就包含头文件wx.h，正如前面所讲的，
wxWindows标准库都包含在这个文件中，在我们这个比较简单的例程中就不用在用其他的包含代码。

classMyApp:publicwxApp

{

virtualboolOnInit();

};

基于wxWindows的应用程序都应该有一个构造这个应用程序对象的类（wxApp），所以我们继承了wxApp，生成针对我们例程的应用程序类MyApp。

重载了用于初始化操作的方法OnInit（），在这里，这个方法被用来创建一个主窗口。

当然就像MFC一样，应用程序类只能构建出一个应用程序实例，这个应用程序的主框架还需要框架类wxFrame来构造。

classMyFrame:publicwxFrame

{

public:

MyFrame(constwxString&title,constwxPoint&pos,constwxSize&size);

voidOnQuit(wxCommandEvent&event);

voidOnAbout(wxCommandEvent&event);

private:

DECLARE_EVENT_TABLE()

};

在这里我们同样从wxFrame继承得到自己的框架类MyFrame，通过它我们可以构造出例程的主框架，以及由它的构造函数给出在主框架上的状态栏和菜单。

wxFrame在frame.h中定义。上述代码中我们还看到有两个函数的申明OnQuit（）和OnAbout（），这是对主框架菜单的响应函数。

从此我们可以看出，在需要对发生在主框架上的事件做出反应，必须在这里定义响应函数，并且在随后的所谓EventTable（事件列表）中申明，

给予每一个事件响应函数一个唯一确定的ID，这就像是指向他们的句柄。为了区分不同的响应函数，这个ID必须是常量而且常量惟一，通常用const（常）或enum（枚举）定义。

enum

{

ID_Quit=1,

ID_About,

};

事件例表如下：

BEGIN_EVENT_TABLE(MyFrame,wxFrame)

EVT_MENU(ID_Quit,MyFrame::OnQuit)

EVT_MENU(ID_About,MyFrame::OnAbout)

END_EVENT_TABLE()

看的出来在宏DECLARE_EVENT_TABLE中把惟一确定的ID（ID_Quit、ID_About）同相应的响应操作联系起来，

也通过这点把所有的事件与响应它的函数联系起来，特殊的如果我们给定ID的值为-1，那么意味着与其相应的函数响应某一类型的所有事件，

按照这样的设置就可以为一组事件只EventTable（事件例表）中置一个函数入口，比如为这个例程的菜单事件设置一个响应函数入口。

DECLARE_EVENT_TABLE在event.h定义。

在上面的代码中函数OnQuit（）和OnAbout（）有惟一的参数wxCommandEvent类的对象引用。其中wxCommandEvent比较陌生，其实它是wxEvent的派生类，也定义在event.h中，在这类对象中保存着特定事件的信息，被响应函数调用。

在这下边就是上述的两个类的成员函数的定义了，首先是初始化应用程序的OnInit（）函数。

boolMyApp::OnInit()

{

MyFrame*frame=newMyFrame("HelloWorld",wxPoint(50,50),wxSize(450,340));

frame->Show(TRUE);

SetTopWindow(frame);

returnTRUE;

}

在初始化代码中，首先创建MyFrame框架类的动态对象，通过它的操作show（）显示了主框架窗口，SetTopWindow（）把窗口置顶，最后返回TURE，表示初始化成功。

以下是MyFrame框架类构造函数定义：

MyFrame::MyFrame(constwxString&title,constwxPoint&pos,constwxSize&size)

:wxFrame((wxFrame*)NULL,-1,title,pos,size)

{

wxMenu*menuFile=newwxMenu;

menuFile->Append(ID_About,"&About...");

menuFile->AppendSeparator();

menuFile->Append(ID_Quit,"E&xit");

wxMenuBar*menuBar=newwxMenuBar;

menuBar->Append(menuFile,"&File");

SetMenuBar(menuBar);

CreateStatusBar();

SetStatusText("WelcometowxWindows!");

}

在MyFrame框架类构造函数中，首先初始化框架窗口的标题，位置，大小。

然后创建wxMenu菜单类动态对象，被指针menuFile指向，并由操作Append（）增加了两个菜单项，AppendSeparator（）设置了菜单项之间的分割线。

再创建wxMenuBar的动态对象即主菜单“File”，用Append把菜单menuFile加到主菜单。再用MyFrame的操作SetMenuBar把主菜单加到主框架窗口。

最后两句CreateStatusBar()创建状态栏，SetStatusText("WelcometowxWindows!");设置状态栏显示字符串。wxMenu在menu.h中定义。

最后两个菜单项响应函数定义：

voidMyFrame::OnQuit(wxCommandEvent&WXUNUSED(event))

{

Close(TRUE);

}

voidMyFrame::OnAbout(wxCommandEvent&WXUNUSED(event))

{

wxMessageBox("ThisisawxWindows'sHelloworldsample",

"AboutHelloWorld",wxOK|wxICON_INFORMATION);

}

OnQuit（）函数就只有一条语句，Close（TRUE）；即结束主框架对象的生命。

OnAbout（）函数也只有一条语句，wxMessageBox（）；弹出消息框。wxMessageBox()在msgdlg.h中定义。

最后的最后还有一条最最重要的语句，当然这并不算语句，这是宏，这个宏隐含这程序的入口main(),

有了它，我们的程序才会正确的进行，我们把我们的应用程序类对象作为宏的参数即可。这个宏定义在app.h中。

IMPLEMENT_APP(MyApp)

所用头函数：app.h、event.h、frame.h、menu.h、msgdlg.h

这个例程我用Dev-C++4.9.8.0，编辑，编译，连接完全正确。这个例程不能不说是非常简单的，但是我最后的到的exe文件的体重高达2,122,922Byte，这是wxwindows的一个重大弱点，希望以后的版本会改进。

2004-02-16

sixsavage@yahoo.com