IncGUI_BitPic - libreria per MetaTrader 5

Il file plug-in IncGUI_BitPic.mqh contiene la classe di controllo grafico CBitPic per il disegno dei pixel (Figura 1).

Figura 1. Un esempio di disegno con la classe CBitPic.

È possibile disegnare punti di diverse dimensioni - DrawDot(), linee per coordinate - DrawLine(), linee per angolo - DrawLineByAngle(), frecce - DrawArrow(), varie forme: rettangoli - DrawRectangle(), triangoli - DrawTriangle(), cerchi, ellissi, anelli, settori - DrawCircle(). Un'ellisse può essere ruotata di un determinato angolo (così come un anello di ellisse, un settore di ellisse). Le forme possono essere disegnate con un riempimento o solo con un contorno. È possibile stampare il testo - TypeText() (diverse opzioni di carattere e dimensione). L'immagine creata può essere salvata in un file bmp - SavePicture(), ed è possibile caricare un'immagine bmp già pronta da un file - LoadPicture() (il file deve essere non compresso, a 24 o 32 bit).

Per utilizzare il controllo è necessario collegare il file IncGUI_BitPic.mqh:

#include <IncGUI_BitPic.mqh>

Quindi, dichiarare una classe, ad esempio, chiamata p:

CBitPic p;

La classe viene creata utilizzando i principi illustrati negli articoli:

• Controlli grafici personalizzati. Parte 1. Creazione di un semplice controllo
• Controlli grafici personalizzati. Parte 2. Libreria di controlli
• Controlli grafici personalizzati. Parte 3. Moduli

Di conseguenza, il principio della sua applicazione è simile ai principi di utilizzo dei controlli descritti negli articoli: innanzitutto, viene richiamato il metodo di inizializzazione Init(), il metodo Show() viene utilizzato per attivare la visibilità, il metodo Hide() viene utilizzato per nasconderlo e cancellarlo al termine del lavoro, ecc.

A differenza della classe cIntBMP, il disegno viene eseguito in modo leggermente diverso: in cIntBMP il colore del disegno veniva specificato nelle funzioni di disegno della figura, qui il disegno viene eseguito nel seguente ordine: viene specificato il colore di sfondo - SetBGColor(), viene eseguita la cancellazione - Clear(), prima del disegno viene impostato lo spessore del disegno - SetDrawWidth(), il colore del disegno SetDrawColor(), il riempimento - SetFillColor(), se è necessario il riempimento - SetFilled(), oppure il disegno viene eseguito solo per contorno, dopodiché vengono richiamate le funzioni di disegno. Naturalmente, è possibile modificare il colore del disegno, del riempimento, ecc. a seconda delle necessità. Dopo il disegno è necessario chiamare il metodo Redraw().

La tabella seguente mostra tutti i metodi della classe:

Nell'esempio eBitPicTest.mq5 di utilizzo della classe CBitPic, l'Expert Advisor disegna un'immagine sul grafico come nella figura 1 e la salva in un file denominato CBitPic.bmp (che dovrebbe apparire nella cartella MQL5/Files della cartella dati del terminale). Facendo clic sull'immagine, le coordinate del punto, il suo colore verranno visualizzati nel commento del grafico e un "fiocco di neve" verrà disegnato nello stesso punto (come nell'angolo superiore destro della Fig. 1).