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

ProRealTime · ProBuilder

DRAWTEXT, DRAWARROW et objets graphiques en ProBuilder

Dessiner flèches, textes, segments, rectangles, zones colorées et tableaux de bord en ProBuilder : coordonnées, paramètres, ANCHOR, DRAWONLASTBARONLY et un indicateur de signaux annotés.

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

ProBuilder permet de dessiner directement sur le graphique : flèches de signal avec DRAWARROWUP et DRAWARROWDOWN, textes avec DRAWTEXT, segments, lignes, rectangles, triangles, ellipses, points, bougies personnalisées, couleurs de fond et zones colorées entre deux courbes. Chaque objet se positionne avec des coordonnées : en abscisse un numéro de barre (BarIndex), en ordonnée une valeur sur l’échelle du prix ou de l’indicateur. Ces instructions se placent dans le corps du code, souvent à l’intérieur d’un IF, et l’indicateur se termine généralement par un RETURN vide.

Cette page présente les instructions graphiques documentées, leurs paramètres et les bonnes pratiques pour garder un graphique lisible et rapide. Elle fait partie de la rubrique Le langage ProBuilder et complète le guide RETURN et affichage des courbes, consacré aux courbes.

Le système de coordonnées

Par défaut, l’axe horizontal est exprimé en numéro de barre et l’axe vertical en valeur, sur l’échelle du panneau où l’indicateur est affiché. Pour dessiner sur la barre courante, on utilise BarIndex ; pour la barre précédente, BarIndex - 1 ou BarIndex[1]. L’ordonnée est un prix si l’indicateur est superposé au cours, ou une valeur d’oscillateur s’il est dans un panneau séparé. Le fonctionnement de BarIndex est détaillé dans le guide ONCE et BarIndex.

Deux outils permettent de sortir de ce repère : DateToBarIndex(date) convertit une date en numéro de barre, et ANCHOR, présenté plus bas, place un objet par rapport aux bords de la fenêtre.

Les flèches

InstructionObjet
DRAWARROWUP(x, y)flèche vers le haut, typiquement sous une bougie d’achat
DRAWARROWDOWN(x, y)flèche vers le bas, typiquement au-dessus d’une bougie de vente
DRAWARROW(x, y)flèche pointant vers la droite

Toutes acceptent COLOURED(R, V, B) ou COLOURED(R, V, B, alpha). Pour que la flèche ne recouvre pas la bougie, on la décale d’une fraction de la volatilité, par exemple la moitié de l’ATR sous le plus bas. Utiliser un décalage proportionnel plutôt qu’un nombre de points fixe garantit un rendu correct sur tous les marchés. L’ATR est présenté sur la page AverageTrueRange.

Le texte : DRAWTEXT

DRAWTEXT("Texte", x, y, SERIF, BOLD, 10) COLOURED(0, 0, 0)

Les trois premiers paramètres sont obligatoires : le texte entre guillemets, l’abscisse et l’ordonnée. Les trois suivants sont facultatifs : la police (DIALOG, MONOSPACED, SANSERIF, SERIF), le style (STANDARD, BOLD, ITALIC, BOLDITALIC) et la taille. Pour insérer la valeur d’une variable dans le texte, on encadre son nom par des dièses : DRAWTEXT("RSI : #r#", BarIndex, High) affiche la valeur courante de r. Arrondissez la variable avant de l’afficher (r = ROUND(r, 1)) pour éviter des décimales inutiles.

Lignes, segments et formes

InstructionObjet dessiné
DRAWSEGMENT(x1, y1, x2, y2)segment entre deux points
DRAWLINE(x1, y1, x2, y2)droite passant par deux points
DRAWRAY(x1, y1, x2, y2)demi-droite partant du premier point
DRAWHLINE(y)ligne horizontale au niveau y
DRAWVLINE(x)ligne verticale sur la barre x
DRAWRECTANGLE(x1, y1, x2, y2)rectangle défini par deux coins
DRAWTRIANGLE(x1, y1, x2, y2, x3, y3)triangle défini par trois points
DRAWELLIPSE(x1, y1, x2, y2)ellipse inscrite dans le rectangle
DRAWPOINT(x, y, taille)point d’une taille donnée
DRAWCANDLE(o, h, l, c)bougie personnalisée
DRAWBARCHART(o, h, l, c)barre OHLC personnalisée

Plusieurs paramètres complémentaires s’ajoutent à ces instructions. COLOURED fixe la couleur, BORDERCOLOR la couleur de bordure des formes (hors lignes et flèches), et STYLE(style, épaisseur) le type de trait : LINE ou DOTTEDLINE à DOTTEDLINE4, avec une épaisseur de 1 à 5. Les styles HISTOGRAM et POINT sont réservés aux valeurs d’un RETURN.

DRAWCANDLE et DRAWBARCHART servent à construire des représentations alternatives des prix, par exemple des bougies lissées ou recalculées : les quatre paramètres peuvent être des constantes de prix ou des variables calculées.

Les couleurs de fond et les zones

BACKGROUNDCOLOR(R, V, B, alpha) colore le fond du graphique sur la barre en cours : placé dans un IF, il met en évidence certaines périodes (une séance, un régime de volatilité). COLORBETWEEN(valeur1, valeur2, couleur) remplit l’espace entre deux valeurs, par exemple entre deux moyennes mobiles, avec une couleur RVB ou nommée. C’est la façon la plus lisible de visualiser un écart ou un canal.

Positionner par rapport à la fenêtre : ANCHOR

ANCHOR(point, unitéX, unitéY) place un objet par rapport à un point de référence de la fenêtre plutôt que par rapport aux bougies. Le point peut être TOPLEFT, TOP, TOPRIGHT, RIGHT, BOTTOMRIGHT, BOTTOM, BOTTOMLEFT, LEFT ou MIDDLE. L’unité horizontale est INDEX (numéro de barre) ou XSHIFT (décalage en pixels) ; l’unité verticale est VALUE (prix) ou YSHIFT (pixels). C’est la méthode pour afficher un tableau de bord fixe dans un coin du graphique, qui ne se déplace pas quand on fait défiler l’historique.

Exemple complet : signaux RSI annotés

Cet indicateur, à superposer au graphique des prix, dessine une flèche verte sous la bougie lorsque le RSI sort de la zone de survente et une flèche rouge au-dessus lorsqu’il sort de la zone de surachat, chacune accompagnée de la valeur du RSI. Le fonctionnement du RSI est expliqué sur la page RSI.

// Signaux RSI annotés sur le graphique des prix
atr = AverageTrueRange[14](Close)     // sert à décaler les objets proportionnellement à la volatilité
r = ROUND(RSI[14](Close), 1)          // RSI arrondi à une décimale pour l'affichage

IF r CROSSES OVER 30 THEN
   // flèche sous le plus bas, texte encore un peu plus bas
   DRAWARROWUP(BarIndex, Low - atr * 0.5) COLOURED(0, 160, 0)
   DRAWTEXT("RSI #r#", BarIndex, Low - atr * 1.2, SANSERIF, BOLD, 10) COLOURED(0, 120, 0)
ENDIF

IF r CROSSES UNDER 70 THEN
   // flèche au-dessus du plus haut, texte encore un peu plus haut
   DRAWARROWDOWN(BarIndex, High + atr * 0.5) COLOURED(200, 0, 0)
   DRAWTEXT("RSI #r#", BarIndex, High + atr * 1.2, SANSERIF, BOLD, 10) COLOURED(160, 0, 0)
ENDIF

RETURN                                 // aucune courbe : l'indicateur ne fait que dessiner

L’indicateur s’applique sur le prix : les ordonnées (Low, High) sont des prix. Appliqué dans un panneau séparé, il dessinerait les objets hors de l’échelle de ce panneau.

Dessiner seulement sur la dernière barre

Par défaut, un objet dessiné dans un IF l’est sur toutes les barres où la condition est vraie, dans tout l’historique. Pour un tableau de bord ou une ligne de niveau actuel, ce n’est pas souhaitable. DEFPARAM DRAWONLASTBARONLY = true, placé en tout début de code, limite le dessin à la dernière barre : les objets sont redessinés à chaque mise à jour et ne s’accumulent pas. La documentation suggère de le combiner avec DEFPARAM CALCULATEONLASTBARS pour alléger les calculs. Attention : ce paramètre s’applique à tous les objets du code, y compris aux flèches de signal.

Bonnes pratiques et pièges

  • Ne surchargez pas le graphique : des centaines de textes rendent la lecture impossible et ralentissent l’affichage.
  • Décalez les objets avec la volatilité plutôt qu’avec une valeur fixe.
  • Signal sur barre non clôturée : en temps réel, une flèche dessinée sur la barre en cours peut apparaître puis disparaître. Pour des signaux définitifs, testez la condition sur la barre précédente et dessinez sur BarIndex - 1.
  • Mauvaise échelle : un objet positionné avec un prix dans un panneau d’oscillateur sera invisible.
  • Objets multiples via des boucles : dessinez-les sur la dernière barre uniquement, comme dans l’exemple du guide Tableaux ($tableau).
Une flèche sur un graphique historique paraît toujours convaincante, car on voit le mouvement qui suit. Elle ne dit rien de la rentabilité du signal : seul un backtest avec coûts réalistes permet d’en juger.

FAQ

Comment afficher la valeur d’une variable dans un texte ?

Encadrez le nom de la variable par des dièses dans la chaîne de DRAWTEXT, par exemple DRAWTEXT(« Valeur : #maVariable# », BarIndex, High). Arrondissez la variable au préalable avec ROUND pour limiter les décimales.

Pourquoi mes flèches n’apparaissent-elles pas ?

Vérifiez trois points : la condition est-elle réellement vraie (affichez-la avec RETURN ou PRINT) ; l’ordonnée est-elle sur la bonne échelle (prix sur le graphique des prix) ; DRAWONLASTBARONLY n’est-il pas activé, ce qui limiterait le dessin à la dernière barre.

Comment colorer la zone entre deux moyennes mobiles ?

Utilisez COLORBETWEEN(moyenne1, moyenne2, couleur). Placé dans un IF … ELSE, il permet par exemple de colorer la zone en vert quand la moyenne rapide est au-dessus et en rouge dans le cas contraire.

Peut-on dessiner dans le futur, à droite de la dernière barre ?

Oui, en passant une abscisse supérieure au BarIndex courant, par exemple BarIndex + 10, ou en utilisant DRAWRAY et DRAWLINE, qui se prolongent au-delà de leurs points de définition.

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.