Nouveau : la formation trading algorithmique MQL5, MQL4 et ProRealTimeDécouvrir →

MQL5 · Expert Advisors

Panneaux et boutons dans un Expert Advisor MQL5 avec CAppDialog

Ajouter un panneau de contrôle à un EA avec la bibliothèque standard : CAppDialog, CButton, CLabel, table d’événements, bouton pause et fermeture des positions, pièges du rechargement.

Mis à jour le 23 octobre 2026Lecture : 8 minPar Alix, OptiBot Trading

Pour ajouter un panneau de contrôle à un Expert Advisor MQL5, utilisez la classe CAppDialog de la bibliothèque standard (fichier Controls\Dialog.mqh) : vous dérivez une classe de CAppDialog, vous y créez des contrôles comme CButton ou CLabel, vous reliez leurs clics à des méthodes avec les macros EVENT_MAP_BEGIN et ON_EVENT, puis vous créez le panneau dans OnInit, le détruisez dans OnDeinit et lui transmettez les événements du graphique dans OnChartEvent. Vous obtenez une fenêtre déplaçable et réductible, sans dessiner vous-même les objets graphiques.

Cette page de la rubrique Construire un Expert Advisor en MQL5 construit pas à pas un panneau utile en exploitation : un bouton pause/reprise, un bouton de fermeture des positions de l’EA et une ligne d’état. Pour les objets graphiques bruts (lignes, flèches, étiquettes), voyez Objets graphiques (ObjectCreate).

Pourquoi un panneau dans un EA

Un EA tourne seul, mais vous aurez parfois besoin d’intervenir : suspendre les nouvelles entrées avant une annonce, fermer les positions du robot sans toucher à vos positions manuelles, vérifier d’un coup d’œil son état. Modifier les paramètres pour cela recharge l’EA et réinitialise ses variables. Un panneau permet d’agir sans rechargement, avec des actions explicites et limitées.

Un panneau n’est utile que si quelqu’un le regarde : sur un serveur sans session ouverte, il ne sert à rien, et l’EA doit rester entièrement autonome sans lui.

Les briques de la bibliothèque

ClasseFichierRôle
CAppDialogControls\Dialog.mqhfenêtre d’application : titre, déplacement, réduction, fermeture
CButtonControls\Button.mqhbouton cliquable ; peut fonctionner en mode bascule avec Locking(true) et Pressed()
CLabelControls\Label.mqhtexte non modifiable
CEditControls\Edit.mqhchamp de saisie

CAppDialog hérite de CDialog, lui-même dérivé de CWndContainer et CWnd. Ses méthodes essentielles pour un EA sont :

  • virtual bool Create(const long chart, const string name, const int subwin, const int x1, const int y1, const int x2, const int y2) : crée la fenêtre aux coordonnées données ;
  • bool Run() : lance le traitement des événements du panneau ;
  • virtual bool ChartEvent(const int id, const long &lparam, const double &dparam, const string &sparam) : reçoit les événements du graphique ;
  • virtual void Destroy(const int reason = REASON_PROGRAM) : détruit la fenêtre et ses contrôles.

Chaque contrôle se crée avec la même logique de coordonnées : identifiant du graphique, nom unique, sous-fenêtre, coin supérieur gauche et coin inférieur droit, en pixels relatifs au panneau. Il est ensuite ajouté au panneau par Add(contrôle).

Code complet : panneau pause et fermeture

#property version "1.00"
#include <Controls\Dialog.mqh>
#include <Controls\Button.mqh>
#include <Controls\Label.mqh>
#include <Trade\Trade.mqh>

sinput ulong InpMagic = 260112;

#define INDENT     10      // marge intérieure
#define GAP        6       // espace entre contrôles
#define BTN_W      110     // largeur d'un bouton
#define BTN_H      24      // hauteur d'un bouton

CTrade trade;
bool   g_paused = false;   // lu par OnTick : true = pas de nouvelle entrée

//+------------------------------------------------------------------+
//| Panneau de contrôle de l'EA                                       |
//+------------------------------------------------------------------+
class CControlPanel : public CAppDialog
  {
private:
   CButton m_btnPause;
   CButton m_btnClose;
   CLabel  m_lblState;

public:
   virtual bool Create(const long chart, const string name, const int subwin,
                       const int x1, const int y1, const int x2, const int y2);
   virtual bool OnEvent(const int id, const long &lparam,
                        const double &dparam, const string &sparam);
   void         UpdateState(const string text) { m_lblState.Text(text); }

protected:
   void         OnClickPause(void);
   void         OnClickClose(void);
  };

//--- table des événements : clic sur un bouton -> méthode
EVENT_MAP_BEGIN(CControlPanel)
ON_EVENT(ON_CLICK, m_btnPause, OnClickPause)
ON_EVENT(ON_CLICK, m_btnClose, OnClickClose)
EVENT_MAP_END(CAppDialog)

bool CControlPanel::Create(const long chart, const string name, const int subwin,
                           const int x1, const int y1, const int x2, const int y2)
  {
   if(!CAppDialog::Create(chart, name, subwin, x1, y1, x2, y2)) return(false);

   //--- bouton bascule pause / reprise
   int x = INDENT, y = INDENT;
   if(!m_btnPause.Create(m_chart_id, m_name + "Pause", m_subwin, x, y, x + BTN_W, y + BTN_H)) return(false);
   m_btnPause.Text("Pause");
   m_btnPause.Locking(true);                 // le bouton reste enfoncé après un clic
   if(!Add(m_btnPause)) return(false);

   //--- bouton de fermeture des positions de l'EA
   x += BTN_W + GAP;
   if(!m_btnClose.Create(m_chart_id, m_name + "Close", m_subwin, x, y, x + BTN_W, y + BTN_H)) return(false);
   m_btnClose.Text("Tout fermer");
   if(!Add(m_btnClose)) return(false);

   //--- ligne d'état
   y += BTN_H + GAP;
   if(!m_lblState.Create(m_chart_id, m_name + "State", m_subwin, INDENT, y, INDENT + 2 * BTN_W + GAP, y + 20)) return(false);
   m_lblState.Text("Actif");
   if(!Add(m_lblState)) return(false);
   return(true);
  }

void CControlPanel::OnClickPause(void)
  {
   g_paused = m_btnPause.Pressed();
   m_btnPause.Text(g_paused ? "Reprendre" : "Pause");
   Print(g_paused ? "Nouvelles entrées suspendues depuis le panneau" : "Reprise depuis le panneau");
  }

void CControlPanel::OnClickClose(void)
  {
   for(int i = PositionsTotal() - 1; i >= 0; i--)
     {
      ulong t = PositionGetTicket(i);
      if(t > 0 && PositionGetInteger(POSITION_MAGIC) == (long)InpMagic)
         if(!trade.PositionClose(t))
            Print("Fermeture refusée pour ", t, " : ", trade.ResultRetcodeDescription());
     }
  }

CControlPanel ExtPanel;   // instance globale du panneau

int OnInit()
  {
   trade.SetExpertMagicNumber(InpMagic);
   if(!ExtPanel.Create(0, "Contrôle EA", 0, 20, 40, 20 + 2 * BTN_W + GAP + 2 * INDENT + 10, 160))
      return(INIT_FAILED);
   ExtPanel.Run();
   return(INIT_SUCCEEDED);
  }

void OnDeinit(const int reason)
  {
   ExtPanel.Destroy(reason);                 // supprime la fenêtre et ses objets
  }

void OnChartEvent(const int id, const long &lparam, const double &dparam, const string &sparam)
  {
   ExtPanel.ChartEvent(id, lparam, dparam, sparam);   // transmet clics et déplacements
  }

void OnTick()
  {
   ExtPanel.UpdateState(StringFormat("%s | positions : %d",
                        g_paused ? "En pause" : "Actif", PositionsTotal()));
   if(g_paused) return;                      // la gestion des positions ouvertes reste à placer avant
   //--- ici : filtres, signal, entrées
  }

Lecture du code

  • EVENT_MAP_BEGIN et EVENT_MAP_END génèrent le corps de la méthode OnEvent déclarée dans la classe ; chaque ON_EVENT(ON_CLICK, contrôle, méthode) relie le clic d’un contrôle à une méthode. EVENT_MAP_END(CAppDialog) transmet les autres événements à la classe parente, qui gère le déplacement et la réduction de la fenêtre.
  • Les noms des contrôles sont préfixés par m_name, le nom unique du panneau : deux panneaux sur des graphiques différents n’entrent pas en conflit.
  • Le panneau ne contient aucune logique de trading en dehors des actions demandées. Il modifie un drapeau (g_paused) que l’EA lit, ce qui garde une séparation nette entre interface et stratégie.
  • Destroy(reason) dans OnDeinit est indispensable : sans lui, des objets graphiques orphelins restent sur le graphique après l’arrêt de l’EA.

Concevoir un panneau utile

