Class RadTrackBar

Represents a track bar. The trackbar class is essentially a simple wrapper for the RadTrackBarElement. All UI and logic functionality is implemented in the RadTrackBarElement class. The RadTrackBar acts to transfer the events to and from its corresponding RadTrackBarElement instance. The RadTrackBarElement may be nested in other telerik controls.

Inheritance
System.Object
RadControl
RadEditorControl
RadTrackBar
Inherited Members
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

[TelerikToolboxCategory("Editors")]
public class RadTrackBar : RadEditorControl, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IPCHost, IAnalyticsProvider

Constructors

RadTrackBar()

Initializes a new instance of the RadTrackBar class.

Declaration
public RadTrackBar()

Properties

AllowKeyNavigation

Gets or sets whether key navigation is allowed on the trackbar.

Declaration
public bool AllowKeyNavigation { get; set; }
Property Value
System.Boolean

AutoSize

Gets or sets whether the control automatically adjusts its size.

Declaration
public override bool AutoSize { get; set; }
Property Value
System.Boolean

Overrides

DefaultSize

Gets the default size for the track bar control.

Declaration
protected override Size DefaultSize { get; }
Property Value
System.Drawing.Size

LabelStyle

Gets or sets the label style for the trackbar.

Declaration
public TrackBarLabelStyle LabelStyle { get; set; }
Property Value
TrackBarLabelStyle

LargeChange

Gets or sets the large change value for the trackbar.

Declaration
public int LargeChange { get; set; }
Property Value
System.Int32

LargeTickFrequency

Gets or sets the frequency of large tick marks on the trackbar.

Declaration
public int LargeTickFrequency { get; set; }
Property Value
System.Int32

Maximum

Gets or sets the maximum value for the trackbar position.

Declaration
public float Maximum { get; set; }
Property Value
System.Single

Minimum

Gets or sets the minimum value for the trackbar position.

Declaration
public float Minimum { get; set; }
Property Value
System.Single

Orientation

Gets or sets the orientation of the trackbar (horizontal or vertical).

Declaration
public Orientation Orientation { get; set; }
Property Value
System.Windows.Forms.Orientation

Ranges

Gets the collection of ranges defined for the trackbar.

Declaration
public TrackBarRangeCollection Ranges { get; }
Property Value
TrackBarRangeCollection

ShowButtons

Gets or sets whether buttons are displayed on the trackbar.

Declaration
public bool ShowButtons { get; set; }
Property Value
System.Boolean

ShowSlideArea

Gets or sets whether the slide area is displayed on the trackbar.

Declaration
public bool ShowSlideArea { get; set; }
Property Value
System.Boolean

SmallChange

Gets or sets the small change value for the trackbar.

Declaration
public int SmallChange { get; set; }
Property Value
System.Int32

SmallTickFrequency

Gets or sets the frequency of small tick marks on the trackbar.

Declaration
public int SmallTickFrequency { get; set; }
Property Value
System.Int32

SnapFrequency

Gets or sets the frequency of snap points on the trackbar.

Declaration
public TrackBarSnapFrequency SnapFrequency { get; set; }
Property Value
TrackBarSnapFrequency

SnapMode

Gets or sets the snap mode for the trackbar.

Declaration
public TrackBarSnapModes SnapMode { get; set; }
Property Value
TrackBarSnapModes

Text

This property is not relevant for this class.

Declaration
public override string Text { get; set; }
Property Value
System.String

Overrides

TextOrientation

Gets or sets the orientation of the text displayed on the trackbar.

Declaration
public Orientation TextOrientation { get; set; }
Property Value
System.Windows.Forms.Orientation

ThumbSize

Gets or sets the size of the thumb on the trackbar.

Declaration
public Size ThumbSize { get; set; }
Property Value
System.Drawing.Size

TickStyle

Gets or sets the style of the tick marks displayed on the trackbar.

Declaration
public TickStyles TickStyle { get; set; }
Property Value
TickStyles

TrackBarElement

Gets the instance of RadTrackBarElement wrapped by this control. RadTrackBarElement is the main element in the hierarchy tree and encapsulates the actual functionality of RadTrackBar.

Declaration
public RadTrackBarElement TrackBarElement { get; }
Property Value
RadTrackBarElement

TrackBarMode

