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

MQL5 · Indicateurs

Objets graphiques en MQL5 : ObjectCreate, propriétés et nettoyage

ObjectCreate() et les fonctions ObjectSet permettent de tracer niveaux, flèches et étiquettes. Noms uniques, exécution asynchrone, préfixes, clics et EA complet commenté.

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

Pour dessiner sur un graphique MetaTrader 5 autre chose que des courbes d’indicateur (une ligne de niveau, une flèche de signal, une étiquette d’information), on utilise les objets graphiques : ObjectCreate() crée l’objet, les fonctions ObjectSetInteger(), ObjectSetDouble() et ObjectSetString() règlent ses propriétés, ObjectMove() déplace ses points d’ancrage et ObjectDelete() ou ObjectsDeleteAll() le suppriment. Deux règles conditionnent tout le reste : chaque objet est identifié par un nom unique sur le graphique, et la plupart de ces fonctions sont asynchrones, c’est-à-dire qu’elles déposent une commande dans la file du graphique sans attendre son exécution.

ObjectCreate : la signature

bool ObjectCreate(
   long         chart_id,     // identifiant du graphique, 0 = graphique courant
   string       name,         // nom unique sur le graphique (63 caractères au plus)
   ENUM_OBJECT  type,         // type d'objet : OBJ_HLINE, OBJ_TREND, OBJ_LABEL...
   int          sub_window,   // 0 = fenêtre principale, 1, 2... = sous-fenêtres
   datetime     time1,        // temps du premier point d'ancrage
   double       price1,       // prix du premier point d'ancrage
   ...                        // points suivants : time2, price2, ... jusqu'à 30 points
   );

La documentation précise que le nom doit être unique sur tout le graphique, sous-fenêtres comprises, et que si un objet de ce nom existe déjà, la fonction tente simplement de modifier ses coordonnées. La sous-fenêtre doit exister, sinon la fonction renvoie false ; les sous-fenêtres d’indicateurs sont numérotées à partir de 1, la fenêtre principale étant toujours 0.

Asynchrone : ce que signifie « true »

ObjectCreate() renvoie true lorsque la commande a été ajoutée à la file du graphique, pas lorsque l’objet existe. Il en va de même pour ObjectSetInteger(), ObjectMove() et ObjectDelete(). Pour vérifier qu’une opération a réellement abouti, la documentation recommande d’interroger l’objet avec ObjectFind() ou une fonction ObjectGet...(). Ces fonctions-là sont synchrones : elles se placent en fin de file et attendent que toutes les commandes précédentes soient exécutées. Elles sont donc lentes lorsqu’on manipule beaucoup d’objets, et il faut éviter de les appeler dans une boucle serrée. ObjectsDeleteAll() est également synchrone.

En pratique : créez et réglez vos objets sans vérification systématique, puis appelez ChartRedraw() une fois les modifications terminées pour forcer le rafraîchissement. Réservez ObjectFind() aux moments où vous devez savoir si un objet existe, par exemple avant de décider entre création et déplacement.

Deux familles d’objets : ancrés au prix ou à l’écran

La plupart des objets sont positionnés par des coordonnées temps/prix : ils suivent le graphique quand on le fait défiler. Le nombre de points d’ancrage dépend du type : un pour une ligne horizontale ou verticale, deux pour une ligne de tendance, trois pour une fourchette d’Andrews. Quelques objets, en revanche, sont positionnés en pixels par rapport à un coin du graphique, avec OBJPROP_XDISTANCE et OBJPROP_YDISTANCE : l’étiquette (OBJ_LABEL), le bouton (OBJ_BUTTON), le champ de saisie (OBJ_EDIT), l’image (OBJ_BITMAP_LABEL), le rectangle d’interface (OBJ_RECTANGLE_LABEL) et le graphique intégré (OBJ_CHART). Ils restent fixes à l’écran, ce qui en fait la base des panneaux d’information.

BesoinType d’objetPositionnement
Niveau de prix sur toute la largeurOBJ_HLINE1 point (prix)
Niveau limité dans le temps ou prolongé à droiteOBJ_TREND2 points
Zone horizontaleOBJ_RECTANGLE2 points
Signal ponctuelOBJ_ARROW_BUY, OBJ_ARROW_SELL, OBJ_ARROW1 point
Texte attaché à une bougieOBJ_TEXT1 point
Texte fixe à l’écranOBJ_LABELCoin + pixels

Les propriétés les plus utiles

Les propriétés se règlent après la création. Parmi les identifiants de l’énumération des propriétés entières, les plus courants sont OBJPROP_COLOR, OBJPROP_STYLE, OBJPROP_WIDTH, OBJPROP_BACK (dessiner en arrière-plan), OBJPROP_SELECTABLE (sélection à la souris), OBJPROP_HIDDEN (masquer l’objet dans la liste des objets et le protéger d’une suppression manuelle), OBJPROP_RAY_RIGHT (prolonger une ligne vers la droite), OBJPROP_CORNER, OBJPROP_XDISTANCE, OBJPROP_YDISTANCE et OBJPROP_FONTSIZE. Côté texte, OBJPROP_TEXT et OBJPROP_TOOLTIP. Côté réel, OBJPROP_PRICE, dont le modificateur désigne le numéro du point d’ancrage.