Avant d’écrire la moindre ligne d’interface, listez ce que vous ferez réellement avec le panneau. Pour un EA en exploitation, trois catégories suffisent presque toujours :

  • Voir : état de l’EA (actif, en pause, bloqué par la limite journalière), raison du dernier blocage d’entrée, nombre de positions et résultat du jour. Ces informations répondent à la question « pourquoi le robot ne fait-il rien ? » sans ouvrir le journal.
  • Suspendre : interrompre les nouvelles entrées sans arrêter la gestion des positions ouvertes. C’est l’action la plus fréquente, par exemple avant une annonce importante.
  • Sortir : fermer les positions du robot, et seulement les siennes, grâce au filtre par magic number.

Évitez en revanche les boutons d’achat et de vente manuels dans le panneau d’un EA automatique : ils mélangent décisions humaines et décisions du robot dans les mêmes statistiques, ce qui rend l’évaluation de la stratégie impossible. Si vous avez besoin d’un outil de passage d’ordres manuel, faites-en un programme séparé, avec son propre magic number.

Enfin, journalisez chaque action effectuée depuis le panneau. Lors de l’analyse d’une journée, il faut pouvoir distinguer une pause ou une fermeture décidée par vous d’un comportement de l’EA.

Pièges et bonnes pratiques

  • L’état du panneau est perdu au rechargement. Changer d’unité de temps recharge l’EA : g_paused repart à false et le bouton est recréé relâché. Si la pause doit survivre, enregistrez-la dans une variable globale du terminal et relisez-la dans OnInit.
  • Les actions destructrices doivent être confirmées. Un clic accidentel sur « Tout fermer » est vite arrivé. Ajoutez une confirmation, par exemple un second clic dans les trois secondes, ou une case à cocher d’armement.
  • Mettre à jour le panneau à chaque tick a un coût. Pour un affichage fréquent, rafraîchissez plutôt l’état depuis OnTimer une fois par seconde.
  • Le panneau masque le graphique. Gardez-le compact ; la fenêtre peut être réduite par l’utilisateur grâce au bouton prévu par CAppDialog.
  • Le testeur. Le panneau n’a de sens qu’en temps réel ou en test visuel. Dans un test non visuel ou une optimisation, la création du panneau ajoute un coût inutile : vous pouvez la conditionner à MQLInfoInteger(MQL_VISUAL_MODE) ou à l’absence de MQL_TESTER.
  • La pause ne doit pas couper la gestion des positions. Dans OnTick, placez la gestion des stops et des sorties avant le test de g_paused, pour qu’une position reste gérée pendant la pause.

Aller plus loin

La bibliothèque propose d’autres contrôles : champs de saisie (CEdit), cases à cocher (CCheckBox), listes déroulantes (CComboBox), boutons radio (CRadioGroup). Un exemple complet d’utilisation est fourni avec le terminal dans le dossier MQL5\Experts\Examples\Controls. CAppDialog propose aussi IniFileSave et IniFileLoad pour enregistrer l’état des contrôles dans un fichier. Les principes de programmation orientée objet utilisés ici (héritage, méthodes virtuelles) sont expliqués dans Héritage et polymorphisme.

Questions fréquentes

Pourquoi mes boutons ne réagissent-ils pas aux clics ?

Le plus souvent, OnChartEvent ne transmet pas les événements au panneau, ou Run() n’a pas été appelé après Create. Vérifiez aussi que chaque contrôle a bien été ajouté au panneau avec Add.

Le panneau reste affiché après la suppression de l’EA, que faire ?

Appelez Destroy(reason) dans OnDeinit. Les objets restés sur le graphique peuvent être supprimés à la main depuis la liste des objets du graphique.

Peut-on modifier un paramètre de l’EA depuis le panneau ?

Pas un paramètre input, qui est en lecture seule. En revanche, le panneau peut modifier une variable globale de l’EA initialisée à partir du paramètre, ce qui produit le même effet sans rechargement.

Le panneau fonctionne-t-il sur un serveur distant ?

Il fonctionne, mais il n’est visible que si vous ouvrez une session sur ce serveur. L’hébergement intégré à MetaTrader n’offre pas d’accès à l’interface du terminal : l’EA doit alors être entièrement autonome.

A

Alix · fondateur d’OptiBot Trading

Développeur MQL5 et ProBuilder, spécialiste du backtest et de l’optimisation de stratégies automatiques. Chaque contenu est vérifié sur la documentation officielle (MQL5.com, manuels ProRealTime) et testé avant publication. Notre méthode éditoriale.