Gets or sets the mode of the trackbar range.

Declaration
public TrackBarRangeMode TrackBarMode { get; set; }
Property Value
TrackBarRangeMode

Value

Gets or sets the current value of the trackbar.

Declaration
public float Value { get; set; }
Property Value
System.Single

Methods

CreateChildItems(RadElement)

Creates the child elements for the track bar control.

Declaration
protected override void CreateChildItems(RadElement parent)
Parameters
RadElement parent

The parent element to which child elements will be added.
Overrides

CreateTrackBarElement()

Creates the associated RadTrackBarElement.

Declaration
protected virtual RadTrackBarElement CreateTrackBarElement()
Returns
RadTrackBarElement

A new instance of RadTrackBarElement.

Dispose(Boolean)

Releases the unmanaged resources used by the RadTrackBar and optionally releases the managed resources.

Declaration
protected override void Dispose(bool disposing)
Parameters
System.Boolean disposing

True to release both managed and unmanaged resources; false to release only unmanaged resources.
Overrides

InitializeRootElement(RootRadElement)

Initializes the root element with track bar-specific settings.

Declaration
protected override void InitializeRootElement(RootRadElement rootElement)
Parameters
RootRadElement rootElement

The root element to initialize.
Overrides

OnGotFocus(EventArgs)

Called when the control receives focus and transfers focus to the track bar element.

Declaration
protected override void OnGotFocus(EventArgs e)
Parameters
System.EventArgs e

The event arguments.
Overrides

OnLabelFormatting(LabelFormattingEventArgs)

Raises the LabelFormatting event.

Declaration
protected virtual void OnLabelFormatting(LabelFormattingEventArgs e)
Parameters
LabelFormattingEventArgs e

The label formatting event arguments.

OnTickFormatting(TickFormattingEventArgs)

Raises the TickFormatting event.

Declaration
protected virtual void OnTickFormatting(TickFormattingEventArgs e)
Parameters
TickFormattingEventArgs e

The tick formatting event arguments.

OnValueChanged(EventArgs)

Raises the ValueChanged event.

Declaration
protected virtual void OnValueChanged(EventArgs e)
Parameters
System.EventArgs e

The event arguments.

ProcessAutoSizeChanged(Boolean)

Processes changes to the AutoSize property and updates element stretching behavior.

Declaration
protected override void ProcessAutoSizeChanged(bool value)
Parameters
System.Boolean value

The new AutoSize value.
Overrides

ProcessDialogKey(Keys)

Processes dialog keys for track bar navigation when AllowKeyNavigation is enabled.

Declaration
protected override bool ProcessDialogKey(Keys keyData)
Parameters
System.Windows.Forms.Keys keyData

The key data to process.
Returns
System.Boolean

True if the key was processed; otherwise, false.

ResetBackColorThemeOverrides()

Resets theme overrides for the background color property.

Declaration
protected override void ResetBackColorThemeOverrides()
Overrides

ResetForeColorThemeOverrides()

Resets theme overrides for the foreground color property.

Declaration
protected override void ResetForeColorThemeOverrides()
Overrides

SetBackColorThemeOverrides()

Sets theme overrides for the background color property.

Declaration
protected override void SetBackColorThemeOverrides()
Overrides

SetForeColorThemeOverrides()

Sets theme overrides for the foreground color property.

Declaration
protected override void SetForeColorThemeOverrides()
Overrides

UnwireEvents()

Unwires event handlers from the track bar element.

Declaration
protected virtual void UnwireEvents()

WireEvents()

Wires up event handlers for the track bar element.

Declaration
protected virtual void WireEvents()

Events

LabelFormatting

Occurs when a label needs to be formatted.

Declaration
public event LabelFormattingEventHandler LabelFormatting
Event Type
LabelFormattingEventHandler

RangeValueChanged

Occurs when a range value is changed.

Declaration
public event RangeChangedEventHandler RangeValueChanged
Event Type
RangeChangedEventHandler

TickFormatting

Occurs when a tick mark needs to be formatted.

Declaration
public event TickFormattingEventHandler TickFormatting
Event Type
TickFormattingEventHandler

ValueChanged

Occurs when the Value property changes.

Declaration
public event EventHandler ValueChanged
Event Type
System.EventHandler

Extension Methods