Spread Windows Forms 12.0 Product Documentation
Using a Surrogate Character Validator
Spread Windows Forms 12.0 Product Documentation > Developer's Guide > Customizing Interaction in Cells > Using Validation in Cells > Using a Surrogate Character Validator

You can create a validator that checks if surrogate characters have been entered in the cell

A validation error occurs if the value is not valid. You can also create an action, such as adding a backcolor to the cell, that lets the user know the value is invalid.

Use the SurrogateCharValidator class to create the validator. Specify a notification type such as CellStyleNotify. Then use the AddValidators method to add the validator to a cell range.

Using Code

The following example uses the surrogate character validator.

Copy Code
FarPoint.Win.Spread.CellStyleNotify cnotify = new FarPoint.Win.Spread.CellStyleNotify();
cnotify.InvalidCellStyle.BackColor = Color.Aqua;
FarPoint.Win.Spread.SurrogateCharValidator surchar = new FarPoint.Win.Spread.SurrogateCharValidator();
fpSpread1.Sheets[0].AddValidators(new FarPoint.Win.Spread.Model.CellRange(1, 1, 1, 1), surchar);
fpSpread1.Sheets[0].Cells[1, 1].Value = "In the game of mahjong \U0001F01C denotes the Four of circles";
Copy Code
Dim cnotify As New FarPoint.Win.Spread.CellStyleNotify()
cnotify.InvalidCellStyle.BackColor = Color.Aqua
Dim surchar As New FarPoint.Win.Spread.SurrogateCharValidator()
fpSpread1.Sheets(0).AddValidators(New FarPoint.Win.Spread.Model.CellRange(1, 1, 1, 1), surchar)
fpSpread1.Sheets(0).Cells(1, 1).Text = "In the game of mahjong" + Char.ConvertFromUtf32(&H1F01C) + "denotes the Four Of circles"