MQL4 Reference Chart Operations

Chart Operations

These are functions for working with charts. All chart operations are allowed in Expert Advisors and scripts only.

The functions defining the chart properties are actually used for sending change commands to the chart. If these functions are executed successfully, the command is included in the common queue of the chart events. The changes are implemented to the chart when handling the queue of the chart events.

Thus, do not expect an immediate visual update of the chart after calling these functions. Generally, the chart is updated automatically by the terminal following the change events - a new quote arrival, resizing the chart window, etc. Use ChartRedraw() function to forcefully update the chart.

Function	Action
ChartApplyTemplate	Applies a specific template from a specified file to the chart
ChartSaveTemplate	Saves current chart settings in a template with a specified name
ChartWindowFind	Returns the number of a subwindow where an indicator is drawn
ChartTimePriceToXY	Converts the coordinates of a chart from the time/price representation to the X and Y coordinates
ChartXYToTimePrice	Converts the X and Y coordinates on a chart to the time and price values
ChartOpen	Opens a new chart with the specified symbol and period
ChartFirst	Returns the ID of the first chart of the client terminal
ChartNext	Returns the chart ID of the chart next to the specified one
ChartClose	Closes the specified chart
ChartSymbol	Returns the symbol name of the specified chart
ChartPeriod	Returns the period value of the specified chart
ChartRedraw	Calls a forced redrawing of a specified chart
ChartSetDouble	Sets the double value for a corresponding property of the specified chart
ChartSetInteger	Sets the integer value (datetime, int, color, bool or char) for a corresponding property of the specified chart
ChartSetString	Sets the string value for a corresponding property of the specified chart
ChartGetDouble	Returns the double value property of the specified chart
ChartGetInteger	Returns the integer value property of the specified chart
ChartGetString	Returns the string value property of the specified chart
ChartNavigate	Performs shift of the specified chart by the specified number of bars relative to the specified position in the chart
ChartID	Returns the ID of the current chart
ChartIndicatorDelete	Removes an indicator with a specified name from the specified chart window
ChartIndicatorName	Returns the short name of the indicator by the number in the indicators list on the specified chart window
ChartIndicatorsTotal	Returns the number of all indicators applied to the specified chart window.
ChartWindowOnDropped	Returns the number (index) of the chart subwindow the Expert Advisor or script has been dropped to
ChartPriceOnDropped	Returns the price coordinate of the chart point the Expert Advisor or script has been dropped to
ChartTimeOnDropped	Returns the time coordinate of the chart point the Expert Advisor or script has been dropped to
ChartXOnDropped	Returns the X coordinate of the chart point the Expert Advisor or script has been dropped to
ChartYOnDropped	Returns the Y coordinate of the chart point the Expert Advisor or script has been dropped to
ChartSetSymbolPeriod	Changes the symbol value and a period of the specified chart
ChartScreenShot	Provides a screenshot of the chart of its current state in a gif format
Period	Returns timeframe of the current chart
Symbol	Returns a text string with the name of the current financial instrument
WindowBarsPerChart	Returns the amount of bars visible on the chart
WindowExpertName	Returns the name of the executed Expert Advisor, script, custom indicator, or library
WindowFind	Returns the window index containing this specified indicator
WindowFirstVisibleBar	Returns index of the first visible bar in the current chart window
WindowHandle	Returns the system handle of the chart window
WindowIsVisible	Returns the visibility flag of the chart subwindow
WindowOnDropped	Returns the window index where Expert Advisor, custom indicator or script was dropped
WindowPriceMax	Returns the maximal value of the vertical scale of the specified subwindow of the current chart
WindowPriceMin	Returns the minimal value of the vertical scale of the specified subwindow of the current chart
WindowPriceOnDropped	Returns the price of the chart point where Expert Advisor or script was dropped
WindowRedraw	Redraws the current chart forcedly
WindowScreenShot	Saves current chart screen shot as a GIF, PNG or BMP file depending on specified extension
WindowTimeOnDropped	Returns the time of the chart point where Expert Advisor or script was dropped
WindowsTotal	Returns total number of indicator windows on the chart
WindowXOnDropped	Returns the value at X axis in pixels for the chart window client area point at which the Expert Advisor or script was dropped
WindowYOnDropped	Returns the value at Y axis in pixels for the chart window client area point at which the Expert Advisor or script was dropped

iVolumeChartApplyTemplate