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.
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
| Classe | Fichier | Rôle |
|---|---|---|
CAppDialog | Controls\Dialog.mqh | fenêtre d’application : titre, déplacement, réduction, fermeture |
CButton | Controls\Button.mqh | bouton cliquable ; peut fonctionner en mode bascule avec Locking(true) et Pressed() |
CLabel | Controls\Label.mqh | texte non modifiable |
CEdit | Controls\Edit.mqh | champ 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_BEGINetEVENT_MAP_ENDgénèrent le corps de la méthodeOnEventdéclarée dans la classe ; chaqueON_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)dansOnDeinitest 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_pausedrepart àfalseet le bouton est recréé relâché. Si la pause doit survivre, enregistrez-la dans une variable globale du terminal et relisez-la dansOnInit. - 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 deMQL_TESTER. - La pause ne doit pas couper la gestion des positions. Dans
OnTick, placez la gestion des stops et des sorties avant le test deg_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.
- Structure d’un Expert Advisor
- Détecter une nouvelle bougie
- Coder un signal d’entrée
- Filtres horaires, de spread et de volatilité
- Intégrer la gestion du risque
- Limite de perte journalière
- EA multi-symboles
- Utiliser OnTimer
- Variables globales du terminal
- Sauvegarder l’état dans des fichiers
- Alertes, e-mails et notifications push
- L’assistant MQL5 (MQL5 Wizard)
- Déployer un EA sur VPS
- Checklist avant mise en production
