TrackBarControl Class

Displays a scale with tickmarks. Users can drag a thumb to change the current value.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v20.1.dll

Declaration

public class TrackBarControl :
    BaseEdit,
    IXtraResizableControl,
    ISupportInitialize,
    IGestureClient
Public Class TrackBarControl
    Inherits BaseEdit
    Implements IXtraResizableControl,
               ISupportInitialize,
               IGestureClient

Remarks

The figure below illustrates a Track Bar Control.

TrackbarControl

Main settings:

Value progression settings:

  • Properties.SmallChange - a small-increment increase or decrease in value. The control's slider moves in small-increment steps when a user presses an arrow key.
  • Properties.LargeChange - a large-increment increase or decrease in value. The control's slider moves in large-increment steps when a user presses the Page Up or Page Down key.
  • Properties.SmallChangeUseMode - specifies whether a user can spin the mouse wheel to change the control value by a small increment.

Manage the control value in code:

private void TrackBarControl1_ValueChanged(object sender, EventArgs e) {
    TrackBarControl tbc = sender as TrackBarControl;
    if (tbc.OldEditValue != null && (int)tbc.OldEditValue < 8 && tbc.Value >= 8)
        XtraMessageBox.Show(
            "We reccomend that you keep this setting at Level 7 or less", "Warning");
}

Tickmarks and labels:

  • Properties.TickStyle - specifies whether a control should display tickmarks on both sides of a scale, on one side only, or hide them completely.
  • Properties.TickFrequency - the distance between adjacent tickmarks.
  • Properties.ShowLabels - gets or sets whether a control shows labels next to tickmarks. Default labels are value numbers (1, 2, 3, etc.). You can edit the Labels collection to replace them with custom strings.
See Also