Version

Spinning through a list of values in WebPercentEditor

WebPercentEditor™ provides the option to spin through a list of values using spin buttons. You can display the spin buttons by setting the SpinButtonsDisplay property to either OnRight or OnLeft. By default, this property is set to None. The spin buttons have two buttons: lower and upper so that your end users can move to the next and previous values. You can customize the lower and upper buttons by setting the LowerSpinButton and UpperSpinButton properties respectively.

You can set the SpinButtonsDisplay property either using Microsoft® Visual Studio® Property Window or by using the following code:

In Visual Basic:

'Displays the spin buttons on the right
WebPercentEditor1.Buttons.SpinButtonsDisplay = Infragistics.Web.UI.EditorControls.ButtonDisplay.OnRight

In C#:

//Displays the spin buttons on the right
WebPercentEditor1.Buttons.SpinButtonsDisplay = Infragistics.Web.UI.EditorControls.ButtonDisplay.OnRight;

WebPercentEditor also allows you to spin through the list continuously even if it reaches the first or last value in the list by setting the SpinWrap property to True.

Add and Insert Values into the list:

WebPercentEditor allows you to add a list of values that you want to iterate through using the TextEditorButtons object’s ListOfValues property. You can set the ListOfValues property either using Microsoft® Visual Studio® Property Window or by using the following code:

In Visual Basic:

WebPercentEditor1.Buttons.ListOfValues = "10.1|20.2|30.3|40.4|50.5"

In C#:

WebPercentEditor1.Buttons.ListOfValues = "10.1|20.2|30.3|40.4|50.5";
Note
Note:

Items in the list must be separated by the "|" character when using the ListOfValues property.

However you can also insert values into the list using the TextEditorButtons object’s InsertListValueAtIndex method.

In Visual Basic:

'Insert the values into the list at a particular index
WebPercentEditor1.Buttons.InsertListValueAtIndex(0, "10.1")
WebPercentEditor1.Buttons.InsertListValueAtIndex(1, "20.2")
WebPercentEditor1.Buttons.InsertListValueAtIndex(2, "30.3")
WebPercentEditor1.Buttons.InsertListValueAtIndex(3, "40.4")
WebPercentEditor1.Buttons.InsertListValueAtIndex(4, "50.5")

In C#:

//Insert the values into the list at a particular index
WebPercentEditor1.Buttons.InsertListValueAtIndex(0, "10.1");
WebPercentEditor1.Buttons.InsertListValueAtIndex(1, "20.2");
WebPercentEditor1.Buttons.InsertListValueAtIndex(2, "30.3");
WebPercentEditor1.Buttons.InsertListValueAtIndex(3, "40.4");
WebPercentEditor1.Buttons.InsertListValueAtIndex(4, "50.5");

Increment/Decrement the editing value:

WebPercentEditor also allows you to increment/decrement the editing value using the spin buttons. You can set the increment/decrement factor by simply setting the SpinDelta property. For instance, if you set the SpinDelta property to 10 then clicking the upper button increases the value by 10. Similarly clicking the lower button decreases the value by 10.

You can set the SpinDelta property either using Microsoft® Visual Studio® Property Window or by using the following code:

In Visual Basic:

WebPercentEditor1.SpinDelta = 10

In C#:

WebPercentEditor1.SpinDelta = 10;
Note
Note:

The ListOfValues property has higher priority than the SpinDelta property.