NinjaScript > Language Reference > Common > Charts

The ChartControl class provides access to a wide range of properties and methods related to the location of objects on a chart and other chart-related properties. The ChartControl object provides information related to the entire hosting grid of the chart, which overlap with the ChartPanel, ChartScale and ChartBars.

Note: The ChartControl object is ONLY guaranteed to be available when a NinjaScript type initiates from a Chart Window. There are situations where an indicator or strategy starts from another Windows (such as the Control Center's Strategies Grid, or from a Strategy Analyzer), where the ChartContol object is NOT accessible. Therefore, the ChartControl object should always be safely accessed (e.g., from within a try-catch, or conditionally using null reference checks)

ChartControl_1

Warning: The ChartControl and its methods and properties should ONLY be access once the State has reached State.Historical

Methods and Properties

AxisXHeight	Measures the distance (in pixels) between the x-axis and the top of the horizontal scroll bar
AxisYLeftWidth	Measures the distance (in pixels) between the y-axis and the left margin of a chart
AxisYRightWidth	Measures the distance (in pixels) between the y-axis and the right margin of a chart
BarMarginLeft	Measures the margin to the left of each bar on the chart, in pixels
BarsArray	Provides a collection of ChartBars objects currently configured on the chart
BarSpacingType	Provides the type of bar spacing used for the primary Bars object on the chart
BarsPeriod	Provides the period (interval) used for the primary Bars object on the chart
BarWidth	Measures the value of the bar width set for the primary Bars object on the chart
BarWidthArray	An array containing the values of the BarWidth properties of all Bars objects on the chart
CanvasLeft	Indicates the x-coordinate (in pixels) of the beginning of the chart canvas area
CanvasRight	Indicates the x-coordinate (in pixels) of the end of the chart canvas area
CanvasZoomState	Indicates the current state of the Zoom tool on the chart
ChartPanels	Holds a collection of ChartPanel objects
CrosshairType	Indicates the Cross Hair type currently enabled on the chart
FirstTimePainted	Indicates a time value of the first bar painted on the chart
GetBarPaintWidth()	Returns the width of the bars in the primary Bars object on the chart, in pixels
GetSlotIndexByTime()	Returns the slot index of the primary Bars object on the chart corresponding to a specified time value
GetSlotIndexByX()	Returns the slot index of the primary Bars object on the chart corresponding to a specified x-coordinate on the visible chart canvas
GetTimeBySlotIndex()	Returns a time value corresponding to a specified slot index of the primary Bars object on the chart
GetTimeByX()	Returns a time value related to the primary Bars' slot index at a specified x-coordinate on the chart canvas
GetXByBarIndex()	Returns the chart-canvas x-coordinate of the bar at a specified index of a specified ChartBars object on the chart
GetXByTime()	Returns the chart-canvas x-coordinate of the slot index of the primary Bars object corresponding to a specified time
Indicators	Returns a collection of indicators currently configured on the chart
IsScrollArrowVisible	Indicates the time-axis scroll arrow is visible in the top-right corner of the chart
IsStayInDrawMode	Indicates the Stay in Draw Mode is currently enabled on the chart
IsYAxisDisplayedLeft	Indicates the y-axis displays (in any chart panel) to the left side of the chart canvas
IsYAxisDisplayedOverlay	Indicates an object on the chart is using the Overlay scale justification
IsYAxisDisplayedRight	Indicates the y-axis displays (in any chart panel) to the right side of the chart canvas
LastSlotPainted	Indicates the slot index of the most recently painted bar on the primary Bars object configured on the chart
LastTimePainted	Indicates the time of the most recently painted bar on the primary Bars object configured on the chart
MouseDownPoint	Indicates the x- and y-coordinates of the mouse cursor at the most recent OnMouseDown() event
Properties	A collection of properties related to the configuration of the Chart
SlotsPainted	Indicates the number of index slots in which bars are painted within the chart canvas area
Strategies	A collection of strategies configured on the chart
TimePainted	Indicates the range of time in which bars are painted on the visible chart canvas