Spread Windows Forms 6.0 Product Documentation
NullColor Property
See Also  Example Support Options
FarPoint.Win Assembly > FarPoint.Win Namespace > SuperEditBase Class : NullColor Property


Glossary Item Box

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

Syntax

Visual Basic (Declaration) 
Public Overridable Property NullColor As Color
Visual Basic (Usage)Copy Code
Dim instance As SuperEditBase
Dim value As Color
 
instance.NullColor = value
 
value = instance.NullColor
C# 
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

C#Copy Code
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 BasicCopy Code
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 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

See Also

© 2002-2012 ComponentOne, a division of GrapeCity. All Rights Reserved.