Information on this website refers to a deprecated product, and is provided only for historical reference. Please use the Version Switcher above to select an appropriate documentation website for the product you are using.

ChartScrollbarSettings

Type class

ChartScrollbarSettings settings set's settings for chart scrollbar. If you change a property after the chart is initialized, you should call stockChart.validateNow() method in order for it to work. If there is no default value specified, default value of ChartScrollbar class will be used.

Inheritance

ChartScrollbarSettings does not extend any other symbol.

ChartScrollbarSettings is not extended by any other symbol.

Properties

autoGridCount
#

Type boolean

Default true

Specifies whether number of gridCount is specified automatically, according to the axis size.

backgroundAlpha
#

Type number

Default

Background opacity.

backgroundColor
#

Type string

Default

Background color of the scrollbar.

color
#

Type string

Default

Text color.

dragIconHeight
#

Type number

Default 18

Height of resize grip image. Note, you should also update the image in amcharts/images folder if you don't want it to be distorted because of resizing.

dragIconWidth
#

Type number

Default 11

Width of resize grip image. Note, you should also update the image in amcharts/images folder if you don't want it to be distorted because of resizing.

enabled
#

Type boolean

Default true

Set false if you don't need scrollbar.

fontSize
#

Type number

Default

Font size.

graph
#

Type AmGraph

Default

Specifies which graph will be displayed in the scrollbar.

graphFillAlpha
#

Type number

Default

Graph fill opacity.

graphFillColor
#

Type string

Default

Graph fill color.

graphLineAlpha
#

Type number

Default

Graph line opacity.

graphLineColor
#

Type string

Default

Graph line color.

graphType
#

Type string

Default

Type of chart scrollbar's graph. By default the graph type is the same as the original graph's type, however in case of candlestick or ohlc you might want to show line graph in the scrollbar. Possible values are: line, column, step, smoothedLine, candlestick, ohlc.

gridAlpha
#

Type number

Default

Grid opacity.

gridColor
#

Type string

Default

Grid color.

gridCount
#

Type number

Default

Grid count. You should set autoGridCount to false in order this property to work.

height
#

Type number

Default 40

Height of scrollbar, in pixels.

hideResizeGrips
#

Type boolean

Default false

Specifies whether resize grips are hidden when mouse is away from the scrollbar.

scrollDuration
#

Type number

Default

Duration of scrolling, when the user clicks on scrollbar's background, in seconds.

selectedBackgroundAlpha
#

Type number

Default

Selected background opacity.

selectedBackgroundColor
#

Type string

Default

Selected background color.

selectedGraphFillAlpha
#

Type number

Default

Selected graph'sfill opacity.

selectedGraphFillColor
#

Type string

Default

Selected graph'sfill color.

selectedGraphLineAlpha
#

Type number

Default

Selected graph'sline opacity.

selectedGraphLineColor
#

Type string

Default

Selected graph's line color.

updateOnReleaseOnly
#

Type boolean

Default true

Specifies if the chart should be updated while dragging/resizing the scrollbar or only at the moment when user releases mouse button. Usefull when working with large data sets.

usePeriod
#

Type string

This is very important feature for those, who work with large data sets. You can tell ChartScrollbar what period it should use for it's graph and save a lot of time for rendering of this graph. For example, if your minPeriod is "DD" (days), set usePeriod = "WW" (weeks) and you will have 7 times less data points in scrollbar's graph. Note, the period you specify here should be set in CategoryAxesSettings.groupToPeriods.

Methods

ChartScrollbarSettings does not have any methods.

Events

ChartScrollbarSettings does not have any events.

Adapters

ChartScrollbarSettings does not have any adapters.