ASPxTrackBar Class
A slider editor.
Namespace: DevExpress.Web
Assembly: DevExpress.Web.v18.2.dll
Declaration
public class ASPxTrackBar :
ASPxEdit,
IEditDataHelperOwner,
IValueTypeHolder,
IControlDesignerRemarks
ASPxTrackBar is a slider control that provides end-users with fast and easy visual data selection capabilities. End-users can select a value within the ASPxTrackBar by positioning a drag handle. The minimum distance the drag handle can be moved is determined via the ASPxTrackBar.Step property.
By default, a track bar is a slider with scale range from 0 up to 100. You can change limits of the range of values by the ASPxTrackBar.MinValue and ASPxTrackBar.MaxValue properties.
You can populate the ASPxTrackBar.Items collection to create custom track bar items (TrackBarItem). You can specify an item’s display text (TrackBarItem.Text), value (TrackBarItem.Value), and tooltip (TrackBarItem.ToolTip).
Additionally the ASPxTrackBar control can be bound to a data source by using the ASPxTrackBar.DataSource or ASPxTrackBar.DataSourceID property. You can specify which data source fields the item information (text, value, and tooltip) should be retrieved from. In this case, the Items collection is not in effect.
The current position of the drag handle is specified via the ASPxTrackBar.Position property. If the ASPxTrackBar.AllowRangeSelection property is set to true, ASPxTrackBar displays two drag handles to support the value range selection. The position of the main and secondary drag handles is specified via the ASPxTrackBar.PositionStart and ASPxTrackBar.PositionEnd properties respectively.
The appearance and functionality of the ASPxTrackBar control can be customized in different ways:
- ASPxTrackBar can be oriented horizontally or vertically, dependent upon the ASPxTrackBar.Orientation property value.
- ASPxTrackBar can be displayed in normal or reversed mode, controlled by the ASPxTrackBar.Direction property.
- You can define how the scale labels should be highlighted using the ASPxTrackBar.ScaleLabelHighlightMode property.
- The position of scale and value tooltip elements can be specified via the ASPxTrackBar.ScalePosition and ASPxTrackBar.ValueToolTipPosition properties respectively.
Note
The client-side equivalent of this editor control is represented by the ASPxClientTrackBar object. The editor’s client-side API is enabled if the ASPxEditBase.EnableClientSideAPI property is set to true, or the ASPxEditBase.ClientInstanceName property is defined, or any client event is handled. Available client events can be accessed via the ASPxTrackBar.ClientSideEvents property.