NullText Property (UltraNumericEditor)

Returns or sets the text to be used by the control when the value is null.

Syntax

Visual Basic

'Declaration
 
Public Property NullText As String

C#

public string NullText {get; set;}

Remarks

When the control's value is null (Nothing in VB), the control displays an empty string by default. The NullText property enables the end developer to change the text that is displayed for null values (for example, '(NULL)' or '(none)').

Note: The UltraNumericEditor control displays a mask when in edit mode, and as such does not display the value of the NullText property when in edit mode.

Example

This sample sets the Min and Max values of the numeric editor as well as the initial value in the forms load event. It also sets the corresponding properties to allow the text to be nullable. At which point the string "empty" will appear in the text portion. It sets the input mask, and the type to double.

Visual Basic

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load

Me.UltraCurrencyEditor1.MaxValue = 10000
Me.UltraCurrencyEditor1.MinValue = 0
Me.UltraCurrencyEditor1.Value = 500
Me.UltraNumericEditor1.Nullable = True 
Me.UltraNumericEditor1.NullText = "empty"
Me.UltraNumericEditor1.MaskInput = "####"
Me.UltraNumericEditor1.NumericType = Infragistics.Win.UltraWinEditors.NumericType.Double

 End Sub

C#

private void Form1_Load(object sender, System.EventArgs e)
  {

	this.UltraCurrencyEditor1.MaxValue = 10000;
	this.UltraCurrencyEditor1.MinValue = 0;
	this.UltraCurrencyEditor1.Value = 500;
	this.UltraNumericEditor1.Nullable = true ;
	this.UltraNumericEditor1.NullText = "empty";
	this.UltraNumericEditor1.MaskInput = "####";
	this.UltraNumericEditor1.NumericType = Infragistics.Win.UltraWinEditors.NumericType.Double;

}

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2