Class DoubleTextBox

Extends the System.Windows.Forms.TextBox class to handle double input and validation.

Inheritance
System.Object
TextBoxExt
NumberTextBoxBase
NumericTextBox
DoubleTextBox
GridDoubleTextBox
Implements
System.ComponentModel.ISupportInitialize
System.Runtime.Serialization.ISerializable
Inherited Members
Namespace: Syncfusion.Windows.Forms.Tools
Assembly: Syncfusion.Shared.Base.dll
Syntax
public class DoubleTextBox : NumericTextBox, IThemeProvider, IVisualStyle, ISupportInitialize, ISerializable
Remarks

The DoubleTextBox is derived from textbox and provides all the functionality of a textbox and adds additional functionality of its own.

Collecting double input in a consistent format requires validation code that needs to be built into the application when using the Windows Forms text box control. The DoubleTextBox includes all this logic into its methods and properties and makes it easy for the developer and the end user to collect and enter double data.

The DoubleTextBox is also closely tied to the globalization settings of the operating system for number related properties. Please refer to the System.Globalization.NumberFormatInfo class for a detailed explanation of globalization and number related attributes.

The DoubleTextBox has full support for the Windows Forms designer and you can just drag-and-drop and set properties on the control just as you would with the Windows Forms text box.

The DoubleTextBox also raises a ValidationError event when in appropriate data is entered into the control.

All clipboard functions such as copy, paste and cut are also supported with special accommodations for number related issues.

Constructors

DoubleTextBox()

Overloaded. Creates an object of type DoubleTextBox.

Declaration
public DoubleTextBox()
Remarks

The DoubleTextBox object will be initialized with the default values for the display and data properties. You need to set any specific values.

Properties

AccessibilityEnabled

Gets or sets a value indicating whether the control should enable its Accessibility support.

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

DoubleValue

Gets or sets the double value of the control. This will be formatted and displayed.

Declaration
public double DoubleValue { get; set; }
Property Value
Type
System.Double

HideTrailingZeros

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

MaxValue

Gets or sets the maximum value that can be set through the DoubleTextBox.

Declaration
public double MaxValue { get; set; }
Property Value
Type
System.Double

MinValue

Gets or sets the minimum value that can be set through the DoubleTextBox.

Declaration
public double MinValue { get; set; }
Property Value
Type
System.Double

Text

Overrides the Text property of System.Windows.Forms.TextBox.

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

This property is overriden in order to normalize the data that is set to the Text property and format it as needed. The method is used to format the data.

ThemeStyle

Declaration
public DoubleTextBoxVisualStyle ThemeStyle { get; set; }
Property Value
Type
DoubleTextBoxVisualStyle

UseNullString

Indicates whether the NULLString property will be used.

Declaration
[Obsolete("This property will not be used in future.Insead Use AllowNull")]
public bool UseNullString { get; set; }
Property Value
Type
System.Boolean

Methods

ApplyFormatting(String)

Formats the given text according to the current setting.

Declaration
protected override string ApplyFormatting(string rawValue)
Parameters
Type Name Description
System.String rawValue
Returns
Type
System.String
Overrides

CheckForMinMax(String, Boolean)

Declaration
protected override bool CheckForMinMax(string currentTextValue, bool ignoreLength)
Parameters
Type Name Description
System.String currentTextValue
System.Boolean ignoreLength
Returns
Type
System.Boolean
Overrides

CheckIfNegative(String)

Declaration
protected override bool CheckIfNegative(string rawValue)
Parameters
Type Name Description
System.String rawValue
Returns
Type
System.Boolean
Overrides

CheckIsZero()

Declaration
protected override bool CheckIsZero()
Returns
Type
System.Boolean
Overrides

CheckNullStringIsInRange(String)

Declaration
protected override bool CheckNullStringIsInRange(string nullString)
Parameters
Type Name Description
System.String nullString
Returns
Type
System.Boolean
Overrides

CreateAccessibilityInstance()

Declaration
protected override AccessibleObject CreateAccessibilityInstance()
Returns
Type
System.Windows.Forms.AccessibleObject
Overrides

Dispose(Boolean)

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

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

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

FormatChanged(String, NumberFormatInfo)

Declaration
protected override void FormatChanged(string currentText, NumberFormatInfo previousFormat)
Parameters
Type Name Description
System.String currentText
System.Globalization.NumberFormatInfo previousFormat
Overrides

GetControlName(String)

Helps to override the ThemeName property settings

Declaration
public override string GetControlName(string controlName)
Parameters
Type Name Description
System.String controlName

ThemeName
Returns
Type
System.String
Overrides

GetNumberPartLength(Double)

Declaration
protected int GetNumberPartLength(double numberValue)
Parameters
Type Name Description
System.Double numberValue
Returns
Type
System.Int32

GetNumberValue(String, Int32)

Declaration
protected override string GetNumberValue(string formattedText, int startPosition)
Parameters
Type Name Description
System.String formattedText
System.Int32 startPosition
Returns
Type
System.String
Overrides

GetValue()

Declaration
protected override object GetValue()
Returns
Type
System.Object
Overrides

