In this article I will discuss about making the Strength of Price Movement Multi Timeframe indicator for MT5, where the indicator will calculate price movement comparison in percent on each timeframe, in this case 21 timeframes from M1 to MN1.
The multi-timeframe (MTF) indicator is an incredibly useful tool for forex traders. It allows traders to view market conditions from various timeframes on a single chart, enabling them to make more informed decisions based on a broader perspective of market trends.
The MTF indicator has a unique ability to display the condition, position, and movement of indicators and/or prices across 21 timeframes within a single user-selected timeframe. In other words, users can choose one timeframe to display information from all 21 timeframes available in MT5.
For instance, on an H1 chart, this indicator can display data from the W1, D1, H4, and 18 other timeframes. This allows traders to gain a comprehensive view of market conditions.
Utilizing a multi-timeframe (MTF) indicator in technical analysis allows traders to gain a broader and deeper perspective on market movements across different timeframes. Here are some strategies based on the key functions of the MTF indicator:
By applying these strategies, traders can leverage the advantages of the multi-timeframe indicator to optimize trading decisions and manage risk more effectively. Always remember to backtest and evaluate your strategies periodically to ensure their effectiveness under various market conditions.
- 1. Introduction:
- The SPM_MTF indicator, or Strength of Price Movement Multi Timeframe indicator for MT5 which is calculated price movement comparison in percent on each timeframe.
- 2. Key Functions of the SPM_MTF Indicator:
- Displays Multiple Timeframes:
- The indicator displays various timeframes on a single chart, helping traders to analyze market trends and movements effectively.
- Helps Identify Market Trends:
- By viewing the indicator across multiple timeframes, traders can identify both larger and smaller market trends more easily.
- Supports Trading Decisions:
- The indicator assists traders in making informed decisions to enter or exit trades based on market conditions observed across different timeframes.
- 3. The Multi-Timeframe Indicator Program:
//+------------------------------------------------------------------+
//| SPM_MTF.mq5 |
//| Copyright 2025, Roberto Jacobs (3rjfx) ~ Date: 2025-01-08 |
//| https://www.mql5.com/en/users/3rjfx |
//+------------------------------------------------------------------+
#property copyright "Copyright 2025, Roberto Jacobs (3rjfx) ~ Date: 2025-01-08"
#property link "https://www.mql5.com/en/users/3rjfx"
#property version "1.00"
#property description "SPM_MTF is the Strength of Price Movement Multi Timeframe indicator for MT5"
#property description "which is calculated price movement comparison in percent on each timeframe."
//---
#property indicator_chart_window
#property indicator_plots 1
#property indicator_buffers 1
//---
//--
enum YN
{
No,
Yes
};
//--
enum fonts
{
Verdana,
Bodoni_MT_Black
};
//--
//---
input group "==== Indicator Color and Font ===="
input color ArrowUp = clrMediumSeaGreen; // Arrow Up Color
input color ArrowDn = clrDeepPink; // Arrow Down Color
input color NTArrow = clrGold; // Arrow No Signal
input fonts f_model = Bodoni_MT_Black; // Select Font Model
input group "==== Input parameters for alerts ===="
input YN alerts = Yes; // Display Alerts Pop-up on Chart (Yes) or (No)
input YN UseEmailAlert = No; // Email Alert (Yes) or (No)
input YN UseSendnotify = No; // Send Notification (Yes) or (No)
//---
//---------//
- Code Overview:
- The code is written in MQL5, a language used for creating custom indicators, scripts, and automated trading strategies on the MetaTrader 5 platform.
- 4. Main Functions in the Program:
- Function Display Timeframes:
- This function is responsible for displaying multiple timeframes on a single chart, allowing traders to see various periods simultaneously.
- Function Identify Trends:
- This function helps to identify market trends by analyzing price movements across different timeframes.
- Function Support Trading Decisions:
- This function supports trading decisions by providing signals based on multi-timeframe analysis.
- 5. Code Explanation:
- Input Parameters:
- The code defines several input parameters for customizing the indicator's appearance and alert settings, including arrow colors, font selection, and alert options.
- Enums:
- Two enumerations are defined: YN (Yes/No) for boolean-like input parameters and fonts for font selection.
- Input Groups:
- Input parameters are organized into groups for better clarity. The first group focuses on the indicator's color and font settings, while the second group handles alert settings.
- Alerts:
- Options for displaying alerts on the chart, sending email alerts, and sending notifications are included, providing flexibility in how traders receive alerts.
- Example Implementation:
- Indicator Properties:
- The indicator's properties are defined at the beginning of the code, including copyright information, version, description, and the number of plots and buffers.
- Indicator Buffers:
- One buffer is declared for storing indicator values.
Class for MTF indicator:
//+------------------------------------------------------------------+
//| class for MTF indicator |
//+------------------------------------------------------------------+
class MTF_Indi
{
//---
public:
//--
int fbar;
int star,
tstar,
bstar;
int TNamex,
TNamexn,
TNamey1,
TNamey2,
TNamey3,
TNamey1n,
TNamey2n,
TNamey3n;
int tfxar;
int up,dw;
int tfhalf;
int maxbar;
int ttlbars;
int scaleX,
scaleA,
scaleY,
horizL1,
horizL2,
horizL3,
horizL4,
horizL5,
horizL6,
vertiL1,
vertiL2,
vertiL3,
vertiL4,
vertiL5,
vertiL6,
offsetX,
offsetY,
fontSize,
windchar,
windsize;
int corx,
cory,
txttf;
int curmin,
prvmin;
int corpos;
int pospos,
postop,
posbot;
int curAlert;
int prvAlert;
//--
long CI;
string posisi,
sigpos,
indname,
msgText,
ObjName;
string cstar,
artop,
arbot;
string hName1,
hName2,
hName3;
string font_mode;
bool display;
double OPEN[],
HIGH[],
LOW[],
CLOSE[];
datetime TIME[];
datetime cbartime;
//--
int year, // Year
mon, // Month
day, // Day
hour, // Hour
min, // Minutes
sec, // Seconds
dow, // Day of week (0-Sunday, 1-Monday, ... ,6-Saturday)
doy; // Day number of the year (January 1st is assigned the number value of zero)
//---- buffers
double PowerMove[];
string TFSc[];
color Arwcolor[];
color TColor;
ENUM_TIMEFRAMES TFId[];
ENUM_BASE_CORNER bcor;
ENUM_ANCHOR_POINT ancp;
//---
//---
//- Constructor
MTF_Indi(void):
year(0),
mon(1),
day(2),
hour(3),
min(4),
sec(5),
dow(6),
doy(7),
fbar(15),
star(181),
maxbar(3),
pospos(0),
postop(0),
posbot(1),
tstar(217),
bstar(218),
tfhalf(11),
scaleX(35),
scaleA(36),
scaleY(50),
offsetY(18),
offsetX(120),
fontSize(7),
cbartime(0),
posisi(""),
sigpos(""),
msgText(""),
curAlert(0),
prvAlert(0),
ttlbars(125),
windsize(12),
windchar(108),
CI(ChartID()),
display(false),
ObjName("SPM_"),
font_mode(FontsModel(f_model)),
cstar(CharToString((uchar)star)),
artop(CharToString((uchar)tstar)),
arbot(CharToString((uchar)bstar)),
indname(MQLInfoString(MQL_PROGRAM_NAME))
{
}
//---
//- Destructor
~MTF_Indi(void)
{
}
//---
Code Explanation of the MTF_Indi Class:
- Class Definition:
- The MTF_Indi class encapsulates the functionality of the multi-timeframe indicator.
- Public Members:
- Various public member variables are declared to store different attributes and settings related to the indicator, such as timeframe coordinates, alert settings, font size, and display parameters.
- Constructor:
- The constructor initializes the member variables with default values, ensuring that the indicator is set up correctly when instantiated.
- Destructor:
- The destructor is defined but currently does not perform any specific actions.
- Member Variables:
- The class defines numerous member variables for storing values such as chart coordinates, alert settings, font details, and indicator data buffers.
- These variables are used throughout the class methods to perform various indicator functions.
Main Functions in the Program:
- Function SPM_MTF_Config():
- This function is responsible for configuring the multi-timeframe settings and preparing the indicator for use.
- Code Explanation of the SPM_MTF_Config Function:
- Timeframe Enumeration:
- The function defines an array TFIx of different timeframes that the indicator will use.
-
ENUM_TIMEFRAMES TFIx[]= {PERIOD_M1,PERIOD_M2,PERIOD_M3,PERIOD_M4,PERIOD_M5,PERIOD_M6,PERIOD_M10,PERIOD_M12,PERIOD_M15,
PERIOD_M20,PERIOD_M30,PERIOD_H1,PERIOD_H2,PERIOD_H3,PERIOD_H4,PERIOD_H6,PERIOD_H8,PERIOD_H12,
PERIOD_D1,PERIOD_W1,PERIOD_MN1};
- Array Resizing:
- The arrays TFId and Arwcolor are resized to match the number of timeframes defined.
-
tfxar=ArraySize(TFIx);
ArrayResize(TFId,tfxar,tfxar);
ArrayResize(Arwcolor,tfxar,tfxar);
ArrayCopy(TFId,TFIx,0,0,WHOLE_ARRAY);
- Timeframe Labels:
- An array TFxc of timeframe labels (e.g., "M1", "M2", "M3") is defined, and TFSc is resized and populated accordingly.
-
//--
string TFxc[]= {"M1","M2","M3","M4","M5","M6","M10","M12","M15","M20","M30","H1",
"H2","H3","H4","H6","H8","H12","D1","W1","MN1"}; // 21 Timeframes
//--
ArrayResize(TFSc,tfxar,tfxar);
ArrayCopy(TFSc,TFxc,0,0,WHOLE_ARRAY);
//--
- Supporting Functions:
- The function calls several other functions to complete the configuration:
- DeletedSPMObject(): Deletes any previous objects related to the indicator.
- CalculationStrength(25): Initializes or recalculates the strength of price movement with a given parameter.
- PositionCore(): Sets up the core position settings for the indicator.
- Display Conditional:
- If the display flag is true, the DrawSPMObject() function is called to draw the indicator objects on the chart.
-
if(display)
DrawSPMObject();
Function PositionCore():
This function is responsible for setting up the core position settings for the indicator, including the display and layout of various elements on the chart.
//---
void PositionCore(void)
{
corpos=pospos;
if(corpos>-1)
{
if(corpos==postop)
{
bcor=CORNER_LEFT_UPPER;
ancp=ANCHOR_CENTER;
corx=155;
cory=13;
txttf=45;
horizL1=8;
horizL2=-5;
horizL3=8;
horizL4=-5;
horizL5=11;
horizL6=10;
vertiL1=39;
vertiL2=18;
vertiL3=69;
vertiL4=48;
vertiL5=52;
vertiL6=67;
TNamex=554;
TNamexn=562;
TNamey1=30;
TNamey2=46;
TNamey3=62;
TNamey1n=38;
TNamey2n=54;
TNamey3n=70;
hName1="S";
hName2="P";
hName3="M";
//--
DisplayButtonClick("cstar");
DisplayButtonClick("arbot");
//--
}
if(corpos==posbot)
{
bcor=CORNER_LEFT_LOWER;
ancp=ANCHOR_CENTER;
corx=155;
cory=74;
txttf=45;
horizL1=8;
horizL2=-5;
horizL3=8;
horizL4=-5;
horizL5=11;
horizL6=10;
vertiL1=34;
vertiL2=29;
vertiL3=65;
vertiL4=59;
vertiL5=49;
vertiL6=61;
TNamex=554;
TNamexn=562;
TNamey1=13;
TNamey2=46;
TNamey3=62;
TNamey1n=18;
TNamey2n=33;
TNamey3n=49;
hName1="M";
hName2="P";
hName3="S";
//--
DisplayButtonClick("cstar");
DisplayButtonClick("artop");
//--
}
display=true;
}
}
//---
- Code Explanation of the PositionCore Function:
- Position Setup:
- The function begins by assigning the corpos variable the value of pospos.
- Upper Position Settings:
- If corpos equals postop, several parameters are set to position elements in the upper left corner of the chart.
- Lower Position Settings:
- If corpos equals posbot, several parameters are set to position elements in the lower left corner of the chart.
- Display Activation:
- The display flag is set to true, indicating that the setup for displaying elements on the chart is complete.
Function DrawSPMObject(void):
This function is responsible for drawing the various elements of the indicator on the chart.
//---
void DrawSPMObject(void)
{
//-- CreateButtonTemplate(CI,ObjName+"Template",397,66,STYLE_SOLID,9,BORDER_RAISED,clrMistyRose,clrLavenderBlush,clrWhite,bcor,corx,cory,true);
for(int x=0; x<tfhalf; x++)
{
CreateArrowLabel(CI,ObjName+"_win_arrow_"+string(x),CharToString((uchar)windchar),"Wingdings",windsize,Arwcolor[x],bcor,
txttf+horizL1+(x*scaleX)+offsetX+x,vertiL1,true,"Arrow_"+TFSc[x]);
CreateButtonClick(CI,TFSc[x],27,15,font_mode,fontSize,BORDER_FLAT,TFSc[x],clrBurlyWood,clrSilver,clrBlue,
bcor,txttf+horizL2+(x*scaleA)+offsetX,vertiL2,true,
"Change Timeframe to : "+TFSc[x]);
}
for(int x=tfhalf, x2=0; x<tfxar; x++, x2++)
{ CreateArrowLabel(CI,ObjName+"_win_arrow_"+string(x),CharToString((uchar)windchar),"Wingdings",windsize,Arwcolor[x],bcor,
txttf+horizL3+(x2*scaleX)+offsetX+x2,vertiL3,true,"Arrow_"+TFSc[x]);
CreateButtonClick(CI,TFSc[x],27,15,font_mode,fontSize,BORDER_FLAT,TFSc[x],clrBurlyWood,clrSilver,clrBlue,
bcor,txttf+horizL4+(x2*scaleA)+offsetX,vertiL4,true,
"Change Timeframe to : "+TFSc[x]);
//--
if(x==20)
{
int arrowChar=TColor==ArrowUp ? 200 : TColor==ArrowDn ? 202 : windchar;
CreateArrowLabel(CI,ObjName+"_tfx_arrow_"+string(x+1),"Move",font_mode,fontSize,clrBlue,bcor,
519+horizL5,vertiL5,true,"Move");
CreateArrowLabel(CI,ObjName+"_win_arrow_"+string(x+1),CharToString((uchar)arrowChar),"Wingdings",15,TColor,bcor,
522+horizL6,vertiL6,true,"Arrow Price Movement");
}
}
DisplayButtonClick("X");
CreateButtonTemplate(CI,ObjName+"TemplateName1",17,15,STYLE_SOLID,1,BORDER_FLAT,clrMistyRose,clrLavenderBlush,clrWhite,bcor,TNamex,TNamey1,true); CreateButtonTemplate(CI,ObjName+"TemplateName2",17,15,STYLE_SOLID,1,BORDER_FLAT,clrMistyRose,clrLavenderBlush,clrWhite,bcor,TNamex,TNamey2,true); CreateButtonTemplate(CI,ObjName+"TemplateName3",17,15,STYLE_SOLID,1,BORDER_FLAT,clrMistyRose,clrLavenderBlush,clrWhite,bcor,TNamex,TNamey3,true);
CreateArrowLabel(CI,ObjName+"_name1",hName1,font_mode,fontSize+1,clrBlue,bcor,TNamexn,TNamey1n,true,hName1);
CreateArrowLabel(CI,ObjName+"_name2",hName2,font_mode,fontSize+1,clrBlue,bcor,TNamexn,TNamey2n,true,hName2);
CreateArrowLabel(CI,ObjName+"_name3",hName3,font_mode,fontSize+1,clrBlue,bcor,TNamexn,TNamey3n,true,hName3);
//--
if(corpos==postop)
{
DisplayButtonClick("cstar");
DisplayButtonClick("arbot");
}
if(corpos==posbot)
{
DisplayButtonClick("cstar");
DisplayButtonClick("artop");
}
//--
return;
//---
} //-end DrawSPMObject()
//---
- Code Explanation of the DrawSPMObject Function:
- Template Creation:
- A button template is created as a base for other objects.
-
CreateButtonTemplate(CI,ObjName+"Template",397,66,STYLE_SOLID,9,BORDER_RAISED,clrMistyRose,clrLavenderBlush,clrWhite,bcor,corx,cory,true);
- Upper Timeframe Labels and Buttons:
- The function iterates over the first half of the timeframes to create arrow labels and buttons.
-
for(int x=0; x<tfhalf; x++)
{
CreateArrowLabel(CI,ObjName+"_win_arrow_"+string(x),CharToString((uchar)windchar),"Wingdings",windsize,Arwcolor[x],bcor,
txttf+horizL1+(x*scaleX)+offsetX+x,vertiL1,true,"Arrow_"+TFSc[x]);
CreateButtonClick(CI,TFSc[x],27,15,font_mode,fontSize,BORDER_FLAT,TFSc[x],clrBurlyWood,clrSilver,clrBlue,
bcor,txttf+horizL2+(x*scaleA)+offsetX,vertiL2,true,
"Change Timeframe to : "+TFSc[x]);
}
- Lower Timeframe Labels and Buttons:
- The function iterates over the remaining timeframes to create arrow labels and buttons.
-
for(int x=tfhalf, x2=0; x<tfxar; x++, x2++)
{
CreateArrowLabel(CI,ObjName+"_win_arrow_"+string(x),CharToString((uchar)windchar),"Wingdings",windsize,Arwcolor[x],bcor,
txttf+horizL3+(x2*scaleX)+offsetX+x2,vertiL3,true,"Arrow_"+TFSc[x]);
CreateButtonClick(CI,TFSc[x],27,15,font_mode,fontSize,BORDER_FLAT,TFSc[x],clrBurlyWood,clrSilver,clrBlue,
bcor,txttf+horizL4+(x2*scaleA)+offsetX,vertiL4,true,
"Change Timeframe to : "+TFSc[x]);
// Special case for the last timeframe
if(x==20)
{
int arrowChar=TColor==ArrowUp ? 200 : TColor==ArrowDn ? 202 : windchar;
CreateArrowLabel(CI,ObjName+"_tfx_arrow_"+string(x+1),"Move",font_mode,fontSize,clrBlue,bcor,
519+horizL5,vertiL5,true,"Move");
CreateArrowLabel(CI,ObjName+"_win_arrow_"+string(x+1),CharToString((uchar)arrowChar),"Wingdings",15,TColor,bcor,
522+horizL6,vertiL6,true,"Arrow Price Movement");
}
- Button Templates and Labels:
- Additional button templates and labels are created for the indicator's display.
-
DisplayButtonClick("X");
CreateButtonTemplate(CI,ObjName+"TemplateName1",17,15,STYLE_SOLID,1,BORDER_FLAT,clrMistyRose,clrLavenderBlush,clrWhite,bcor,TNamex,TNamey1,true); CreateButtonTemplate(CI,ObjName+"TemplateName2",17,15,STYLE_SOLID,1,BORDER_FLAT,clrMistyRose,clrLavenderBlush,clrWhite,bcor,TNamex,TNamey2,true);
CreateButtonTemplate(CI,ObjName+"TemplateName3",17,15,STYLE_SOLID,1,BORDER_FLAT,clrMistyRose,clrLavenderBlush,clrWhite,bcor,TNamex,TNamey3,true);
CreateArrowLabel(CI,ObjName+"_name1",hName1,font_mode,fontSize+1,clrBlue,bcor,TNamexn,TNamey1n,true,hName1);
CreateArrowLabel(CI,ObjName+"_name2",hName2,font_mode,fontSize+1,clrBlue,bcor,TNamexn,TNamey2n,true,hName2);
CreateArrowLabel(CI,ObjName+"_name3",hName3,font_mode,fontSize+1,clrBlue,bcor,TNamexn,TNamey3n,true,hName3);
//--
- Display Conditional:
- Depending on the corpos value, specific buttons are displayed.
-
if(corpos==postop)
{
DisplayButtonClick("cstar");
DisplayButtonClick("arbot");
}
if(corpos==posbot)
{
DisplayButtonClick("cstar");
DisplayButtonClick("artop");
}
Function PanelPosChange(int inpos)::
This function is responsible for changing the position of the panel based on the input position value.
void PanelPosChange(int inpos)
{
corpos=inpos;
//--
if(inpos>=0)
{
if(inpos==postop)
{
bcor=CORNER_LEFT_UPPER;
ancp=ANCHOR_CENTER;
corx=155;
cory=13;
txttf=45;
horizL1=8;
horizL2=-5;
horizL3=8;
horizL4=-5;
horizL5=11;
horizL6=10;
vertiL1=39;
vertiL2=18;
vertiL3=69;
vertiL4=48;
vertiL5=52;
vertiL6=67;
TNamex=554;
TNamexn=562;
TNamey1=30;
TNamey2=46;
TNamey3=62;
TNamey1n=38;
TNamey2n=54;
TNamey3n=70;
hName1="S";
hName2="P";
hName3="M";
//--
DisplayButtonClick("cstar");
DisplayButtonClick("arbot");
//--
}
if(inpos==posbot)
{
bcor=CORNER_LEFT_LOWER;
ancp=ANCHOR_CENTER;
corx=155;
cory=74;
txttf=45;
horizL1=8;
horizL2=-5;
horizL3=8;
horizL4=-5;
horizL5=11;
horizL6=10;
vertiL1=34;
vertiL2=29;
vertiL3=65;
vertiL4=59;
vertiL5=49;
vertiL6=61;
TNamex=554;
TNamexn=562;
TNamey1=25;
TNamey2=41;
TNamey3=57;
TNamey1n=18;
TNamey2n=33;
TNamey3n=49;
hName1="M";
hName2="P";
hName3="S";
//--
DisplayButtonClick("cstar");
DisplayButtonClick("artop");
//--
}
display=true;
}
//---
}
//---
- Code Explanation of the PanelPosChange Function:
- Position Setup:
- The function begins by assigning the corpos variable the value of inpos.
-
- Upper Position Settings:
- If inpos equals postop, several parameters are set to position elements in the upper left corner of the chart.
-
if(inpos==postop)
{
bcor=CORNER_LEFT_UPPER;
ancp=ANCHOR_CENTER;
corx=155;
cory=13;
txttf=45;
horizL1=8;
horizL2=-5;
horizL3=8;
horizL4=-5;
horizL5=11;
horizL6=10;
vertiL1=39;
vertiL2=18;
vertiL3=69;
vertiL4=48;
vertiL5=52;
vertiL6=67;
TNamex=554;
TNamexn=562;
TNamey1=30;
TNamey2=46;
TNamey3=62;
TNamey1n=38;
TNamey2n=54;
TNamey3n=70;
hName1="S";
hName2="P";
hName3="M";
//--
DisplayButtonClick("cstar");
DisplayButtonClick("arbot");
//--
}
- Lower Position Settings:
- If inpos equals posbot, several parameters are set to position elements in the lower left corner of the chart.
-
if(inpos==posbot)
{
bcor=CORNER_LEFT_LOWER;
ancp=ANCHOR_CENTER;
corx=155;
cory=74;
txttf=45;
horizL1=8;
horizL2=-5;
horizL3=8;
horizL4=-5;
horizL5=11;
horizL6=10;
vertiL1=34;
vertiL2=29;
vertiL3=65;
vertiL4=59;
vertiL5=49;
vertiL6=61;
TNamex=554;
TNamexn=562;
TNamey1=25;
TNamey2=41;
TNamey3=57;
TNamey1n=18;
TNamey2n=33;
TNamey3n=49;
hName1="M";
hName2="P";
hName3="S";
//--
DisplayButtonClick("cstar");
DisplayButtonClick("artop");
//--
}
- Display Activation:
- The display flag is set to true, indicating that the setup for displaying elements on the chart is complete.
-
Function UpdatePrice(ENUM_TIMEFRAMES xtf):
This function is responsible for updating the price data arrays for a given timeframe.
//---
void UpdatePrice(ENUM_TIMEFRAMES xtf)
{
//--
ArrayFree(OPEN);
ArrayFree(HIGH);
ArrayFree(LOW);
ArrayFree(CLOSE);
ArrayFree(TIME);
//--
ArrayResize(OPEN,maxbar,maxbar);
ArrayResize(HIGH,maxbar,maxbar);
ArrayResize(LOW,maxbar,maxbar);
ArrayResize(CLOSE,maxbar,maxbar);
ArrayResize(TIME,maxbar,maxbar);
//--
ArraySetAsSeries(OPEN,true);
ArraySetAsSeries(HIGH,true);
ArraySetAsSeries(LOW,true);
ArraySetAsSeries(CLOSE,true);
ArraySetAsSeries(TIME,true);
//--
ArrayInitialize(OPEN,0.0);
ArrayInitialize(HIGH,0.0);
ArrayInitialize(LOW,0.0);
ArrayInitialize(CLOSE,0.0);
ArrayInitialize(TIME,0);
//--
int barx=PeriodSeconds(xtf)/60*maxbar;
RefreshPrice(PERIOD_M1,maxbar);
RefreshPrice(xtf,barx);
//--
int co=CopyOpen(Symbol(),xtf,0,maxbar,OPEN);
int ch=CopyHigh(Symbol(),xtf,0,maxbar,HIGH);
int cl=CopyLow(Symbol(),xtf,0,maxbar,LOW);
int cc=CopyClose(Symbol(),xtf,0,maxbar,CLOSE);
int ct=CopyTime(Symbol(),xtf,0,maxbar,TIME);
//--
return;
//---
} //-end UpdatePrice()
//---
- Code Explanation of the UpdatePrice Function:
- Array Initialization:
- The function begins by freeing any existing arrays for open, high, low, close prices, and time.
-
//--
ArrayFree(OPEN);
ArrayFree(HIGH);
ArrayFree(LOW);
ArrayFree(CLOSE);
ArrayFree(TIME);
//--
- Array Resizing:
- The arrays are then resized to hold the maximum number of bars (maxbar).
-
//--
ArrayResize(OPEN,maxbar,maxbar);
ArrayResize(HIGH,maxbar,maxbar);
ArrayResize(LOW,maxbar,maxbar);
ArrayResize(CLOSE,maxbar,maxbar);
ArrayResize(TIME,maxbar,maxbar);
//--
- Array Series Setting:
- The arrays are set to behave as series, where index 0 is the most recent data.
-
//--
ArraySetAsSeries(OPEN,true);
ArraySetAsSeries(HIGH,true);
ArraySetAsSeries(LOW,true);
ArraySetAsSeries(CLOSE,true);
ArraySetAsSeries(TIME,true);
//--
- Array Initialization:
- The arrays are initialized to default values to clear any old data.
-
//--
ArrayInitialize(OPEN,0.0);
ArrayInitialize(HIGH,0.0);
ArrayInitialize(LOW,0.0);
ArrayInitialize(CLOSE,0.0);
ArrayInitialize(TIME,0);
//--
- Price Data Refresh:
- The function calculates the number of bars based on the specified timeframe (xtf) and calls the RefreshPrice function for both the M1 timeframe and the specified timeframe.
-
//--
int barx=PeriodSeconds(xtf)/60*maxbar;
RefreshPrice(PERIOD_M1,maxbar);
RefreshPrice(xtf,barx);
//--
- Copying Price Data:
- The function copies the open, high, low, close prices, and time data into the respective arrays for the specified timeframe.
-
//--
int co=CopyOpen(Symbol(),xtf,0,maxbar,OPEN);
int ch=CopyHigh(Symbol(),xtf,0,maxbar,HIGH);
int cl=CopyLow(Symbol(),xtf,0,maxbar,LOW);
int cc=CopyClose(Symbol(),xtf,0,maxbar,CLOSE);
int ct=CopyTime(Symbol(),xtf,0,maxbar,TIME);
//--
Function RefreshPrice(ENUM_TIMEFRAMES xtf, int bars):
This function is responsible for refreshing the price data for a given timeframe and a specified number of bars.
- Code Explanation of the RefreshPrice Function:
- Array Declaration:
- The function begins by declaring an array parray of type MqlRates to store the price data.
-
- Array Series Setting:
- The array is set to behave as a series, where index 0 is the most recent data.
-
ArraySetAsSeries(parray,true);
- Copying Price Data:
- The CopyRates function is called to copy the price data for the specified symbol and timeframe into the parray array. The number of bars tocopy is specified by the bars parameter.
-
int copied=CopyRates(Symbol(),xtf,0,bars,parray);
Function PriceStrengthScan(const ENUM_TIMEFRAMES stf, int shift):
This function calculates the direction of the price bar in percentage terms.
- Code Explanation of the PriceStrengthScan Function:
- Variable Initialization:
- The function starts by initializing several variables to store return values, rise/fall indicators, and intermediate results.
-
//--
int ret=0;
int rise=1,
down=-1;
//--
int br=shift+2;
double res=0.0;
double move=0.0;
- Update Price Data:
- The UpdatePrice function is called to refresh the price data for the specified timeframe.
-
- Array Initialization:
- An array CL is resized and set as a series to store close prices.
-
//--
double CL[];
ArrayResize(CL,br,br);
ArraySetAsSeries(CL,true);
//--
- Populating Close Prices:
- The close prices are copied into the CL array.
-
//--
for(int x=br-1; x>=shift; x--)
CL[x]=CLOSE[x];
//--
- Calculating Price Strength:
- The function calculates the percentage change between the current and previous close prices.
-
//--
double close_now = CL[shift];
double close_prev = CL[shift+1];
//--
if((close_now==0 || close_now==EMPTY_VALUE) || (close_prev==0 || close_prev==EMPTY_VALUE))
res=0.0;
else
res=NormalizeDouble((close_now / close_prev * 100) - 100,3);
res=NormalizeDouble(res*100,3); // because its value less than 1 then multiplied with 100.
//--
- Determining Price Direction:
- The function sets the return value based on whether the price has risen or fallen.
-
//--
if(res>move)
ret=rise;
if(res<move)
ret=down;
//--
- Returning the Result:
- The function returns the calculated direction of the price bar.
-
Function CalculationStrength(int barCnt):
This function scans the direction of movement of each timeframe and calculates the strength of price movement in percentage terms.
- Code Explanation of the CalculationStrength Function:
- Array Initialization:
- The function begins by resizing and setting the PowerMove array as a series to store the calculated strength values.
-
//--
ArrayResize(PowerMove,barCnt,barCnt);
ArraySetAsSeries(PowerMove,true);
//--
- Main Calculation Loop:
- The function loops through each bar in the specified count (barCnt) and initializes counters for up and down movements.
-
for(int i=barCnt-1; i>=0; i--)
{
up=0;
dw=0;
//--
- Inner Loop for Timeframes:
- Within the main loop, the function iterates over each timeframe defined in tfxar and initializes arrow colors and power move values.
-
for(int x=0; x<tfxar; x++)
{
Arwcolor[x]=NTArrow;
PowerMove[i]=0.0;
int PPM=PriceStrengthScan(TFId[x],0);
- Price Strength Scan:
- The PriceStrengthScan function is called to determine the price movement direction for each timeframe.
-
int PPM=PriceStrengthScan(TFId[x],0);
- Updating Counters and Arrow Colors:
- The function updates the up and down counters and sets the appropriate arrow colors based on the result of PriceStrengthScan.
-
if(PPM>0)
{
up++;
Arwcolor[x]=ArrowUp;
}
if(PPM<0)
{
dw++;
Arwcolor[x]=ArrowDn;
}
- Final Calculation and Alert Setting:
- After iterating through all timeframes, the function sets the PowerMove value and alert color based on the counters' comparison.
-
if(x==tfxar-1)
{
if(up>dw+1)
{
PowerMove[i]=1.0;
TColor=ArrowUp;
curAlert=1;
}
if(dw>up+1)
{
PowerMove[i]=-1.0;
TColor=ArrowDn;
curAlert=-1;
}
Function ThisTime(const int reqmode):
This function retrieves the current time information based on the requested mode.
- Code Explanation of the ThisTime Function:
- Variable Initialization:
- The function starts by declaring a MqlDateTime structure and an integer to store the time value.
-
//--
MqlDateTime tm;
TimeCurrent(tm);
int valtm=0;
//--
- Switch Statement for Time Retrieval:
- The function uses a switch statement to assign the appropriate time component based on the reqmode parameter.
-
//--
switch(reqmode)
{
case 0:
valtm=tm.year;
break; // Return Year
case 1:
valtm=tm.mon;
break; // Return Month
case 2:
valtm=tm.day;
break; // Return Day
case 3:
valtm=tm.hour;
break; // Return Hour
case 4:
valtm=tm.min;
break; // Return Minutes
case 5:
valtm=tm.sec;
break; // Return Seconds
case 6:
valtm=tm.day_of_week;
break; // Return Day of week (0-Sunday, 1-Monday, ... ,6-Saturday)
case 7:
valtm=tm.day_of_year;
break; // Return Day number of the year (January 1st is assigned the number value of zero)
}
//--
- Return the Time Value:
- The function returns the time value based on the selected mode.
-
Function Do_Alerts(string msg):
This function handles the generation of various types of alerts (print, alert, email, and notification) based on the provided message.
- Code Explanation of the Do_Alerts Function:
- Print Alert:
- The function begins by printing the message along with the current symbol, timeframe, and time.
-
//--
Print("--- "+Symbol()+","+strTF(Period())+": "+msg+
"\n--- at: ",TimeToString(TimeCurrent(),TIME_DATE|TIME_MINUTES));
//--
- Chart Alert:
- If alerts are enabled, it triggers an alert with the same message details.
-
//--
if(alerts==Yes)
{
Alert("--- "+Symbol()+","+strTF(Period())+": "+msg+
"--- at: ",TimeToString(TimeCurrent(),TIME_DATE|TIME_MINUTES));
}
//--
- Email Alert:
- If email alerts are enabled, it sends an email with the message details.
-
//--
if(UseEmailAlert==Yes)
SendMail(indname,"--- "+Symbol()+" "+strTF(Period())+": "+msg+
"\n--- at: "+TimeToString(TimeCurrent(),TIME_DATE|TIME_MINUTES));
//--
- Notification Alert:
- If notifications are enabled, it sends a notification with the message details.
-
//--
if(UseSendnotify==Yes)
SendNotification(Symbol()+"--- "+Symbol()+" "+strTF(Period())+": "+msg+
"\n--- at: "+TimeToString(iTime(Symbol(),0,0),TIME_DATE|TIME_MINUTES));
//--
Function FontsModel(int mode):
This function returns the font name based on the input mode.
- Code Explanation of the FontsModel Function:
- Variable Initialization:
- The function starts by declaring a string variable str_font to store the font name.
-
- Switch Statement for Font Selection:
- The function uses a switch statement to assign the appropriate font name based on the mode parameter.
-
switch(mode)
{
case 0:
str_font="Verdana";
break;
case 1:
str_font="Bodoni MT Black";
break;
}
//--
- Return the Font Name:
- The function returns the font name based on the selected mode.
-
Function ChangeChartSymbol(string tf_name, ENUM_TIMEFRAMES stf):
This function changes the chart's symbol and timeframe based on the input parameters.
- Code Explanation of the ChangeChartSymbol Function:
- Unpress Button:
- The function starts by unpressing the button associated with the given timeframe name (tf_name).
-
//--- unpress the button
ObjectSetInteger(CI,tf_name,OBJPROP_STATE,false);
ObjectSetInteger(CI,tf_name,OBJPROP_ZORDER,0);
- Delete Existing Objects:
- The function calls DeletedSPMObject() to delete any existing objects related to the indicator.
-
- Change Panel Position:
- The function updates the panel position by calling PanelPosChange(corpos).
-
- Set Chart Symbol and Timeframe:
- The chart's symbol and timeframe are updated using ChartSetSymbolPeriod.
-
ChartSetSymbolPeriod(CI,Symbol(),stf);
- Redraw Objects:
- If the display flag is true, the function calls DrawSPMObject() to redraw the indicator objects on the chart.
-
if(display)
DrawOBVObject();
- Redraw Chart:
- Finally, the function calls ChartRedraw(CI) to refresh the chart display.
-
Function DisplayPanelButton():
This function is responsible for displaying the panel buttons on the chart, allowing users to interact with the indicator.
- Code Explanation of the DisplayPanelButton Function:
- Deleting Existing Objects:
- The function starts by deleting any existing panel buttons (cstar,artop, and arbot) to ensure a clean slate.
-
//--
ObjectDelete(CI,cstar);
ObjectDelete(CI,artop);
ObjectDelete(CI,arbot);
//--
- Creating Panel Buttons:
- The function then creates three buttons:
- cstar Button:
- This button is created with the label "Open Panel Indicator" and is positioned at the top-right corner of the chart.
-
CreateButtonClick(CI,cstar,20,20,"Wingdings",13,BORDER_FLAT,cstar,clrWhite,clrWhite,TColor,CORNER_RIGHT_UPPER,25,40,true,"Open Panel Indicator");
- artop Button:
- This button is created with the label "Change Panel to Top" and is positioned at the top-right corner of the chart.
-
CreateButtonClick(CI,artop,18,18,"Wingdings",11,BORDER_FLAT,artop,clrWhite,clrWhite,clrGreen,CORNER_RIGHT_UPPER,24,20,true,"Change Panel to Top");
- arbot Button:
- This button is created with the label "Change Panel to Bottom" and is positioned at the top-right corner of the chart.
-
CreateButtonClick(CI,arbot,18,18,"Wingdings",11,BORDER_FLAT,arbot,clrWhite,clrWhite,clrGreen,CORNER_RIGHT_UPPER,24,62,true,"Change Panel to Bottom");
- Redrawing the Chart:
- The function calls ChartRedraw(CI) to refresh the chart and display the newly created buttons.
-
Function DisplayButtonClick(string actreq):
This function handles the creation and display of various buttons on the chart based on the action requested.
- Code Explanation of the DisplayButtonClick Function:
- Conditional Button Creation:
- The function uses a series of if statements to determine which button to create based on the actreq parameter:
- cstar Button:
- This button is created with the label "Open Panel Indicator" and is positioned at the top-right corner of the chart.
-
if(actreq=="cstar")
CreateButtonClick(CI,cstar,20,20,"Wingdings",13,BORDER_FLAT,cstar,clrWhite,clrWhite,TColor,CORNER_RIGHT_UPPER,25,40,true,"Open Panel Indicator");
- artop Button:
- This button is created with the label "Change Panel to Top" and is positioned at the top-right corner of the chart.
-
if(actreq=="artop")
CreateButtonClick(CI,artop,18,18,"Wingdings",11,BORDER_FLAT,artop,clrWhite,clrWhite,clrGreen,CORNER_RIGHT_UPPER,24,20,true,"Change Panel to Top");
- arbot Button:
- This button is created with the label "Change Panel to Bottom" and is positioned at the top-right corner of the chart.
-
if(actreq=="arbot")
CreateButtonClick(CI,arbot,18,18,"Wingdings",11,BORDER_FLAT,arbot,clrWhite,clrWhite,clrGreen,CORNER_RIGHT_UPPER,24,62,true,"Change Panel to Bottom");
- x Button:
- arbot Button:
- This button is created with the label "Close Panel" and is positioned based on the indicator's settings.
-
if(actreq=="X")
CreateButtonClick(CI,"X",17,15,"Arial Black",fontSize,BORDER_FLAT,"X",clrWhite,clrWhite,clrRed,bcor,txttf-7+(11*scaleA)+offsetX,cory,true,"Close Panel");
- Redrawing the Chart:
- The function calls ChartRedraw(CI) to refresh the chart and display the newly created buttons.
-
Function DeletedSPMObject():
This function is responsible for deleting all objects related to the SPM_MTF indicator from the chart.
- Code Explanation of the DeletedSPMObject Function:
- Loop Through Objects:
- The function starts by looping through all objects on the chart in reverse order.
-
string name;
for(int i=ObjectsTotal(CI,-1,-1)-1; i>=0; i--)
{
name=ObjectName(CI,i,-1,-1);
- Delete Matching Objects:
- If the object name contains the ObjName prefix, it is deleted.
-
if(StringFind(name,ObjName,0)>-1)
ObjectDelete(CI,name);
- Delete Timeframe Specific Objects:
- Within the outer loop, the function also checks for objects related to specific timeframes and deletes them if found.
-
for(int x=0; x<tfxar; x++)
{
if(StringFind(name,TFSc[x],0)>-1)
ObjectDelete(CI,name);
}
- Delete Common Objects:
- Finally, the function deletes common panel buttons ("X",cstar,artop,arbot).
-
//--
ObjectDelete(CI,"X");
ObjectDelete(CI,cstar);
ObjectDelete(CI,artop);
ObjectDelete(CI,arbot);
Function strTF(ENUM_TIMEFRAMES period):
This function returns the string representation of the given timeframe period.
- Code Explanation of the strTF Function:
- Variable Initialization:
- The function starts by declaring a string variable intf to store the string representation of the timeframe.
-
- Switch Statement for Timeframe Conversion:
- The function uses a switch statement to assign the appropriate string value to intf based on the period parameter.
-
switch(period)
{
//--
case PERIOD_M1:
{intf="M1"; break;}
case PERIOD_M2:
{intf="M2"; break;}
case PERIOD_M3:
{intf="M3"; break;}
case PERIOD_M4:
{intf="M4"; break;}
case PERIOD_M5:
{intf="M5"; break;}
case PERIOD_M6:
{intf="M6"; break;}
case PERIOD_M10:
{intf="M10"; break;}
case PERIOD_M12:
{intf="M12"; break;}
case PERIOD_M15:
{intf="M15"; break;}
case PERIOD_M20:
{intf="M20"; break;}
case PERIOD_M30:
{intf="M30"; break;}
case PERIOD_H1:
{intf="H1"; break;}
case PERIOD_H2:
{intf="H2"; break;}
case PERIOD_H3:
{intf="H3"; break;}
case PERIOD_H4:
{intf="H4"; break;}
case PERIOD_H6:
{intf="H6"; break;}
case PERIOD_H8:
{intf="H8"; break;}
case PERIOD_H12:
{intf="H12"; break;}
case PERIOD_D1:
{intf="D1"; break;}
case PERIOD_W1:
{intf="W1"; break;}
case PERIOD_MN1:
{intf="MN1"; break;}
//--
}
- Return the Timeframe String:
- The function returns the string representation of the given timeframe.
-
Function getUninitReasonText(int reasonCode):
This function returns a text description of the reason why the expert advisor (EA) was uninitialized based on the provided reason code.
- Code Explanation of the getUninitReasonText Function:
- Variable Initialization:
- The function starts by declaring a string variable text to store the reason description.
-
- Switch Statement for Reason Conversion:
- Return the Reason Text:
- The function returns the text description of the uninitialization reason.
-
Function WS(int width):
This function calculates the width scaling factor for wide buttons based on the screen's DPI.
- Code Explanation of the WS Function:
- Variable Initialization:
- The function starts by declaring two integer variables res and reswidth to store the result and intermediate width respectively.
-
int res=0;
int reswidth=0;
- Scaling Factor Calculation:
- The scaling factor is calculated using the screen's DPI obtained from TerminalInfoInteger.
-
//-- Calculating the scaling factor wide button on a screen
int scale_factor=(TerminalInfoInteger(TERMINAL_SCREEN_DPI));
- Width Calculation:
- The function calculates the width in screen points for standard monitors with DPI=96 and scales it accordingly.
-
//-- Use of the scaling factor
reswidth=(width * scale_factor) / 96;
res=(int)NormalizeDouble(reswidth*1.25,0);
- Return the Scaled Width:
- The function returns the scaled width value.
-
Function CreateButtonClick():
This function creates a clickable button on the chart with the specified properties.
//---
void CreateButtonClick(long chartid,
string button_name,
int button_x_size,
int button_y_size,
string button_font_model,
int button_font_size,
int button_border,
string button_name_text,
color button_bord_color,
color button_bg_color,
color button_color,
int button_corner,
int button_xdist,
int button_ydist,
bool button_hidden,
string tooltip)
{
//--
ObjectCreate(chartid,button_name,OBJ_BUTTON,0,0,0); // create button
ObjectSetInteger(chartid,button_name,OBJPROP_XSIZE,WS(button_x_size));
ObjectSetInteger(chartid,button_name,OBJPROP_YSIZE,WS(button_y_size));
ObjectSetString(chartid,button_name,OBJPROP_TEXT,button_name_text);
ObjectSetString(chartid,button_name,OBJPROP_FONT,button_font_model);
ObjectSetInteger(chartid,button_name,OBJPROP_FONTSIZE,WS(button_font_size));
ObjectSetInteger(chartid,button_name,OBJPROP_BORDER_TYPE,WS(button_border));
ObjectSetInteger(chartid,button_name,OBJPROP_BORDER_COLOR,button_bord_color);
ObjectSetInteger(chartid,button_name,OBJPROP_BGCOLOR,button_bg_color);
ObjectSetInteger(chartid,button_name,OBJPROP_COLOR,button_color);
ObjectSetInteger(chartid,button_name,OBJPROP_ANCHOR,ancp);
ObjectSetInteger(chartid,button_name,OBJPROP_CORNER,button_corner);
ObjectSetInteger(chartid,button_name,OBJPROP_XDISTANCE,WS(button_xdist));
ObjectSetInteger(chartid,button_name,OBJPROP_YDISTANCE,WS(button_ydist));
ObjectSetInteger(chartid,button_name,OBJPROP_HIDDEN,button_hidden);
ObjectSetString(chartid,button_name,OBJPROP_TOOLTIP,tooltip);
ChartRedraw(chartid);
//--
return;
//---
} //-end CreateButtonClick()
//---
- Code Explanation of the CreateButtonClick Function:
- Button Creation:
- The function starts by creating a button object on the chart using ObjectCreate.
-
ObjectCreate(chartid,button_name,OBJ_BUTTON,0,0,0); // create button
- Setting Button Properties:
- The function sets various properties for the button, such as size, font, border, colors, position, and tooltip.
-
ObjectSetInteger(chartid,button_name,OBJPROP_XSIZE,WS(button_x_size));
ObjectSetInteger(chartid,button_name,OBJPROP_YSIZE,WS(button_y_size));
ObjectSetString(chartid,button_name,OBJPROP_TEXT,button_name_text);
ObjectSetString(chartid,button_name,OBJPROP_FONT,button_font_model);
ObjectSetInteger(chartid,button_name,OBJPROP_FONTSIZE,WS(button_font_size));
ObjectSetInteger(chartid,button_name,OBJPROP_BORDER_TYPE,WS(button_border));
ObjectSetInteger(chartid,button_name,OBJPROP_BORDER_COLOR,button_bord_color);
ObjectSetInteger(chartid,button_name,OBJPROP_BGCOLOR,button_bg_color);
ObjectSetInteger(chartid,button_name,OBJPROP_COLOR,button_color);
ObjectSetInteger(chartid,button_name,OBJPROP_ANCHOR,ancp);
ObjectSetInteger(chartid,button_name,OBJPROP_CORNER,button_corner);
ObjectSetInteger(chartid,button_name,OBJPROP_XDISTANCE,WS(button_xdist));
ObjectSetInteger(chartid,button_name,OBJPROP_YDISTANCE,WS(button_ydist));
ObjectSetInteger(chartid,button_name,OBJPROP_HIDDEN,button_hidden);
ObjectSetString(chartid,button_name,OBJPROP_TOOLTIP,tooltip);
- Redrawing the Chart:
- The function calls ChartRedraw(chartid) to refresh the chart and display the newly created button.
-
Function CreateArrowLabel():
This function creates an arrow label on the chart with the specified properties.
- Code Explanation of the CreateArrowLabel Function:
- Deleting Existing Object:
- The function starts by deleting any existing object with the same label name.
-
ObjectDelete(chart_id,lable_name);
- Creating the Label:
- The function attempts to create a new label object. If the creation fails, it prints an error message and returns false.
-
//--
if(!ObjectCreate(chart_id,lable_name,OBJ_LABEL,0,0,0,0,0)) // create Label
{
Print(__FUNCTION__, ": failed to create \"Arrow Label\" sign! Error code = ",GetLastError());
return(false);
}
//--
- Setting Label Properties:
- The function sets various properties for the label, such as text, font, size, color, position, and tooltip.
-
//--
ObjectSetString(chart_id,lable_name,OBJPROP_TEXT,label_text);
ObjectSetString(chart_id,lable_name,OBJPROP_FONT,font_model);
ObjectSetInteger(chart_id,lable_name,OBJPROP_FONTSIZE,WS(font_size));
ObjectSetInteger(chart_id,lable_name,OBJPROP_COLOR,label_color);
ObjectSetInteger(chart_id,lable_name,OBJPROP_CORNER,chart_corner);
ObjectSetInteger(chart_id,lable_name,OBJPROP_ANCHOR,ancp);
ObjectSetInteger(chart_id,lable_name,OBJPROP_XDISTANCE,WS(x_cor));
ObjectSetInteger(chart_id,lable_name,OBJPROP_YDISTANCE,WS(y_cor));
ObjectSetInteger(chart_id,lable_name,OBJPROP_HIDDEN,price_hidden);
//--
- Returning Successful Execution:
- The function returns true to indicate successful execution.
-
//-- successful execution
return(true);
Function CreateButtonTemplate():
This function creates a rectangular button on the chart with the specified properties.
- Code Explanation of the CreateButtonTemplate Function:
- Button Creation:
- The function starts by creating a rectangle label object on the chart using ObjectCreate.
-
ObjectCreate(chartid,obj_name,OBJ_RECTANGLE_LABEL,0,0,0); // create Rectangle Label
- Setting Button Properties:
- The function sets various properties for the button, such as size, style, width, border, colors, position, and visibility.
-
ObjectSetInteger(chartid,obj_name,OBJPROP_XSIZE,WS(x_size));
ObjectSetInteger(chartid,obj_name,OBJPROP_YSIZE,WS(y_size));
ObjectSetInteger(chartid,obj_name,OBJPROP_STYLE,style);
ObjectSetInteger(chartid,obj_name,OBJPROP_WIDTH,WS(width));
ObjectSetInteger(chartid,obj_name,OBJPROP_BORDER_TYPE,WS(border));
ObjectSetInteger(chartid,obj_name,OBJPROP_BORDER_COLOR,bordcolor);
ObjectSetInteger(chartid,obj_name,OBJPROP_BGCOLOR,bgcolor);
ObjectSetInteger(chartid,obj_name,OBJPROP_COLOR,objcolor);
ObjectSetInteger(chartid,obj_name,OBJPROP_CORNER,corner);
ObjectSetInteger(chartid,obj_name,OBJPROP_XDISTANCE,WS(x_dist));
ObjectSetInteger(chartid,obj_name,OBJPROP_YDISTANCE,WS(y_dist));
ObjectSetInteger(chartid,obj_name,OBJPROP_HIDDEN,hidden);
- Redrawing the Chart:
- The function calls ChartRedraw(chartid) to refresh the chart and display the newly created button.
-
Function OnInit():
This is the custom indicator initialization function that is executed when the indicator is first loaded onto the chart.
- Code Explanation of the OnInit Function:
- Indicator Buffers Mapping:
- The function starts by calling the SPM_MTF_Config method of the "mi" object to configure the multi-timeframe settings.
-
- SetIndexBuffer:
- The buffer for the PowerMove indicator data is set.
-
SetIndexBuffer(0,mi.PowerMove,INDICATOR_DATA);
- PlotIndexSetString:
- The label for the plot index is set to "Move."
-
PlotIndexSetString(0,PLOT_LABEL,"Move");
- IndicatorSetString:
- IndicatorSetInteger:
- The number of digits displayed for the indicator values is set to 2.
-
IndicatorSetInteger(INDICATOR_DIGITS,2);
- Return Initialization Success:
- The function returns INIT_SUCCEEDED to indicate that the initialization was successful.
-
Function OnDeinit(const int reason):
This is the custom indicator deinitialization function that is executed when the indicator is removed from the chart or the platform is closed.
- Code Explanation of the OnDeinit Function:
- Clearing Comments:
- The function starts by clearing any comments on the chart.
-
- Printing Deinitialization Reason:
- The function prints the reason for deinitialization by calling the getUninitReasonText method of the "mi" object.
-
Print(mi.getUninitReasonText(reason));
- Deleting Indicator Objects:
- The function calls DeletedSPMObject to delete all objects related to the SPM_MTF indicator from the chart.
-
- Redrawing the Chart:
- The function calls ChartRedraw to refresh the chart and reflect the changes.
-
- Returning from the Function:
- The function ends with a return statement.
-
Function OnCalculate():
This function is executed on every new price tick and handles the main calculations for the indicator.
- Code Explanation of the OnCalculate Function:
- Resetting Last Error:
- The function starts by resetting the last error using ResetLastError.
-
- Calculating the Limit:
- The function calculates the limit for the number of bars to process.
-
//--
int limit;
limit=rates_total-prev_calculated;
if(prev_calculated>0)
limit++;
if(limit>mi.ttlbars)
limit=mi.ttlbars;
if(limit-3<=1)
limit=3;
//--
- Calculating Strength:
- The function calls CalculationStrength to calculate the strength of price movement.
-
mi.CalculationStrength(limit);
- Alert Logic:
- If alerts are enabled, the function checks for changes in price movement direction and triggers alerts accordingly.
-
//--
mi.CalculationStrength(limit);
//--
if(alerts==Yes||UseEmailAlert==Yes||UseSendnotify==Yes)
{
mi.curmin=mi.ThisTime(mi.min);
if(mi.curmin!=mi.prvmin && mi.curAlert==1 && mi.curAlert!=mi.prvAlert)
{
string AlertTxt="The strength of the price movement appears to be Rise.";
mi.Do_Alerts(AlertTxt);
mi.prvAlert=mi.curAlert;
mi.prvmin=mi.curmin;
}
if(mi.curmin!=mi.prvmin && mi.curAlert==-1 && mi.curAlert!=mi.prvAlert)
{
string AlertTxt="The strength of the price movement appears to be Down.";
mi.Do_Alerts(AlertTxt);
mi.prvAlert=mi.curAlert;
mi.prvmin=mi.curmin;
}
}
//--
- Drawing Objects:
- If the display flag is true, the function calls DrawSPMObject to redraw the indicator objects on the chart.
-
if(mi.display)
mi.DrawSPMObject();
- Returning the Total Number of Rates:
- The function returns the total number of rates for the next call.
-
Function OnChartEvent():
This function handles chart events, particularly button clicks, to manage the indicator's display and settings.
- Code Explanation of the OnChartEvent Function:
- Resetting Last Error:
- The function starts by resetting the last error using ResetLastError.
-
- Handling Object Click Events:
- The function checks if the event ID is CHARTEVENT_OBJECT_CLICK and proceeds to handle specific button clicks based on sparam.
-
if(id==CHARTEVENT_OBJECT_CLICK) {...}
- Handling "X" Button Click:
- If the "X" button is clicked, the function deletes the SPM objects, unpresses the button, sets the display flag to false, and displays the panelbutton.
-
//--- if "X" button is click
if(sparam=="X")
{
mi.DeletedSPMObject();
//--- unpress the button
ObjectSetInteger(mi.CI,"X",OBJPROP_STATE,false);
ObjectSetInteger(mi.CI,"X",OBJPROP_ZORDER,0);
//--
mi.display=false;
ObjectDelete(mi.CI,"X");
mi.DisplayPanelButton();
}
- Handling "cstar" Button Click:
- If the "cstar" button is clicked, the function deletes the SPM objects, displays the panel button, unpresses the button, sets the display flag to true, and draws the SPM object.
-
//--- if "cstar" button is click
if(sparam==mi.cstar)
{
mi.DeletedSPMObject();
mi.DisplayPanelButton();
//--- unpress the button
ObjectSetInteger(mi.CI,mi.cstar,OBJPROP_STATE,false);
ObjectSetInteger(mi.CI,mi.cstar,OBJPROP_ZORDER,0);
if(!mi.display)
mi.display=true;
if(mi.corpos==mi.posbot) ObjectDelete(mi.CI,mi.arbot);
if(mi.corpos==mi.postop) ObjectDelete(mi.CI,mi.artop);
mi.DrawSPMObject();
//--
ChartRedraw(mi.CI);
}
- Handling "artop" Button Click:
- If the "artop" button is clicked, the function deletes the SPM objects, displays the panel button, unpresses the button, sets the display flag to true, changes the panel position to the top, and draws the SPM object.
-
//--- if "artop" button is click
if(sparam==mi.artop)
{
mi.DeletedSPMObject();
mi.DisplayPanelButton();
//--- unpress the button
ObjectSetInteger(mi.CI,mi.artop,OBJPROP_STATE,false);
ObjectSetInteger(mi.CI,mi.artop,OBJPROP_ZORDER,0);
if(!mi.display)
mi.display=true;
ObjectDelete(mi.CI,mi.artop);
mi.PanelPosChange(mi.postop);
//--
ObjectDelete(mi.CI,"X");
mi.DisplayButtonClick("arbot");
mi.DrawSPMObject();
//--
ChartRedraw(mi.CI);
}
- Handling "arbot" Button Click:
- If the "arbot" button is clicked, the function deletes the SPM objects, displays the panel button, unpresses the button, sets the display flag to true, changes the panel position to the bottom, and draws the SPM object.
-
//--- if "arbot" button is click
if(sparam==mi.arbot)
{
mi.DeletedSPMObject();
mi.DisplayPanelButton();
//--- unpress the button
ObjectSetInteger(mi.CI,mi.arbot,OBJPROP_STATE,false);
ObjectSetInteger(mi.CI,mi.arbot,OBJPROP_ZORDER,0);
if(!mi.display)
mi.display=true;
ObjectDelete(mi.CI,mi.arbot);
mi.PanelPosChange(mi.posbot);
//--
ObjectDelete(mi.CI,"X");
mi.DisplayButtonClick("artop");
mi.DrawSPMObject();
//--
ChartRedraw(mi.CI);
}
- Handling Timeframe Button Clicks:
- If any of the timeframe buttons are clicked, the function changes the chart symbol and timeframe accordingly.
-
//--- if TF button is click
//--
if(sparam==mi.TFSc[0])
{
mi.ChangeChartSymbol(mi.TFSc[0],mi.TFId[0]);
}
//--
if(sparam==mi.TFSc[1])
{
mi.ChangeChartSymbol(mi.TFSc[1],mi.TFId[1]);
}
//--
if(sparam==mi.TFSc[2])
{
mi.ChangeChartSymbol(mi.TFSc[2],mi.TFId[2]);
}
//--
if(sparam==mi.TFSc[3])
{
mi.ChangeChartSymbol(mi.TFSc[3],mi.TFId[3]);
}
//--
if(sparam==mi.TFSc[4])
{
mi.ChangeChartSymbol(mi.TFSc[4],mi.TFId[4]);
}
//--
if(sparam==mi.TFSc[5])
{
mi.ChangeChartSymbol(mi.TFSc[5],mi.TFId[5]);
}
//--
if(sparam==mi.TFSc[6])
{
mi.ChangeChartSymbol(mi.TFSc[6],mi.TFId[6]);
}
//--
if(sparam==mi.TFSc[7])
{
mi.ChangeChartSymbol(mi.TFSc[7],mi.TFId[7]);
}
//--
if(sparam==mi.TFSc[8])
{
mi.ChangeChartSymbol(mi.TFSc[8],mi.TFId[8]);
}
//--
if(sparam==mi.TFSc[9])
{
mi.ChangeChartSymbol(mi.TFSc[9],mi.TFId[9]);
}
//--
if(sparam==mi.TFSc[10])
{
mi.ChangeChartSymbol(mi.TFSc[10],mi.TFId[10]);
}
//--
if(sparam==mi.TFSc[11])
{
mi.ChangeChartSymbol(mi.TFSc[11],mi.TFId[11]);
}
//--
if(sparam==mi.TFSc[12])
{
mi.ChangeChartSymbol(mi.TFSc[12],mi.TFId[12]);
}
//--
if(sparam==mi.TFSc[13])
{
mi.ChangeChartSymbol(mi.TFSc[13],mi.TFId[13]);
}
//--
if(sparam==mi.TFSc[14])
{
mi.ChangeChartSymbol(mi.TFSc[14],mi.TFId[14]);
}
//--
if(sparam==mi.TFSc[15])
{
mi.ChangeChartSymbol(mi.TFSc[15],mi.TFId[15]);
}
//--
if(sparam==mi.TFSc[16])
{
mi.ChangeChartSymbol(mi.TFSc[16],mi.TFId[16]);
}
//--
if(sparam==mi.TFSc[17])
{
mi.ChangeChartSymbol(mi.TFSc[17],mi.TFId[17]);
}
//--
if(sparam==mi.TFSc[18])
{
mi.ChangeChartSymbol(mi.TFSc[18],mi.TFId[18]);
}
//--
if(sparam==mi.TFSc[19])
{
mi.ChangeChartSymbol(mi.TFSc[19],mi.TFId[19]);
}
//--
if(sparam==mi.TFSc[20])
{
mi.ChangeChartSymbol(mi.TFSc[20],mi.TFId[20]);
}
//--
}
We hope that this article and the SPM_MTF or Strength of Price Movement Multi Timeframe indicator for MT5 program will be useful for traders in learning and generating new ideas, which can ultimately make money from forex trading.
Thanks for reading this article.
