Class RadNumericUpDown

Represents a RadNumericUpDown control.

Inheritance
System.Object
RadRangeBase
RadNumericUpDown
RadUpDown
LineNumberingDistanceNumericUpDown
Inherited Members
Namespace: Telerik.Windows.Controls
Assembly: Telerik.Windows.Controls.Input.dll

Syntax

[TelerikToolboxCategory("Input")]
[Themable]
public class RadNumericUpDown : RadRangeBase, IThemable

Constructors

RadNumericUpDown()

Initializes a new instance of the RadNumericUpDown class.

Declaration
public RadNumericUpDown()

Fields

AreButtonsTabStopsProperty

Identifies the AreButtonsTabStops dependency property.

Declaration
public static readonly DependencyProperty AreButtonsTabStopsProperty
Field Value
System.Windows.DependencyProperty

CustomUnitProperty

Identifies the CustomUnit dependency property.

Declaration
public static readonly DependencyProperty CustomUnitProperty
Field Value
System.Windows.DependencyProperty

DecreaseButtonContentTemplateProperty

Identifies the IncreaseButtonContentTemplate dependency property.

Declaration
[Obsolete("This is property is not used with the current implementation of RadNumericUpDown and will be deleted in the next official release.")]
public static readonly DependencyProperty DecreaseButtonContentTemplateProperty
Field Value
System.Windows.DependencyProperty

HideTrailingZerosProperty

Identifies the HideTrailingZeros dependency property.

Declaration
public static readonly DependencyProperty HideTrailingZerosProperty
Field Value
System.Windows.DependencyProperty

IncreaseButtonContentTemplateProperty

Identifies the IncreaseButtonContentTemplate dependency property.

Declaration
[Obsolete("This is property is not used with the current implementation of RadNumericUpDown and will be deleted in the next official release.")]
public static readonly DependencyProperty IncreaseButtonContentTemplateProperty
Field Value
System.Windows.DependencyProperty

IsEditableProperty

Identifies the IsEditable dependency property.

Declaration
public static readonly DependencyProperty IsEditableProperty
Field Value
System.Windows.DependencyProperty

IsHighlightedProperty

Gets or sets a value indicating whether this instance is highlighted.

Declaration
public static readonly DependencyProperty IsHighlightedProperty
Field Value
System.Windows.DependencyProperty

IsIntegerProperty

Identifies the IsInteger dependency property.

Declaration
public static readonly DependencyProperty IsIntegerProperty
Field Value
System.Windows.DependencyProperty

IsReadOnlyProperty

Identifies the IsReadOnly dependency property.

Declaration
public static readonly DependencyProperty IsReadOnlyProperty
Field Value
System.Windows.DependencyProperty

NullValueProperty

Identifies the NullValue dependency property.

Declaration
public static readonly DependencyProperty NullValueProperty
Field Value
System.Windows.DependencyProperty

NumberDecimalDigitsProperty

Identifies the NumberDecimalDigits dependency property.

Declaration
public static readonly DependencyProperty NumberDecimalDigitsProperty
Field Value
System.Windows.DependencyProperty

NumberDecimalSeparatorProperty

Identifies the NumberDecimalSeparator dependency property.

Declaration
public static readonly DependencyProperty NumberDecimalSeparatorProperty
Field Value
System.Windows.DependencyProperty

NumberFormatInfoProperty

Identifies the NumberFormatInfo dependency property.

Declaration
public static readonly DependencyProperty NumberFormatInfoProperty
Field Value
System.Windows.DependencyProperty

ShowButtonsProperty

Identifies the ShowButtons dependency property.

Declaration
public static readonly DependencyProperty ShowButtonsProperty
Field Value
System.Windows.DependencyProperty

ShowTextBoxProperty

Identifies the ShowTextBox dependency property.

Declaration
public static readonly DependencyProperty ShowTextBoxProperty
Field Value
System.Windows.DependencyProperty

UpdateValueEventProperty

Identifies the UpdateValueEvent dependency property.

Declaration
public static readonly DependencyProperty UpdateValueEventProperty
Field Value
System.Windows.DependencyProperty

UpdateValueToMatchTextOnLostFocusProperty

Identifies the UpdateValueToMatchTextOnLostFocusProperty dependency property.

Declaration
public static readonly DependencyProperty UpdateValueToMatchTextOnLostFocusProperty
Field Value
System.Windows.DependencyProperty

ValueFormatProperty

Identifies the ValueFormat dependency property.

Declaration
public static readonly DependencyProperty ValueFormatProperty
Field Value
System.Windows.DependencyProperty

Properties

AreButtonsTabStops

Read only property identifies if the increase / decrease buttons should be tab stops. Set to true when the ShowTextBox is set to false. This is a dependency property.

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

ContentText

Gets the current text content held by the textbox. This is a dependency property.

Declaration
public string ContentText { get; }
Property Value
System.String

CustomUnit

Gets or sets additional string to appear in the end of numeric values. This is a dependency property.

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

DecreaseButtonContentTemplate

Gets or sets the data template of the DecreaseButton. This is a dependency property.

Declaration
[Obsolete("This is property is not used with the current implementation of RadNumericUpDown and will be deleted in the next official release.")]
public DataTemplate DecreaseButtonContentTemplate { get; set; }
Property Value
System.Windows.DataTemplate

HideTrailingZeros

Gets or sets whether the trailing zeros should be displayed or not. This is a dependency property.

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

IncreaseButtonContentTemplate

Gets or sets the data template of the IncreaseButton. This is a dependency property.

Declaration
[Obsolete("This is property is not used with the current implementation of RadNumericUpDown and will be deleted in the next official release.")]
public DataTemplate IncreaseButtonContentTemplate { get; set; }
Property Value
System.Windows.DataTemplate

IsEditable

Gets or sets the value indicating whether the control is editable or not. This is a dependency property.

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

IsHighlighted

Gets or sets a value indicating whether this control is highlighted.

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

IsInteger

Gets or sets a value indicating whether the format is integer.

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

IsReadOnly

Gets or sets the value indicating whether the control is readonly or not. This is a dependency property.

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

NullValue

Gets or sets string that is displayed when the Value is null.

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

The null value.

NumberDecimalDigits

Gets or sets the number of decimal digits that will be displayed in the control.

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

NumberDecimalSeparator

Gets or sets NumberDecimalSeparator string to be used. This is a dependency property.

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

NumberFormatInfo

Gets or sets the NumberFormatInfo value, for more info see ValueFormat. This is a dependency property.

Declaration
public NumberFormatInfo NumberFormatInfo { get; set; }
Property Value
System.Globalization.NumberFormatInfo

ShowButtons

Gets or sets the ShowButtons property that indicates whether the up and down buttons are visible.

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

ShowTextBox

Gets or sets a value indicating whether the textbox of RadNumericUpDown is visible.

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

UpdateValueEvent

Gets or sets the way the Value property is updated. This is a dependency property.

Declaration
public UpdateValueEvent UpdateValueEvent { get; set; }
Property Value
UpdateValueEvent

UpdateValueToMatchTextOnLostFocus

Gets or sets whether to update the Value property to match the current formatted text on LostFocus. This is a dependency property.

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

ValueFormat

Gets or sets the current value format. This is a dependency property.

Declaration
public ValueFormat ValueFormat { get; set; }
Property Value
ValueFormat

Methods

ChangeValue(Double)

Adds the provided delta to the current value.

Declaration
protected override void ChangeValue(double delta)
Parameters
System.Double delta

The amount to add to Value.
Overrides

FormatDisplay()

Formats the display value when the control is not focused.

Declaration
public virtual string FormatDisplay()
Returns
System.String

Returns value that is displayed when the control doesn't have focus.

FormatEdit()

Formats the value when the control is in focus and the user is editing the content.

Declaration
public virtual string FormatEdit()
Returns
System.String