Exemple complet : niveaux de la veille, flèche de cassure et étiquette cliquable

L’Expert Advisor suivant ne passe aucun ordre. Il trace le plus haut et le plus bas de la veille, pose une flèche lorsqu’une bougie clôture au-dessus du plus haut, affiche une étiquette récapitulative dans le coin supérieur gauche et permet de masquer ou réafficher les niveaux en cliquant sur cette étiquette. Tous les objets partagent un préfixe, ce qui permet de les supprimer en une instruction.

//+------------------------------------------------------------------+
//| DailyLevels.mq5 - objets graphiques : niveaux, flèches, étiquette |
//+------------------------------------------------------------------+
input color InpHighColor = clrTomato;     // couleur du plus haut de la veille
input color InpLowColor  = clrSeaGreen;   // couleur du plus bas de la veille

const string PREFIX = "DL_";              // préfixe commun à tous nos objets
bool levelsVisible  = true;

//--- crée ou déplace un segment horizontal prolongé vers la droite
void DrawLevel(const string name, datetime t1, datetime t2, double price,
               color clr, const string tip)
  {
   if(ObjectFind(0, name) < 0)
     {
      if(!ObjectCreate(0, name, OBJ_TREND, 0, t1, price, t2, price))
        {
         PrintFormat("ObjectCreate(%s) : erreur %d", name, GetLastError());
         return;
        }
      ObjectSetInteger(0, name, OBJPROP_COLOR, clr);
      ObjectSetInteger(0, name, OBJPROP_STYLE, STYLE_DASH);
      ObjectSetInteger(0, name, OBJPROP_WIDTH, 1);
      ObjectSetInteger(0, name, OBJPROP_RAY_RIGHT, true);
      ObjectSetInteger(0, name, OBJPROP_BACK, true);
      ObjectSetInteger(0, name, OBJPROP_SELECTABLE, false);
      ObjectSetInteger(0, name, OBJPROP_HIDDEN, true);
     }
   else
     {
      ObjectMove(0, name, 0, t1, price);   // point d'ancrage 0
      ObjectMove(0, name, 1, t2, price);   // point d'ancrage 1
     }
   ObjectSetString(0, name, OBJPROP_TOOLTIP, tip);
  }

//--- étiquette fixe dans le coin supérieur gauche
void DrawLabel(const string text)
  {
   string name = PREFIX + "panel";
   if(ObjectFind(0, name) < 0)
     {
      ObjectCreate(0, name, OBJ_LABEL, 0, 0, 0);
      ObjectSetInteger(0, name, OBJPROP_CORNER, CORNER_LEFT_UPPER);
      ObjectSetInteger(0, name, OBJPROP_XDISTANCE, 10);
      ObjectSetInteger(0, name, OBJPROP_YDISTANCE, 20);
      ObjectSetInteger(0, name, OBJPROP_FONTSIZE, 10);
      ObjectSetInteger(0, name, OBJPROP_COLOR, clrSilver);
     }
   ObjectSetString(0, name, OBJPROP_TEXT, text);
  }

void Refresh()
  {
   datetime yOpen = iTime(_Symbol, PERIOD_D1, 1);
   datetime tOpen = iTime(_Symbol, PERIOD_D1, 0);
   double   yHigh = iHigh(_Symbol, PERIOD_D1, 1);
   double   yLow  = iLow(_Symbol, PERIOD_D1, 1);
   if(yOpen == 0 || tOpen == 0 || yHigh == 0.0 || yLow == 0.0)
      return;                                  // données journalières pas prêtes

   DrawLevel(PREFIX + "high", yOpen, tOpen, yHigh, InpHighColor, "Plus haut de la veille");
   DrawLevel(PREFIX + "low",  yOpen, tOpen, yLow,  InpLowColor,  "Plus bas de la veille");

   //--- flèche si la dernière bougie close a clôturé au-dessus du plus haut
   double c1 = iClose(_Symbol, PERIOD_CURRENT, 1);
   datetime t1 = iTime(_Symbol, PERIOD_CURRENT, 1);
   string arrow = PREFIX + "up_" + TimeToString(t1, TIME_DATE | TIME_MINUTES);
   if(t1 >= tOpen && c1 > yHigh && ObjectFind(0, arrow) < 0)
      ObjectCreate(0, arrow, OBJ_ARROW_BUY, 0, t1, iLow(_Symbol, PERIOD_CURRENT, 1));

   DrawLabel(StringFormat("Veille : H %s / B %s  (cliquer pour %s)",
                          DoubleToString(yHigh, _Digits), DoubleToString(yLow, _Digits),
                          levelsVisible ? "masquer" : "afficher"));
   ChartRedraw();                              // un seul rafraîchissement
  }

int OnInit()
  {
   Refresh();
   return(INIT_SUCCEEDED);
  }

void OnDeinit(const int reason)
  {
   ObjectsDeleteAll(0, PREFIX);                // supprime tous nos objets, et eux seuls
   ChartRedraw();
  }

void OnTick()
  {
   static datetime lastBar = 0;
   datetime bar = iTime(_Symbol, PERIOD_CURRENT, 0);
   if(bar == lastBar) return;
   lastBar = bar;
   Refresh();
  }

void OnChartEvent(const int id, const long &lparam, const double &dparam, const string &sparam)
  {
   if(id == CHARTEVENT_OBJECT_CLICK && sparam == PREFIX + "panel")
     {
      levelsVisible = !levelsVisible;
      long flags = levelsVisible ? OBJ_ALL_PERIODS : OBJ_NO_PERIODS;
      ObjectSetInteger(0, PREFIX + "high", OBJPROP_TIMEFRAMES, flags);
      ObjectSetInteger(0, PREFIX + "low",  OBJPROP_TIMEFRAMES, flags);
      Refresh();
     }
  }

Ce que l’exemple met en pratique

Le préfixe. Tous les noms commencent par DL_. ObjectsDeleteAll(0, PREFIX) supprime alors en une ligne tous les objets du programme, sans toucher aux lignes que l’utilisateur a tracées à la main ni aux objets d’autres programmes. Un programme qui laisse ses objets sur le graphique après son retrait, ou qui efface ceux des autres avec ObjectsDeleteAll(0), est l’un des défauts les plus irritants pour un utilisateur.

Créer ou déplacer. DrawLevel() crée l’objet s’il n’existe pas et se contente de le déplacer sinon. Recréer l’objet à chaque bougie fonctionnerait aussi, mais réinitialiserait les propriétés et produirait des événements de création et de suppression inutiles.

Des noms uniques pour les objets multiples. Chaque flèche porte dans son nom l’heure de sa bougie : une flèche par bougie de cassure, jamais deux pour la même.

Un seul ChartRedraw(). Les modifications sont regroupées et le graphique n’est redessiné qu’une fois, à la fin de Refresh().

L’événement de clic. Pour CHARTEVENT_OBJECT_CLICK, le paramètre sparam contient le nom de l’objet cliqué. Les événements graphiques et leurs paramètres sont présentés sur la page Les fonctions événementielles ; pour une véritable interface avec boutons et panneaux, voyez Panneaux et boutons (CAppDialog).

Objets ou buffers d’indicateur ?

Un indicateur personnalisé peut aussi dessiner des flèches avec un tracé DRAW_ARROW. Le choix dépend de l’usage : les buffers d’indicateur sont gérés par le terminal, suivent automatiquement l’historique et sont lisibles par un EA via iCustom(), mais ils sont limités aux formes prévues par les styles de tracé. Les objets offrent une liberté totale (textes, zones, panneaux, info-bulles) mais doivent être entretenus et supprimés par votre code, et ne sont pas accessibles par CopyBuffer(). Pour des centaines de signaux sur l’historique, préférez les buffers, décrits sur la page Buffers et styles de tracé ; pour quelques repères, des niveaux ou un panneau, les objets sont plus adaptés.

Pièges fréquents

  • Les noms trop longs ou en double : au-delà de 63 caractères ou en cas de doublon, l’objet n’est pas celui que vous croyez.
  • Le test visuel : dans le testeur, les objets créés par l’EA s’affichent sur le graphique de test ; pensez à les nettoyer dans OnDeinit() pour ne pas polluer vos graphiques réels lors d’essais en direct.
  • Les milliers d’objets : chaque objet a un coût d’affichage. Un indicateur qui crée un objet par bougie sur tout l’historique ralentit visiblement le terminal.
  • Les vérifications synchrones en boucle : appeler ObjectFind() ou ObjectGetInteger() des centaines de fois par tick attend à chaque fois la file du graphique.

La rubrique Indicateurs en MQL5 rassemble les autres pages sur l’affichage et le calcul des indicateurs.

FAQ

Pourquoi ObjectCreate renvoie-t-il true alors que l’objet n’apparaît pas ?

Parce que la fonction est asynchrone : true signifie seulement que la commande a été placée dans la file du graphique. Vérifiez l’existence de l’objet avec ObjectFind() et appelez ChartRedraw() après vos modifications.

Comment supprimer uniquement les objets créés par mon programme ?

Donnez-leur un préfixe commun et appelez ObjectsDeleteAll(0, "PREFIXE_") dans OnDeinit(). Seuls les objets dont le nom commence par ce préfixe sont supprimés.

Comment placer un texte fixe dans un coin du graphique ?

Utilisez un objet OBJ_LABEL et réglez OBJPROP_CORNER, OBJPROP_XDISTANCE et OBJPROP_YDISTANCE. Il reste au même endroit de l’écran quand le graphique défile.

Comment savoir quel objet a été cliqué ?

Dans OnChartEvent(), l’événement CHARTEVENT_OBJECT_CLICK transmet le nom de l’objet dans le paramètre sparam.

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.