Export (0) Print
Expand All

AxisScrollBar Class

Represents the scrollbar of a chart axis.

System.Object
  System.Windows.Forms.DataVisualization.Charting.AxisScrollBar

Namespace:  System.Windows.Forms.DataVisualization.Charting
Assembly:  System.Windows.Forms.DataVisualization (in System.Windows.Forms.DataVisualization.dll)

'Declaration
Public Class AxisScrollBar _
	Implements IDisposable

The AxisScrollBar type exposes the following members.

  NameDescription
Public methodAxisScrollBarInitializes a new instance of the AxisScrollBar class.
Top

  NameDescription
Public propertyAxisGets the Axis object that uses the scrollbar.
Public propertyBackColorGets or sets the background color of a scrollbar.
Public propertyButtonColorGets or sets the color of the scrollbar buttons.
Public propertyButtonStyleGets or sets the style of the scrollbar button.
Public propertyChartAreaGets the chart area that contains this scrollbar.
Public propertyEnabledGets or sets a flag that determines whether a scrollbar is enabled.
Public propertyIsPositionedInsideGets or sets a flag that indicates whether scroll bar is positioned inside or outside the chart area.
Public propertyIsVisibleGets a flag that indicates whether the scrollbar is visible.
Public propertyLineColorGets or sets the line color of a scrollbar.
Public propertySizeGets or sets the width of a scrollbar, in pixels.
Top

  NameDescription
Public methodDisposeReleases all resources used by the current instance of the AxisScrollBar.
Protected methodDispose(Boolean)Releases the unmanaged resources used by the AxisScrollBar class and optionally releases the managed resources.
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

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 noteImportant

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.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4

.NET Framework Client Profile

Supported in: 4

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft