RadSpinEditor
Represents a numeric up/down control box. The RadSpinEditor class is a simple wrapper for the RadSpinElement class. The RadSpinEditor acts to transfer events to and from its corresponding RadSpinElement. The RadSpinElement which is essentially the RadSpinEditor control may be nested in other telerik controls.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
[TelerikToolboxCategory("Editors")]
[DefaultBindingProperty("Value")]
public class RadSpinEditor : RadEditorControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider, ISupportInitialize, ISupportRootUIAutomation
Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadEditorControlRadSpinEditor...
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadSpinEditor class.
public RadSpinEditor()
Properties
Gets or sets whether the edit control is auto-sized.
[Browsable(true)]
public override bool AutoSize { get; set; }
Overrides:
Gets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus.
public bool CausesValidation { get; set; }
true if the control causes validation to be performed on any controls requiring validation when it receives focus; otherwise, false.
Gets or sets the number of decimal places to display in the RadSpinEditor.
public int DecimalPlaces { get; set; }
Gets the default control size.
protected override Size DefaultSize { get; }
Overrides:
Gets or sets how to interpret the empty text in the editor portion of the control. If true the empty value will set NULL in NullableValue property.
public virtual bool EnableNullValueInput { get; set; }
Gets or sets a value indicating whether the UI Automation functionality is enabled or disabled for this control.
public override bool EnableUIAutomation { get; set; }
Overrides:
Implements:
Gets or sets a value indicating whether the RadSpinEditor should display the value it contains in hexadecimal format.
public bool Hexadecimal { get; set; }
Gets or sets the increment value for step.
public decimal Increment { get; set; }
Gets or sets a value indicating whether the user can use the UP ARROW and DOWN ARROW keys to select values.
public bool InterceptArrowKeys { get; set; }
Gets or sets the maximum value for the spin editor.
public decimal Maximum { get; set; }
Gets or sets the minimum value for the spin editor.
public decimal Minimum { get; set; }
Gets or sets the decimal value in the numeric up/down control. The Value can be null.
[Bindable(true)]
public decimal? NullableValue { get; set; }
Gets or sets a value indicating whether the text can be changed by the use of the up or down buttons only.
public bool ReadOnly { get; set; }
Gets or sets whether by right-mouse clicking the up/down button you reset the value to the Maximum/Minimum value respectively.
public bool RightMouseButtonReset { get; set; }
Gets or sets a value indicating whether the border is shown.
public bool ShowBorder { get; set; }
Gets or sets whether RadSpinEditor will be used as a numeric textbox.
public bool ShowUpDownButtons { get; set; }
Gets the instance of RadSpinElement wrapped by this control. RadSpinElement is the main element in the hierarchy tree and encapsulates the actual functionality of RadSpinEditor.
[Browsable(false)]
public RadSpinElement SpinElement { get; }
Gets or sets a value indicating whether the user can give the focus to this control using the TAB key.
public bool TabStop { get; set; }
true if the user can give the focus to the control using the TAB key, otherwise false. The default is true.
Gets or sets the text alignment of the RadSpinEditor.
public virtual HorizontalAlignment TextAlignment { get; set; }
Gets or sets a value indicating whether a thousands separator is displayed in the RadSpinEditor.
public bool ThousandsSeparator { get; set; }
Gets or sets the decimal value in the numeric up/down control.
[Bindable(true)]
public decimal Value { get; set; }
Methods
Determines whether the control defines the theme for the specified element.
public override bool ControlDefinesThemeForElement(RadElement element)
The element to check.
Returns:true if the control defines the theme for the element; otherwise, false.
Overrides:
Creates the accessibility instance for this control.
protected override AccessibleObject CreateAccessibilityInstance()
An AccessibleObject instance for accessibility support.
Overrides:
Creates child items in the RadSpinEditor control element hierarchy.
protected override void CreateChildItems(RadElement parent)
The parent element to which child items are added.
Overrides:
Creates the spin element for this control.
Raises the RightToLeftChanged event.
Raises the Validated event.
protected override void OnValidated(EventArgs e)
An EventArgs containing the event data.
Overrides:
Raises the ValueChanged event.
Raises the ValueChanging event.
protected virtual void OnValueChanging(ValueChangingEventArgs args)
A ValueChangingEventArgs containing the event data.
Increases or decreases the value in the numeric up/down control by the specified step value.
public void PerformStep(decimal step)
The value to add to or subtract from the current value.
Processes the AutoSize property when it changes.
protected override void ProcessAutoSizeChanged(bool value)
The new value of the AutoSize property.
Overrides:
Resets the BackColor theme overrides.
protected override void ResetBackColorThemeOverrides()
Overrides:
Resets the ForeColor theme overrides.
protected override void ResetForeColorThemeOverrides()
Overrides:
Sets the BackColor theme overrides.
protected override void SetBackColorThemeOverrides()
Overrides:
Sets the ForeColor theme overrides.
protected override void SetForeColorThemeOverrides()
Overrides:
Processes Windows messages.
protected override void WndProc(ref Message m)
The Windows Message to process.
Overrides:
Events
Occurs when the NullableValue of the RadSpinEditor is changed.
public event EventHandler NullableValueChanged
Occurs before the value of the RadSpinEditor is changed.
public event EventHandler ValueChanged
Occurs before the value of the RadSpinEditor is changing.
public event ValueChangingEventHandler ValueChanging