Using a Surrogate Character Validator

In This Topic

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.

CS	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(); surchar.Actions.Add(cnotify); 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

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();
                surchar.Actions.Add(cnotify);
                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";

VB	Copy Code
Dim cnotify As New FarPoint.Win.Spread.CellStyleNotify() cnotify.InvalidCellStyle.BackColor = Color.Aqua Dim surchar As New FarPoint.Win.Spread.SurrogateCharValidator() surchar.Actions.Add(cnotify) 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"

Copy Code

Dim cnotify As New FarPoint.Win.Spread.CellStyleNotify()
                cnotify.InvalidCellStyle.BackColor = Color.Aqua
                Dim surchar As New FarPoint.Win.Spread.SurrogateCharValidator()
                surchar.Actions.Add(cnotify)
                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"