Return the value when the control is in focus and the user is editing the content.

OnApplyTemplate()

Overrides OnApplyTemplate and attach all necessary events to the controls. TODO: change the binding to TemplateBinding.

Declaration
public override void OnApplyTemplate()

OnCreateAutomationPeer()

Returns class-specific AutomationPeer implementations for the Windows Presentation Foundation (WPF) infrastructure.

Declaration
protected override AutomationPeer OnCreateAutomationPeer()
Returns
System.Windows.Automation.Peers.AutomationPeer

OnGotFocus(RoutedEventArgs)

Called before the System.Windows.UIElement.GotFocus event occurs.

Declaration
protected override void OnGotFocus(RoutedEventArgs e)
Parameters
System.Windows.RoutedEventArgs e

The data for the event.

OnInitialized(EventArgs)

Raises the System.Windows.FrameworkElement.Initialized event. This method is invoked whenever System.Windows.FrameworkElement.IsInitialized is set to true internally.

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

The System.Windows.RoutedEventArgs that contains the event data.

OnIsKeyboardFocusWithinChanged(DependencyPropertyChangedEventArgs)

Invoked just before the System.Windows.UIElement.IsKeyboardFocusWithinChanged event is raised by this element. Implement this method to add class handling for this event.

Declaration
protected override void OnIsKeyboardFocusWithinChanged(DependencyPropertyChangedEventArgs e)
Parameters
System.Windows.DependencyPropertyChangedEventArgs e

A System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

OnKeyDown(Object, KeyEventArgs)

Called before the System.Windows.UIElement.KeyDown event occurs.

Declaration
protected void OnKeyDown(object sender, KeyEventArgs e)
Parameters
System.Object sender

The sender of the event.
System.Windows.Input.KeyEventArgs e

The data for the event.

OnLostFocus(RoutedEventArgs)

Called before the System.Windows.UIElement.LostFocus event occurs.

Declaration
protected override void OnLostFocus(RoutedEventArgs e)
Parameters
System.Windows.RoutedEventArgs e

The data for the event.

OnMouseEnter(MouseEventArgs)

Called before the System.Windows.UIElement.MouseEnter event occurs.

Declaration
protected override void OnMouseEnter(MouseEventArgs e)
Parameters
System.Windows.Input.MouseEventArgs e

The data for the event.

OnMouseLeave(MouseEventArgs)

Called before the System.Windows.UIElement.MouseLeave event occurs.

Declaration
protected override void OnMouseLeave(MouseEventArgs e)
Parameters
System.Windows.Input.MouseEventArgs e

The data for the event.

OnMouseLeftButtonDown(MouseButtonEventArgs)

Called before the MouseLeftButtonDown event occurs.

Declaration
protected override void OnMouseLeftButtonDown(MouseButtonEventArgs e)
Parameters
System.Windows.Input.MouseButtonEventArgs e

OnMouseWheel(MouseWheelEventArgs)

Invoked when an unhandled System.Windows.Input.Mouse.MouseWheel attached event reaches an element in its route that is derived from this class. Implement this method to add class handling for this event.

Declaration
protected override void OnMouseWheel(MouseWheelEventArgs e)
Parameters
System.Windows.Input.MouseWheelEventArgs e

The System.Windows.Input.MouseWheelEventArgs that contains the event data.

OnValueChanged(RadRangeBaseValueChangedEventArgs)

Raises the ValueChanged event.

Declaration
protected override void OnValueChanged(RadRangeBaseValueChangedEventArgs e)
Parameters
RadRangeBaseValueChangedEventArgs e

The RadRangeBaseValueChangedEventArgs instance containing the event data.
Overrides

Select(Int32, Int32)

Selects a range of text in the RadNumericUpDown textbox.

Declaration
public void Select(int start, int length)
Parameters
System.Int32 start

The zero based start.
System.Int32 length

The length of the selection.

SelectAll()

Selects the entire content of RadNumericUpDown textbox.

Declaration
public void SelectAll()

Extension Methods