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

ProRealTime · ProBuilder

RETURN en ProBuilder : afficher, nommer, colorer et styliser les courbes

Renvoyer plusieurs courbes avec RETURN, les nommer avec AS, les colorer dynamiquement avec COLOURED et choisir un style ligne, pointillé, histogramme ou points en ProBuilder.

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

Dans un indicateur ProBuilder, RETURN est l’instruction qui définit ce qui s’affiche. Elle s’écrit une seule fois, sur la dernière ligne du code, suivie des valeurs à tracer séparées par des virgules : RETURN a, b, c. Chaque valeur peut être nommée avec AS "Nom", colorée avec COLOURED(R, V, B) ou COLOURED("nom de couleur"), et dessinée dans un style particulier avec STYLE(LINE, 2), STYLE(HISTOGRAM), STYLE(POINT) ou des pointillés. Un RETURN sans valeur est également valide pour un indicateur qui ne fait que dessiner des objets.

Cette page détaille toutes ces options et montre comment construire un affichage lisible et dynamique. Elle fait partie de la rubrique Le langage ProBuilder ; les règles générales de structure d’un programme sont présentées dans le guide Syntaxe de base du ProBuilder.

La règle de base : un seul RETURN, en fin de code

Le manuel officiel est explicite : RETURN s’utilise une fois et une seule dans chaque programme, et il doit être suivi des variables à afficher. Il ne joue pas le rôle d’un « return » de fonction qui interromprait l’exécution au milieu du code : c’est une déclaration de sortie. Toute la logique se place donc avant, et le RETURN récapitule les séries calculées.

mm20 = Average[20](Close)
mm50 = Average[50](Close)
RETURN mm20, mm50               // deux courbes, séparées par une virgule

Les valeurs renvoyées peuvent être des variables, des expressions ou des constantes. Renvoyer une constante est la manière la plus simple de tracer un niveau fixe, par exemple les seuils 70 et 30 d’un oscillateur : RETURN monRSI, 70, 30.

Nommer les courbes avec AS

Par défaut, les courbes portent des noms génériques dans la fenêtre de réglages et dans l’infobulle. AS leur donne un nom explicite, ce qui facilite la lecture et la configuration :

RETURN mm20 AS "Moyenne 20", mm50 AS "Moyenne 50"

Ce nom apparaît dans les propriétés de l’indicateur, où l’utilisateur peut ensuite modifier manuellement la couleur et l’épaisseur de chaque courbe. Prenez l’habitude de nommer systématiquement vos sorties : quand un indicateur renvoie cinq valeurs, c’est indispensable. Les noms servent aussi lorsque l’indicateur est appelé par un autre code avec CALL, qui récupère les valeurs dans l’ordre du RETURN (voir CALL : appeler un indicateur).

Colorer avec COLOURED

COLOURED fixe la couleur d’une courbe directement depuis le code. Trois formes sont documentées :

FormeExempleEffet
RVBCOLOURED(0, 128, 255)rouge, vert, bleu de 0 à 255
Nom de couleurCOLOURED("cyan")l’une des couleurs nommées reconnues (noms de couleurs HTML)
RVB + transparenceCOLOURED(0, 128, 255, 100)alpha de 0 (transparent) à 255 (opaque)

Le paramètre de transparence est disponible depuis la version 10.3 de la plateforme, selon la documentation de ProRealCode.

L’intérêt majeur de COLOURED est de pouvoir utiliser des variables comme composantes. On calcule la couleur dans un bloc conditionnel, puis on la passe au RETURN : la courbe change de couleur selon la situation, barre par barre.

mm = Average[20](Close)
IF mm >= mm[1] THEN
   r = 0
   v = 170          // vert quand la moyenne monte
ELSE
   r = 220
   v = 0            // rouge quand elle baisse
ENDIF
RETURN mm COLOURED(r, v, 0) AS "MM20 colorée"

Choisir un style avec STYLE

STYLE(style, épaisseur) définit la manière de tracer la courbe. L’épaisseur va de 1 (la plus fine) à 5 (la plus épaisse).

StyleRendu
LINEligne continue (style par défaut)
DOTTEDLINEligne pointillée
DOTTEDLINE1 à DOTTEDLINE4variantes de pointillés de longueurs différentes
HISTOGRAMbarres verticales, uniquement dans le RETURN d’un indicateur
POINTsérie de points, uniquement dans le RETURN d’un indicateur

Dans les exemples de la documentation, l’ordre des options sur une même valeur est : la variable, puis COLOURED, puis STYLE, puis AS. Conservez cet ordre pour éviter toute erreur de validation.

Exemple complet : un oscillateur de type MACD lisible

L’indicateur suivant recalcule un oscillateur de type MACD à partir de moyennes exponentielles, puis l’affiche avec trois styles différents : un histogramme coloré selon son sens, une ligne pleine et une ligne pointillée, plus un niveau zéro. Pour l’instruction native équivalente, consultez la page MACD de la rubrique des instructions.

