wxWidgets系列之入门例子

最新推荐文章于 2023-07-18 16:11:01 发布

Juano0o0

最新推荐文章于 2023-07-18 16:11:01 发布

阅读量599

点赞数

分类专栏： wxWidgets 文章标签： button table menu include 编译器 string

wxWidgets 专栏收录该内容

1 篇文章

订阅专栏

1. 应用程序类的建立

使用wxWidgets建立系统需要一个类来描述整个应用程序。这个类必须从wxApp类继承。

class MyApp : public wxApp // 应用程序类
{
public :
virtual bool OnInit(); // 在应用程序启动时调用，如果返回false，退出应用程序
};

这个类只覆盖了wxApp的一个虚方法OnInit。可以用这个方法在程序启动时做一些验证，如果验证失败，可以通过返回false退出应用程序。当然，由于这个函数是应用程序的入口点，所以建立主窗体的工作要在这个函数中完成。

2. 建立窗体类

wxWidgets中关于窗体的类很多，如果要建立一般窗体的话，可以从wxFrame继承。

class MyFrame : public wxFrame // 窗体类
{
public :
MyFrame( const wxString & title); // 窗体的构造函数
};

3. 向窗体中加入控件

在本文中向这个窗体加入了一个菜单条(Menu Bar)、一个状态条、一个Panel和一个按钮。一般我们会在主窗体的构造函数中加入这些控件。

MyFrame::MyFrame( const wxString & title) : wxFrame(NULL, wxID_ANY, title)
{
    wxMenu * fileMenu = new wxMenu;   // 建立“文件”菜单
    wxMenu * helpMenu = new wxMenu; // 建立“帮助”菜单
    // 向菜单中添加子项
    helpMenu -> Append(wxID_ABOUT, _T( " 关于

"tF1 " ), _T( " 显示关于对话框 " ));
    fileMenu -> Append(wxID_EXIT, _T( " 退出"tAlt-X " ), _T( " 退出应用程序 " ));
    wxMenuBar * menuBar = new wxMenuBar();   // 建立一个菜单条
    menuBar -> Append(fileMenu, _T( " 文件 " ));   // 将“文件”菜单加入到菜单条
    menuBar -> Append(helpMenu, _T( " 帮助 " ));   // 将“帮助”菜单加入到菜单条
    SetMenuBar(menuBar);   // 将菜单条放到窗体上
    wxPanel * panel = new wxPanel( this );    // 建立一个Panel
    wxButton * button = new wxButton(panel, wxID_ABOUT, " 关于 " , wxPoint( 20 , 20 ), wxSize( 50 , 30 ));   // 建立一个Button
    CreateStatusBar( 2 );   // 建立一个两栏的状态栏
    SetStatusText(_T( " 欢迎使用wxWidgets! " ));   // 设置状态栏的文本

在数组 sample_xpm 中描述了 sample.ico 的属性和图标本身。如 X 代表红色； o 代表黄色等。然后在源程序中通过 include “sample.xpm” 引用这个资源文件。要想从这个资源文件中装载图标。可使用 SetIcon(wxICON(sample)); wxICON 读取资源文件，而 SetIcon 将这个图标设置为 frame 的标题栏图标。要想将 ico 文件转换为这种资源文件，可使用一个免费软件XnView 进行转换。

5. 显示主窗体

显示主窗体非常简单，只需要将上面建立的MyFrame类实例化，并调用wxFrame的Show方法显示即可。这些代码可以写在MyApp类的OnInit方法中。

bool MyApp::OnInit()
{
    // 建立MyFrame类的实例
    MyFrame * frame = new MyFrame(_T( " 第一个wxWidgets程序 " ));
    frame -> Show( true );   // 显示主窗体
return true ;   // 必须返回true，否则应用程序将退出
}

在以上代码中Show方法有一个参数，如果为true，则以模式窗口的形式显示，否则以非模式窗口的形式显示。

6. 向窗体中加入事件

到目前为止，这个程序的界面已经完成了，但还未响应任何事件，下面就详细阐述如何向这个应用程序中加入事件代码。
对于事件来说，一般都会由两部分组成。

（1）调用事件部分

当程序发生某个动作时，如点击按钮；选中某个控件，可能需要执行一段代码。而这段代码一般是由系统负责调用的，也就是说系统通过事件函数指针调用相应的代码。

（2）事件函数本身

事件函数与普通函数一样，只不过它是在发生了事件之后，由系统调用的。

在wxWidgets中是通过事件哈希表(Event Hash Table)来进行事件处理的，即将相应的事件函数指针保存在一个哈希表中，然后当事件发生时，从这个哈希表中找到相应的事件函数指针，然后通过函数指针调用函数。在使用事件哈希表之前，必须定义它。由于定义哈希表非常复杂，而且每个需要处理事件的类都需要同样的代码，因此，wxWidgets为此定义了一个宏DECLARE_EVENT_TABLE()来定义哈希表。可将这个宏写在MyFrame类的任何位置。它相当于将以下语句放到了MyFrame类中。

     private :
        static const wxEventTableEntry sm_eventTableEntries[];
     protected :
         static const wxEventTable  sm_eventTable;
         virtual const wxEventTable *   GetEventTable() const ;
         static wxEventHashTable  sm_eventHashTable;

virtual wxEventHashTable& GetEventHashTable() const;

其中静态数组变量sm_eventTableEntries保存了MyFrame类中的所有的事件信息。

上面的代码声明了处理事件哈希表的一些方法，即然声明了，就得实现。由于实现代码也都一样，因此，wxWidgets也为实现这些方法定义了一组宏。实现这些方法的宏如下所示。

BEGIN_EVENT_TABLE(MyFrame, wxFrame)
    EVT_MENU(wxID_EXIT,  MyFrame::OnQuit)
    EVT_MENU(wxID_ABOUT, MyFrame::OnAbout)
    EVT_BUTTON(wxID_ABOUT, MyFrame::OnAbout)
END_EVENT_TABLE()

其中BEGIN_EVENT_TABLE(…)实现了上面定义的方法，以及初始化了静态变量sm_eventTable。后面两个EVT_MENU和一个EVT_BUTTON宏初始化了静态变量sm_eventTableEntries，即将这两个事件函数的指针(button和about菜单使用一个事件函数OnAbout)和控件ID保存在sm_eventTableEntries中，最后的END_EVENT_TABLE()宏做为一个空的事件函数指针赋给了sm_eventTableEntries，这有些象C语言中处理字符串，将最后一个字符赋为’"0’，这样就可以知道哪是结尾了。
向窗体中加入事件的最后一步是声明和实现事件函数。在本例中声明了两个事件函数。

void OnQuit(wxCommandEvent & event );
void OnAbout(wxCommandEvent & event );

可以将这两个函数声明放到MyFrame中的任何位置。下面是它们的实现代码。

void MyFrame::OnQuit(wxCommandEvent & WXUNUSED( event ))
{
    Close( true );
}
void MyFrame::OnAbout(wxCommandEvent & WXUNUSED( event ))
{
    wxString msg;
    msg.Printf( _T( " 这是一个关于对话框的例子."n " )
                _T( " 欢迎使用 %s " ), wxVERSION_STRING);
    wxMessageBox(msg, _T( " ¹关于 " ), wxOK | wxICON_INFORMATION, this );
}

其中OnQuit函数调用Close(true)关闭MyFrame，由于MyFrame是主窗体，因此，在MyFrame关闭后，应用程序也随之关闭了。OnAbout使用wxMessageBox函数弹出一个信息对话框。

7. 运行程序

到目前为止，这个程序的代码已经基本完成了，但是在前面曾说过，MyApp中的OnInit方法在应用程序启动时执行，那么是谁调用了OnInit方法呢？答案当然是wxWidgets。wxWidgets为了调用这个方法，提供了一个宏IMPLEMENT_APP(…)，这个宏有一个参数，需要将MyApp做为参数传入。即IMPLEMENT_APP(MyApp)。这个宏相当于一个WinMain函数（和控制台程序的main函数类似），即在WinMain函数中调用了MyApp中的OnInit函数。在加入这个宏后，就可使用一个C++编译器将以上的源程序编译生成exe文件了。