HandleBackspaceKey()

Declaration
protected override bool HandleBackspaceKey()
Returns
Type
System.Boolean
Overrides

HandleDecimalKey()

Declaration
protected override bool HandleDecimalKey()
Returns
Type
System.Boolean
Overrides

HandleDeleteKey()

Declaration
protected override bool HandleDeleteKey()
Returns
Type
System.Boolean
Overrides

HandleSubtractKey()

Declaration
protected override NumberModifyState HandleSubtractKey()
Returns
Type
NumberModifyState
Overrides

InitializeNumberTextBox()

Overrides InitializeNumberTextBox().

Declaration
protected override void InitializeNumberTextBox()
Overrides

IsAssignable(Object)

Declaration
protected override bool IsAssignable(object val)
Parameters
Type Name Description
System.Object val
Returns
Type
System.Boolean
Overrides

IsValidNumberValue(String)

Declaration
protected override bool IsValidNumberValue(string doubleString)
Parameters
Type Name Description
System.String doubleString
Returns
Type
System.Boolean
Overrides

OnDoubleValueChanged(EventArgs)

Raises the DoubleValueChanged event.

Declaration
protected virtual void OnDoubleValueChanged(EventArgs e)
Parameters
Type Name Description
System.EventArgs e

A System.EventArgs that contains the event data.

OnEnabledChanged(EventArgs)

Raises the System.Windows.Forms.Control.EnabledChanged event.

Declaration
protected override void OnEnabledChanged(EventArgs e)
Parameters
Type Name Description
System.EventArgs e

An System.EventArgs that contains the event data.
Overrides

OnEnter(EventArgs)

Overrides the System.Windows.Forms.Control.OnEnter(System.EventArgs) method.

Declaration
protected override void OnEnter(EventArgs args)
Parameters
Type Name Description
System.EventArgs args

The event data.
Overrides
Remarks

Saves the current DoubleValue so that it can be compared during validation. The DoubleValueChanged and TextChanged event will only be raised if the value is different during validation.

OnGotFocus(EventArgs)

Helps to override the OnGotFocus events

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

An System.EventArgs that contains the event data.
Overrides

OnKeyDown(KeyEventArgs)

Raises the System.Windows.Forms.Control.KeyDown event.

Declaration
protected override void OnKeyDown(KeyEventArgs e)
Parameters
Type Name Description
System.Windows.Forms.KeyEventArgs e

A System.Windows.Forms.KeyEventArgs that contains the event data.

OnLostFocus(EventArgs)

Declaration
protected override void OnLostFocus(EventArgs e)
Parameters
Type Name Description
System.EventArgs e
Overrides

OnTextChanged(EventArgs)

Overrides OnTextChanged.

Declaration
protected override void OnTextChanged(EventArgs e)
Parameters
Type Name Description
System.EventArgs e

The event data.
Overrides

OnThemeNameChanged(String)

Helps to apply the ThemeName settings in control

Declaration
public override void OnThemeNameChanged(string themeName)
Parameters
Type Name Description
System.String themeName

ThemeName
Overrides

OnValidated(EventArgs)

Declaration
protected override void OnValidated(EventArgs e)
Parameters
Type Name Description
System.EventArgs e

OnValidating(CancelEventArgs)

Declaration
protected override void OnValidating(CancelEventArgs e)
Parameters
Type Name Description
System.ComponentModel.CancelEventArgs e
Overrides

PrepareInsertString(String, Int32, Int32, String, Boolean)

Declaration
protected override NumberModifyState PrepareInsertString(string currentText, int startPosition, int selectionLength, string textToBeInserted, bool pasteOperation)
Parameters
Type Name Description
System.String currentText
System.Int32 startPosition
System.Int32 selectionLength
System.String textToBeInserted
System.Boolean pasteOperation
Returns
Type
NumberModifyState
Overrides

ResetText()

Restores the CurrencyNumberDigits to the MaximumLength.

Declaration
protected void ResetText()

SetDoubleValue(Double)

Declaration
protected void SetDoubleValue(double newValue)
Parameters
Type Name Description
System.Double newValue

SetNullNumberValue()

Declaration
protected override void SetNullNumberValue()
Overrides

SetTextProperty(String)

Declaration
protected override void SetTextProperty(string newText)
Parameters
Type Name Description
System.String newText
Overrides

SetValue(Object)

Declaration
protected override void SetValue(object val)
Parameters
Type Name Description
System.Object val
Overrides

ShouldSerializeText()

Indicates whether to serialize the Text property if it is null or quals NullString

Declaration
protected bool ShouldSerializeText()
Returns
Type
System.Boolean

ToggleNegative(String)

Declaration
protected override string ToggleNegative(string currentText)
Parameters
Type Name Description
System.String currentText
Returns
Type
System.String
Overrides

Events

DoubleValueChanged

Occurs when the DoubleValue property is changed.

Declaration
public event EventHandler DoubleValueChanged
Event Type
Type
System.EventHandler

Implements

System.ComponentModel.ISupportInitialize
System.Runtime.Serialization.ISerializable