// Oscillateur type MACD avec affichage personnalisé
rapide = 12
lente = 26
periodeSignal = 9

ligne = ExponentialAverage[rapide](Close) - ExponentialAverage[lente](Close)
signal = ExponentialAverage[periodeSignal](ligne)
histo = ligne - signal

// Couleur de l'histogramme : vert s'il progresse, rouge s'il recule
IF histo >= histo[1] THEN
   r = 40
   v = 170
ELSE
   r = 210
   v = 60
ENDIF

RETURN histo COLOURED(r, v, 60, 150) STYLE(HISTOGRAM, 2) AS "Histogramme", ligne COLOURED(30, 90, 200) STYLE(LINE, 2) AS "Ligne", signal COLOURED(230, 140, 0) STYLE(DOTTEDLINE, 1) AS "Signal", 0 COLOURED("grey") AS "Zéro"

Le paramètre alpha de 150 rend l’histogramme semi-transparent : les lignes restent visibles par-dessus. Toutes les sorties sont nommées, ce qui permet de les retrouver facilement dans la fenêtre de propriétés.

Indicateur sur le prix ou dans un panneau séparé

Le code ne détermine pas où s’affiche l’indicateur : c’est au moment de l’appliquer au graphique que vous choisissez de le superposer au prix ou de l’afficher dans un panneau dédié. La règle de bon sens est d’afficher sur le prix les valeurs exprimées en prix (moyennes, bandes, niveaux) et dans un panneau séparé les oscillateurs, dont l’échelle n’a rien à voir avec celle du prix. Mélanger les deux écrase l’échelle et rend le graphique illisible.

RETURN vide et objets graphiques

Un indicateur peut ne renvoyer aucune courbe : il se contente alors de RETURN seul, et son rôle est de dessiner des flèches, des textes ou des zones avec les instructions DRAW.... C’est le cas typique d’un indicateur de signaux superposé au prix. Ces instructions sont présentées dans le guide DRAWTEXT, DRAWARROW et objets graphiques. Vous pouvez bien sûr combiner les deux : renvoyer des courbes et dessiner des objets dans le même code.

Vérifier des valeurs sans les tracer : PRINT

Toutes les valeurs utiles au développement n’ont pas vocation à être tracées. Pour contrôler un calcul intermédiaire, les versions récentes de ProRealTime proposent PRINT, qui affiche des valeurs barre par barre dans une fenêtre séparée du graphique. Sa syntaxe reprend celle du RETURN : PRINT(ecart) AS "Écart", avec en option COLOURED pour la couleur du texte et FILLCOLOR pour le fond de la case. La documentation indique qu’on peut afficher jusqu’à dix valeurs par code, que la fenêtre conserve les 200 calculs les plus récents, et que PRINT peut être placé dans un bloc IF pour n’afficher que certaines barres. C’est un outil de mise au point : retirez-le de la version finale, comme le recommande la documentation, pour préserver les performances. En pratique, PRINT remplace avantageusement l’ancienne méthode qui consistait à ajouter temporairement des courbes au RETURN, puis à les supprimer.

Pièges fréquents

  • Plusieurs RETURN ou un RETURN placé au milieu du code : la validation échoue ou le résultat n’est pas celui attendu.
  • Valeurs nulles en début d’historique : une variable qui vaut 0 sur les premières barres écrase l’échelle de l’indicateur. Utilisez Undefined ou un test sur BarIndex.
  • Ordre des options : respectez l’enchaînement valeur, COLOURED, STYLE, AS.
  • Styles réservés : HISTOGRAM et POINT ne s’appliquent qu’aux valeurs d’un RETURN, pas aux objets dessinés.
  • Trop de courbes : au-delà de quatre ou cinq, la lecture devient difficile. Séparez en plusieurs indicateurs si nécessaire.
  • Couleurs codées en dur : l’utilisateur peut les modifier dans les propriétés ; ne comptez pas sur la couleur seule pour transmettre une information essentielle.

FAQ

Peut-on écrire plusieurs RETURN dans un indicateur ?

Non. RETURN s’utilise une seule fois, en dernière ligne. Pour renvoyer plusieurs courbes, séparez-les par des virgules dans ce même RETURN.

Comment tracer une ligne horizontale à un niveau fixe ?

Le plus simple est de renvoyer une constante, par exemple RETURN monRSI, 70, 30. Vous pouvez aussi utiliser DRAWHLINE, présentée dans le guide des objets graphiques.

Comment changer la couleur d’une courbe selon une condition ?

Calculez les composantes rouge, vert et bleu dans un bloc IF … ELSE … ENDIF, puis passez ces variables à COLOURED dans la ligne RETURN. La couleur est alors réévaluée à chaque barre.

Comment afficher une courbe en histogramme ?

Ajoutez STYLE(HISTOGRAM) à la valeur concernée dans le RETURN, éventuellement avec une épaisseur, par exemple STYLE(HISTOGRAM, 2). Ce style n’est disponible que pour les valeurs renvoyées par un indicateur.

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.