AxisScrollBar Class

Definition

Namespace:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Represents the scrollbar of a chart axis.

public ref class AxisScrollBar : IDisposable

public class AxisScrollBar : IDisposable

type AxisScrollBar = class
    interface IDisposable

Public Class AxisScrollBar
Implements IDisposable

Inheritance

Object

AxisScrollBar

Implements

IDisposable

Remarks

The AxisScrollBar class is exposed as the ScrollBar property of the Axis class.

Scrollbars allow the end user to scroll through data when a subset of data is being displayed. A subset of data is referred to as a view, and is represented by the AxisScaleView class.

Scrollbars are only shown when zooming occurs. In other words, even if a scrollbar is enabled, it will only be visible when a view is being displayed.

Important

To fix the position of scrollbars, the plotting area position of a chart area must not be set to Auto. To explicitly set the plotting area position, use the InnerPlotPosition property.

To display scrollbars when a chart is first displayed, use the AxisScaleView class properties and methods so that a view is initially displayed to end users.

The background color, button color and width of scrollbars can be set using this AxisScrollBar class.

Note that there are two main types of scrolling: large scrolling, which occurs when the end user clicks in the background of a scrollbar - that is, that part of a scrollbar not covered by the thumb; and small scrolling, which occurs when the end user clicks a left/right or up/down button. To control the large scrolling size, use the Size property of the ScaleView object. To set the small scrolling size, use the SmallScrollSize property of the AxisScaleView class.

Constructors

AxisScrollBar()

Initializes a new instance of the AxisScrollBar class.

Properties

Axis	Gets the Axis object that uses the scrollbar.
BackColor	Gets or sets the background color of a scrollbar.
ButtonColor	Gets or sets the color of the scrollbar buttons.
ButtonStyle	Gets or sets the style of the scrollbar button.
ChartArea	Gets the chart area that contains this scrollbar.
Enabled	Gets or sets a flag that determines whether a scrollbar is enabled.
IsPositionedInside	Gets or sets a flag that indicates whether scroll bar is positioned inside or outside the chart area.
IsVisible	Gets a flag that indicates whether the scrollbar is visible.
LineColor	Gets or sets the line color of a scrollbar.
Size	Gets or sets the width of a scrollbar, in pixels.

Methods

Dispose()	Releases all resources used by the current instance of the AxisScrollBar.
Dispose(Boolean)	Releases the unmanaged resources used by the AxisScrollBar class and optionally releases the managed resources.
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)