Partie IV : Comprendre les notions de Sizers, Timers…

CGi

Sizers, Timers…

Dans cette quatrième partie de cette série de tutoriels, vous allez comprendre les notions iszers, timers… de la bibliothèque wxWidgets.

Un espace de dialogue vous est proposé sur le forum. N'hésitez pas à apporter vos commentaires sur le lien ci-dessous, si vous avez des remarques concernant ce tutoriel.

Commentez

- Titre : Partie IV : Comprendre les notions de Sizers, Timers…

- Auteur : CGi

- Parution : 25 mai 2004

- Mise à jour : 14 octobre 2016

- Licence : Copyright ® 2016 CGi. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Sommaire

- I. Introduction

- II. Les sizers

- III. Le timer

- IV. Les MessageBox

- V. Code source complet

- V-A. wxwin1.h

- V-B. wxwin1.cpp

- VI. Remarques sur ce document

I - Introduction

Dans le premier chapitre, nous avions placé nos boutons par leur position, mais dans la majorité des cas, ils sont inclus dans des sizers. Les sizers permettent l'ancrage par rapport aux quatre côtés de la fenêtre. Nous aborderons aussi dans cet article les timers, la traditionnelle boîte de message, et aussi la jauge.

Nous nous aiderons ici aussi d'un exemple dont vous pouvez voir le résultat sur la copie d'écran ci-dessous.

II - Les sizers

La librairie wxWidgets possède plusieurs types de sizers, nous allons les aborder avec un sizer simple le wxBoxSizer. Un sizer se crée comme un objet fenêtré à l'aide de l'opérateur new et sa destruction est du ressort de l'application. Dans l'exemple nous créons d'abord un objet wxBoxSizer Mysizer. Son constructeur reçoit comme argument un entier indiquant comment seront alignés les éléments qu'il contient, deux possibilités wxVERTICAL pour les aligner les uns sous les autres ou wxHORIZONTAL pour les aligner les uns à côté des autres. Dans l'exemple ils seront tous les deux d'orientation verticale. Puis nous lui ajoutons les deux boutons à l'aide de sa méthode add.

wxBoxSizer *Mysizer = new wxBoxSizer( wxVERTICAL );
MonBouton1 = new wxButton(this,Id_ClickBt1,"Stop");
Mysizer->Add(MonBouton1);
MonBouton2 = new wxButton(this,Id_ClickBt2,"Start");
Mysizer->Add(MonBouton2);

Puis nous créons le deuxième sizer auquel nous ajoutons dans cet ordre : le sizer précédemment créé puis la jauge.

wxBoxSizer *Psizer = new wxBoxSizer( wxVERTICAL );
Psizer->Add(Mysizer,1,wxALIGN_RIGHT);
Psizer->Add(MaGauge = new wxGauge(this,-1,100, wxDefaultPosition,
wxDefaultSize),0,wxEXPAND);

Vous remarquez que les méthodes add utilisées ici ont des paramètres supplémentaires. Le premier est toujours un pointeur sur l'objet à inclure dans le sizer. Le deuxième et un entier indiquant la proportion que doit prendre l'élément dans le sizer. Une valeur nulle indique que l'élément garde ses dimensions d'origine, c'est le cas de la jauge. Le sizer Mysizer prend donc tout le reste de la place disponible. Le troisième paramètre indique la position des éléments dans le sizer. Le sizer MySizer est aligné à droite et la jauge est étendue sur toute la largeur. Il n'y a plus qu'à affecter le sizer principal Psizer à la fenêtre à l'aide de sa méthode SetSizer, ce qui la rendra aussi responsable de la destruction du sizer.

SetSizer(Psizer);

III - Le timer

Sous wxWidgets les timers sont simples à utiliser. Dans l'exemple nous le créons par valeur dans la déclaration de la classe. Dans le constructeur de TMyFrame nous l'initialisons à l'aide de sa méthode SetOwner qui reçoit comme paramètre un propriétaire ici c'est la fenêtre principale et un identificateur d'événement. Puis nous lançons le timer à l'aide de sa méthode Start qui reçoit en paramètre une durée en milliseconde.

MonTimer.SetOwner(this,Id_Timer);
MonTimer.Start(500);

L'identificateur d'événement est utilisé sur le même principe que pour les boutons ou les menus des chapitres précédents à l'aide de la macro EVT_TIMER qui le lie à la méthode OnTimer dans la table d'événements.

BEGIN_EVENT_TABLE(TMyFrame, wxFrame)
EVT_TIMER(Id_Timer,  TMyFrame::OnTimer)
END_EVENT_TABLE()

Le déclenchement de cet événement appellera donc la méthode OnTimer de TMyFrame toutes les 500 ms.

Dans cette méthode nous changerons la valeur de la jauge à l'aide de sa méthode SetValue et nous la remettons à zéro quand sa valeur maximale est atteinte. Valeur renvoyée par sa méthode GetRange.

void TMyFrame::OnTimer(wxCommandEvent& event)
{
int x = MaGauge->GetValue();
x += 5;
MaGauge->SetValue(x);
if (x > MaGauge->GetRange()) MaGauge->SetValue(0);
}

IV - Les MessageBox

Pour ne pas laisser nos deux boutons sans rien faire, nous en utiliserons un pour arrêter le timer et l'autre pour le démarrer. Et nous appellerons une MessageBox pour nous signifier l'action que nous venons d'effectuer.

