Rejoignez-nous
Graphiques/probuilder

DRAWVLINE

DRAWVLINE en ProBuilder dessine une ligne verticale à un index de bar donné, avec une couleur COLOURED et une transparence optionnelles. Syntaxe, paramètres et exemples détaillés.

Syntaxe

probuilder
DRAWVLINE(x1) COLOURED(R, G, B, a)

Paramètres

NomTypePar défautDescription
x1entierrequisL'index de bar auquel la ligne verticale est dessinée.
R, G, Bentiervaleur par défaut de la plateformeOptionnel COLOURED composantes rouge, verte et bleue, de 0 à 255.
aentier255Alpha optionnel (transparence), 0 totalement transparent à 255 totalement opaque.

Comment ça marche

DRAWVLINE s'exécute dans un indicateur ProBuilder. Elle trace une ligne verticale qui traverse le graphique de haut en bas à l'indice de bar x1. Seule une coordonnée x est nécessaire, puisqu'une ligne verticale n'a ni prix de départ ni prix de fin. C'est pratique pour marquer un instant, comme le bar du plus haut ou une limite de séance.

La valeur x est normalement un index de bar issu de BarIndex. Le paramètre facultatif COLOURED clause définit la couleur et la transparence. Comme une seule ligne couvre toute la hauteur, la plupart des scripts définissent DEFPARAM DrawOnLastBarOnly = true afin qu'il soit tracé une seule fois plutôt qu'à chaque bar.

Exemples

Exemple 1, Marquer les bars du plus haut et du plus bas récents (Indicateur)

probuilder
// Green line on the highest bar, red line on the lowest bar over 15 bars
DEFPARAM DrawOnLastBarOnly = true
period = 15
Yhh = Highest[period](high)
Yll = Lowest[period](low)
FOR i = 0 TO period DO
    IF high[i] = Yhh THEN
        Xhh = BarIndex[i]
    ENDIF
    IF low[i] = Yll THEN
        Xll = BarIndex[i]
    ENDIF
NEXT
DRAWVLINE(Xhh) COLOURED(0, 200, 0)
DRAWVLINE(Xll) COLOURED(200, 0, 0)
RETURN

La boucle localise les index de bar des prix extrêmes, puis deux lignes verticales les marquent.

Exemple 2, Une ligne à un décalage de bars fixe (Indicateur)

probuilder
// A grey vertical line 50 bars back from the current bar
DEFPARAM DrawOnLastBarOnly = true
DRAWVLINE(BarIndex-50) COLOURED(128, 128, 128, 180)
RETURN

Un seul appel marque un bar à une distance fixe derrière le bar actuel.

Exemple 3, Ligne verticale avec une légende (Indicateur)

probuilder
// Mark the current bar and label it
DEFPARAM DrawOnLastBarOnly = true
DRAWVLINE(BarIndex) COLOURED(0, 100, 255)
DRAWTEXT("now", BarIndex, close) COLOURED(0, 100, 255)
RETURN

DRAWVLINE marque la bar et DRAWTEXT le nomme.

Erreurs et pièges courants

  • Indicateur uniquement. DRAWVLINE n'a aucun effet dans ProScreener, ProOrder ou ProBacktest. Réservez-le à un indicateur ProBuilder.
  • Un seul argument. Elle prend un seul indice de bar x1. Pour une ligne entre deux points quelconques, utilisez DRAWLINE ou DRAWSEGMENT.
  • X est un indice de bar, pas un prix. Passer un prix place la ligne sur le mauvais bar. Utilisez BarIndex ou un décalage par rapport à celui-ci.
  • Équivalent horizontal. Pour un niveau à un prix fixe, utilisez DRAWHLINE à la place.
  • DRAWHLINE, une ligne horizontale à un seul niveau de prix, l'équivalent de cette instruction.
  • DRAWLINE, une ligne entre deux points quelconques.
  • DRAWSEGMENT, un segment entre deux points.
  • COLOURED, définit la couleur et la transparence.
  • DrawOnLastBarOnly, limite le tracé au dernier bar pour des raisons de performance.
  • BarIndex, fournit la coordonnée x.
  • Highest, trouve un plus haut récent à marquer.
  • Lowest, trouve un plus bas récent à marquer.