English
Rejoignez-nous
Graphiques/probuilder

DRAWTEXT

DRAWTEXT en ProBuilder affiche une étiquette de texte sur le graphique à un index de bar et un prix, avec police, style, taille et couleur COLOURED optionnels. Syntaxe et exemples détaillés.

Syntaxe

probuilder
DRAWTEXT("text", x1, y1, font, style, size) COLOURED(R, G, B, a)

Paramètres

NomTypePar défautDescription
"text"chaînerequisLe texte à afficher, entre guillemets. Des variables peuvent être insérées entre # symboles.
x1entierrequisIndex de bar où le texte commence.
y1prixrequisPrix ou valeur verticale où le texte est placé.
fontmot-cléDialoguePolice facultative : Dialog, Monospaced, Serif, SansSerif.
stylemot-cléStandardStyle facultatif : Standard, Bold, Italic, BoldItalic. Nécessite font.
sizeentier10Taille de police facultative, 10 à 30. Nécessite font et style.
R, G, B, aentiervaleur par défaut de la plateformeOptionnel COLOURED couleur et alpha, 0 à 255 chacun.

Comment ça marche

DRAWTEXT s'exécute dans un indicateur ProBuilder. Il affiche une chaîne de caractères sur le graphique, ancrée à (x1, y1), où x1 est un index de bar et y1 est un prix. Elle sert à annoter des niveaux, des valeurs ou des conditions. Une variable peut être affichée dans le texte en encadrant son nom par #, par exemple "High: #highPrice#" affiche la valeur de highPrice.

Les arguments optionnels de police, de style et de taille suivent les coordonnées, et chacun exige ceux qui le précèdent. Le COLOURED clause définit la couleur et la transparence du texte. Pour une seule légende sur la bar en cours, définissez DEFPARAM DrawOnLastBarOnly = true.

Exemples

Exemple 1, Étiqueter le plus haut actuel (Indicateur)

probuilder
// Print "High Price" at the high of the current bar in red
highPrice = high
DRAWTEXT("High Price", BarIndex, highPrice) COLOURED(255, 0, 0, 255)
RETURN

L'étiquette se place au plus haut de chaque bar, colorée en rouge opaque.

Exemple 2, Intégrer une valeur dans le texte (Indicateur)

probuilder
// Show the numeric high inside the label, once on the last bar
DEFPARAM DrawOnLastBarOnly = true
highPrice = high
DRAWTEXT("High: #highPrice#", BarIndex, highPrice, SansSerif, Bold, 12) COLOURED(0, 0, 0)
RETURN

Le #highPrice# espace réservé est remplacé par la valeur réelle, affichée en SansSerif gras de 12 points.

Exemple 3, Légender une ligne dessinée (Indicateur)

probuilder
// Draw a level and label it
DEFPARAM DrawOnLastBarOnly = true
lvl = Highest[20](high)
DRAWHLINE(lvl) COLOURED(0, 150, 0)
DRAWTEXT("20-bar high", BarIndex, lvl) COLOURED(0, 150, 0)
RETURN

DRAWTEXT nomme le niveau tracé par DRAWHLINE.

Erreurs et pièges courants

  • Indicateur uniquement. DRAWTEXT n'a aucun effet dans ProScreener, ProOrder ou ProBacktest. Réservez-le à un indicateur ProBuilder.
  • Les arguments optionnels sont ordonnés. Pour définir size vous devez aussi passer font et style avant lui. En omettre un décale tous les autres.
  • Les variables génériques utilisent #. Pour afficher une valeur, encadrez le nom de la variable par #. Écrire le nom tel quel l'affiche comme texte littéral.
  • X est un indice de bar. Passer un prix à x1 décale le texte horizontalement. Utilisez BarIndex.
  • DRAWLINE, trace une ligne qui DRAWTEXT peut annoter.
  • DRAWPOINT, un marqueur qu'une étiquette peut accompagner.
  • DRAWARROWUP, une flèche qu'une étiquette peut accompagner.
  • COLOURED, définit la couleur et la transparence du texte.
  • DrawOnLastBarOnly, limite le tracé au dernier bar.
  • BarIndex, fournit la coordonnée x.
  • STRINGFORMAT, construit des chaînes de texte pour l'affichage.
  • NUMBERFORMAT, formate un nombre avant de l'intégrer dans un texte.