基于wxWindows的“hello world”
很多人需要一个简单的例程,用来对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…对话框。
/////////////////////////////////////////////////////////////////////
// file name: hworld.cpp
//
// purpose: wxWindows "Hello world"
//
// For compilers that support precompilation, includes "wx/wx.h".
#include "wx/wxprec.h"
///////////////////////////
#ifdef __BORLANDC__
#pragma hdrstop
#endif
///////////////////////////
#ifndef WX_PRECOMP
#include "wx/wx.h"
#endif
在这一段代码中,首先是包含了头文件wxprec.h,如果我们的编译器不支持预编译的功能就包含头文件wx.h,正如前面所讲的,
wxWindows标准库都包含在这个文件中,在我们这个比较简单的例程中就不用在用其他的包含代码。
class MyApp: public wxApp
{
virtual bool OnInit();
};
基于wxWindows的应用程序都应该有一个构造这个应用程序对象的类(wxApp),所以我们继承了wxApp,生成针对我们例程的应用程序类MyApp。
重载了用于初始化操作的方法OnInit(),在这里,这个方法被用来创建一个主窗口。
当然就像MFC一样,应用程序类只能构建出一个应用程序实例,这个应用程序的主框架还需要框架类wxFrame来构造。
class MyFrame: public wxFrame
{
public:
MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size);
void OnQuit(wxCommandEvent& event);
void OnAbout(wxCommandEvent& event);
private:
DECLARE_EVENT_TABLE()
};
在这里我们同样从wxFrame继承得到自己的框架类MyFrame,通过它我们可以构造出例程的主框架,以及由它的构造函数给出在主框架上的状态栏和菜单。
wxFrame在frame.h中定义。上述代码中我们还看到有两个函数的申明OnQuit()和OnAbout(),这是对主框架菜单的响应函数。
从此我们可以看出,在需要对发生在主框架上的事件做出反应,必须在这里定义响应函数,并且在随后的所谓Event Table(事件列表)中申明,
给予每一个事件响应函数一个唯一确定的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,那么意味着与其相应的函数响应某一类型的所有事件,
按照这样的设置就可以为一组事件只Event Table(事件例表)中置一个函数入口,比如为这个例程的菜单事件设置一个响应函数入口。
DECLARE_EVENT_TABLE在event.h定义。
在上面的代码中函数OnQuit()和OnAbout()有惟一的参数wxCommandEvent类的对象引用。其中wxCommandEvent比较陌生,其实它是wxEvent的派生类,也定义在event.h中,在这类对象中保存着特定事件的信息,被响应函数调用。
在这下边就是上述的两个类的成员函数的定义了,首先是初始化应用程序的OnInit()函数。
bool MyApp::OnInit()
{
MyFrame *frame = new MyFrame( "Hello World", wxPoint(50,50), wxSize(450,340) );
frame->Show( TRUE );
SetTopWindow( frame );
return TRUE;
}
在初始化代码中,首先创建MyFrame框架类的动态对象,通过它的操作show()显示了主框架窗口,SetTopWindow()把窗口置顶,最后返回TURE,表示初始化成功。
以下是MyFrame框架类构造函数定义:
MyFrame::MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size)
: wxFrame((wxFrame *)NULL, -1, title, pos, size)
{
wxMenu *menuFile = new wxMenu;
menuFile->Append( ID_About, "&About..." );
menuFile->AppendSeparator();
menuFile->Append( ID_Quit, "E&xit" );
wxMenuBar *menuBar = new wxMenuBar;
menuBar->Append( menuFile, "&File" );
SetMenuBar( menuBar );
CreateStatusBar();
SetStatusText( "Welcome to wxWindows!" );
}
在MyFrame框架类构造函数中,首先初始化框架窗口的标题,位置,大小。
然后创建wxMenu菜单类动态对象,被指针menuFile指向,并由操作Append()增加了两个菜单项,AppendSeparator()设置了菜单项之间的分割线。
再创建wxMenuBar的动态对象即主菜单“File”,用Append把菜单menuFile加到主菜单。再用MyFrame的操作SetMenuBar把主菜单加到主框架窗口。
最后两句CreateStatusBar()创建状态栏,SetStatusText( "Welcome to wxWindows!" );设置状态栏显示字符串。wxMenu在menu.h中定义。
最后两个菜单项响应函数定义:
void MyFrame::OnQuit(wxCommandEvent& WXUNUSED(event))
{
Close( TRUE );
}
void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event))
{
wxMessageBox( "This is a wxWindows's Hello world sample",
"About Hello World", 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