基于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的一个重大弱点,希望以后的版本会改进。

留下评论

鄂ICP备13000209号-1

鄂公网安备 42050602000277号