Formatting C1InputPanel's Error Frame

The C1InputPanel component features an error frame that provides a visual alert to the user when an invalid value is entered in any of the input panel components. In this topic, you will learn how to format the error frame.

The ErrorFrameColor property is used to set the color of the error frame, and the ErrorFrameThickness property is used to set the thickness of the error frame. The default color is red, and the default width is 2.

To customize the C1InputPanel’s error frame:

Formatting the Error Frame Using the Designer

To format the error frame, complete these steps:

Click C1InputPanel's smart tag (), click the Add New Item dropdown arrow, and select InputNumericBox, from the list of items.
From the Properties window, select the C1InputPanel control and edit the ErrorFrameColor property to a desired color. For this example, select Chartreuse.

Edit the ErrorFrameThickness to a desired size. For this example, enter 10.

Note: To see the whole ErrorFrame when the program runs, you might need to increase the padding of the InputNumericBox. For more information, see Arranging Input Components Using Padding.

Build the project.
In the InputNumericBox, enter a number greater than 100 and press ENTER on your keyboard. The number must be greater than 100 because the default maximum value for the InputNumericBox component is 100. Edit the C1InputPanelvalue to change this setting.
Notice the thick, chartreuse-colored border around the InputNumericBox; this indicates an error by the end-user.

Formatting the Error Frame Programmatically

To format the error frame, complete these steps:

Import the following namespace into your project:

To write code in Visual Basic

Visual Basic	Copy Code
Imports C1.Win.C1InputPanel

To write code in C#

C#	Copy Code
using C1.Win.C1InputPanel;

Place the InputPanel control and the InputNumericBox component on your form by adding the following code to the Form_Load event.

To write code in Visual Basic

Visual Basic	Copy Code
Dim NewPanel As New C1InputPanel Controls.Add(NewPanel) Dim NewNumericBox As InputNumericBox = New InputNumericBox X.Items.Add(NewNumericBox)

To write code in C#

C#	Copy Code
C1InputPanel NewPanel = new C1InputPanel(); Controls.Add(NewPanel); InputNumericBox NewNumericBox = new InputNumericBox(); X.Items.Add(NewNumericBox);

To change the color of the error frame, add the following code beneath the last line of code that created to the C1InputPanel control. For this example, we'll change the color to Chartreuse.

To write code in Visual Basic

Visual Basic	Copy Code
NewPanel.ErrorFrameColor = Color.Chartreuse

To write code in C#

C#	Copy Code
NewPanel.ErrorFrameColor = Color.Chartreuse;

To change the size of the error frame, add the following code beneath the last line of code that created to the C1InputPanel control. For this example, we'll change the size to 10.

To write code in Visual Basic

Visual Basic	Copy Code
NewPanel.ErrorFrameThickness = 10;

To write code in C#

C#	Copy Code
NewPanel.ErrorFrameThickness = 10;

Note: To see the whole ErrorFrame when the program runs, you might need to increase the padding around the InputNumericBox. For more information, see Arranging Input Components Using Padding.

Run the program.
In the InputNumericBox, enter a number greater than 100 and press ENTER on your keyboard. The number must be greater than 100 because the default maximum value for the InputNumericBox component is 100. Edit the C1InputPanel.InputNumericBox.Maximumvalue to change this setting.
Notice the thick, fuchsia-colored border around the InputNumericBox; this indicates an error by the end-user.