NullColor Property

Gets or sets the background color displayed when the control contains the null value.

Syntax

Visual Basic
C#

'Declaration
 
Public Overridable Property NullColor As Color

'Usage
 
Dim instance As SuperEditBase
Dim value As Color
 
instance.NullColor = value
 
value = instance.NullColor

public virtual Color NullColor {get; set;}

Property Value

Color object containing the background color of the edit control

Remarks

This property indicates to the user that the control contains the null value. The background color of the control changes to the specified color when the control loses the focus.

When the AllowNull property is set to true, the control accepts null values, and the user can provide a null value in the following ways:

Press F2.
Delete the contents of the control.
Call the SetNull method.
Call the ClearAll method.
Select the contents of the control and call the Clear method.

This property is available from the SuperEditBase class.

The AllowNull property must be set to true for the NullColor property to work correctly.

You can return whether a control contains the null value by calling the IsNull method.

Example

private void Form1_Load(object sender, System.EventArgs e)
{
   control.NullColor = Color.Coral;
   control.AllowNull = true;
   control.CausesValidation = true;
   control.Text = "";
}

private void button1_Click(object sender, System.EventArgs e)
{
   control.ResetNullColor();
}

Visual Basic

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
   control.NullColor = Color.Coral
   control.AllowNull = True
   control.CausesValidation = True
   control.Text = ""
End Sub

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
   control.ResetNullColor()
End Sub

Requirements

Target Platforms: Windows 2000 Professional (SP4), Windows 2000 Server, Windows 2003 Server (SP1), Windows Server 2012 R2, Windows 2008, Windows XP (SP2), Windows Vista, Windows 7, Windows 8, Windows 8.1, Windows 10

Reference

SuperEditBase Class
SuperEditBase Members
AllowNull Property
IsNull Method
SetNull Method