void TMyFrame::OnClickBouton1(wxCommandEvent& WXUNUSED(event))
{
if(MonTimer.IsRunning())
{
MonTimer.Stop();
wxMessageDialog MsgDlg(this,"Vous avez stopé le timer");
MsgDlg.ShowModal();
}
}
//------------------------------------------------------------------------------
void TMyFrame::OnClickBouton2(wxCommandEvent& WXUNUSED(event))
{
if(!MonTimer.IsRunning())
{
MonTimer.Start(500);
wxMessageDialog MsgDlg(this,"Vous avez relancé le timer","Action");
MsgDlg.ShowModal();
}
}

Les MessageBox sont créées par valeur leur constructeur reçoit comme paramètres la fenêtre parent puis le texte du message puis éventuellement le titre.

V - Code source complet

V-A - wxwin1.h

#ifndef wxWin1H
#define wxWin1H
//------------------------------------------------------------------------------
class TMyApp : public wxApp
{
public:
virtual bool OnInit();
};
//------------------------------------------------------------------------------
class TMyFrame : public wxFrame
{
public:
TMyFrame(const wxString& title, const wxPoint& pos, const wxSize& size,
long style = wxDEFAULT_FRAME_STYLE);
void OnClickBouton1(wxCommandEvent& WXUNUSED(event));
void OnClickBouton2(wxCommandEvent& WXUNUSED(event));
void OnTimer(wxCommandEvent& event);
private:
wxGauge *MaGauge;
wxButton *MonBouton1 ;
wxButton *MonBouton2 ;
wxTimer MonTimer;

DECLARE_EVENT_TABLE()
};
enum
{
Id_ClickBt1,
Id_ClickBt2,
Id_Timer
};
//------------------------------------------------------------------------------
#endif //wxWin1H

V-B - wxwin1.cpp

#include "wx/wxprec.h"

#ifdef __BORLANDC__
#pragma hdrstop
#endif

#ifndef WX_PRECOMP
#include "wx/wx.h"
#endif
//------------------------------------------------------------------------------
#include "wxWin1.h"

BEGIN_EVENT_TABLE(TMyFrame, wxFrame)
EVT_BUTTON(Id_ClickBt1,  TMyFrame::OnClickBouton1)
EVT_BUTTON(Id_ClickBt2,  TMyFrame::OnClickBouton2)
EVT_TIMER(Id_Timer,  TMyFrame::OnTimer)
END_EVENT_TABLE()

IMPLEMENT_APP(TMyApp)
//------------------------------------------------------------------------------
bool TMyApp::OnInit()
{
TMyFrame *frame = new TMyFrame("Ma première application", wxPoint(150, 150),
wxSize(400, 140),wxSYSTEM_MENU | wxCAPTION | wxRESIZE_BORDER |
wxTAB_TRAVERSAL);
frame->Show(true);
return true;
}
//------------------------------------------------------------------------------
TMyFrame::TMyFrame(const wxString& title, const wxPoint& pos, const wxSize& size,
long style) : wxFrame(NULL, -1, title, pos, size, style)
{
SetIcon(wxICON(monicone));
SetBackgroundColour(wxSystemSettings::GetColour(wxSYS_COLOUR_BTNFACE));

// Création et lancement du Timer
MonTimer.SetOwner(this,Id_Timer);
MonTimer.Start(500);

// Création du 1er sizer
wxBoxSizer *Mysizer = new wxBoxSizer( wxVERTICAL );
MonBouton1 = new wxButton(this,Id_ClickBt1,"Stop");
Mysizer->Add(MonBouton1);
MonBouton2 = new wxButton(this,Id_ClickBt2,"Start");
Mysizer->Add(MonBouton2);

// Création du sizer principal
wxBoxSizer *Psizer = new wxBoxSizer( wxVERTICAL );
Psizer->Add(Mysizer,1,wxALIGN_RIGHT);
Psizer->Add(MaGauge = new wxGauge(this,-1,100, wxDefaultPosition,
wxDefaultSize),0,wxEXPAND);
MaGauge->SetForegroundColour("RED");
SetSizer(Psizer);
}
//------------------------------------------------------------------------------
void TMyFrame::OnClickBouton1(wxCommandEvent& WXUNUSED(event))
{
if(MonTimer.IsRunning())
{
MonTimer.Stop();
wxMessageDialog MsgDlg(this,"Vous avez stopé le timer");
MsgDlg.ShowModal();
}
}
//------------------------------------------------------------------------------
void TMyFrame::OnClickBouton2(wxCommandEvent& WXUNUSED(event))
{
if(!MonTimer.IsRunning())
{
MonTimer.Start(500);
wxMessageDialog MsgDlg(this,"Vous avez relancé le timer","Action");
MsgDlg.ShowModal();
}
}
//------------------------------------------------------------------------------
void TMyFrame::OnTimer(wxCommandEvent& event)
{
int x = MaGauge->GetValue();
x += 5;
MaGauge->SetValue(x);
if (x > MaGauge->GetRange()) MaGauge->SetValue(0);
}
//------------------------------------------------------------------------------

Dans le code de cet exemple, nous avons ajouté le style « wxTAB_TRAVERSAL » à la fenêtre principale (TMyFrame) dans l'appel de son constructeur. Il sert à activer le changement de focus des contrôles par la touche 'TAB' dans les fenêtres qui ne sont pas du type boîte de dialogue.

VI - Remarques sur ce document

Ce document ne présente qu'une initiation aux sizers, il y a plusieurs types de sizers voir la documentation de wxWidgets pour plus de renseignements à ce sujet. J'ai réalisé les compilations dans l'EDI de C++ Builder, wxWidgets étant installé comme vu dans l'article : « Installation de wxWidgets dans l'EDI de C++ Builder ».

Pour les autres compilateurs, veuillez vous référer à leur documentation respective ainsi qu'à la documentation de wxWindows.

À bientôt,

CGi

Avec la contribution d'Alacazam pour la relecture.