PairChar Class

Represents a character pair.

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#

<TypeConverterAttribute("GrapeCity.Win.MultiRow.PairCharTypeConverter, GrapeCity.Win.MultiRow, Version=7.20.20141.0, Culture=neutral, PublicKeyToken=0f7a722ee3c2bdd9")>
Public Class PairChar

Dim instance As PairChar

[TypeConverter("GrapeCity.Win.MultiRow.PairCharTypeConverter, GrapeCity.Win.MultiRow, Version=7.20.20141.0, Culture=neutral, PublicKeyToken=0f7a722ee3c2bdd9")]
public class PairChar

Remarks

The PairChar describes a character pair, for example, pair brackets "( )". This PairChar's Left is "(", and Right is ")".

Example

The following code example uses the PairCharValidator to validate whether the input string matches the character pair '( )'. If you enter edit mode and input 2*(3+4, the right ')' does not match the left '(', and the input text font changes to a bold red color to notify you the validation failed. This example is part of a larger example available for the CellValidator class.

void setPairCharValidator_Click(object sender, EventArgs e)
        {
            Template template = Template.CreateGridTemplate(1);

            PairCharValidator pairCharValidator = new PairCharValidator();
            pairCharValidator.PairChars.Add(new PairChar('(', ')'));

            CellStyleNotify cellStyleNotify = new CellStyleNotify();
            cellStyleNotify.InvalidCellStyle.ForeColor = Color.Red;
            cellStyleNotify.InvalidCellStyle.Font = new Font(DefaultFont, FontStyle.Bold);
            cellStyleNotify.DoActionReason = ValidateReasons.EditedFormattedValueChanged;

            pairCharValidator.Actions.Add(cellStyleNotify);

            template.Row.Cells[0].Validators.Add(pairCharValidator);

            this.gcMultiRow1.Template = template;
            label.Text = "The PairCharValidator.PairChars is '( )', in edit mode, if you input '2*(3+4' to trigger validation, 
validation fails, the font changes, if input '2*(3+4)' to trigger validation, the validation succeeds.";
        }

VB.NET

Private Sub setPairCharValidator_Click(ByVal sender As Object, ByVal e As EventArgs) Handles 
setPairCharValidator.Click
        Dim template As Template = template.CreateGridTemplate(1)

        Dim pairCharValidator As New PairCharValidator()
        pairCharValidator.PairChars.Add(New PairChar("("c, ")"c))

        Dim cellStyleNotify As New CellStyleNotify()
        cellStyleNotify.InvalidCellStyle.ForeColor = Color.Red
        cellStyleNotify.InvalidCellStyle.Font = New Font(DefaultFont, FontStyle.Bold)
        cellStyleNotify.DoActionReason = ValidateReasons.EditedFormattedValueChanged

        pairCharValidator.Actions.Add(cellStyleNotify)

        template.Row.Cells(0).Validators.Add(pairCharValidator)

        Me.gcMultiRow1.Template = template
        label.Text = "The PairCharValidator.PairChars is '( )', in edit mode, if you input '2*(3+4' to trigger validation, 
validation fails, the font is changed, if input '2*(3+4)' to trigger validation, the validation succeeds."
    End Sub

Inheritance Hierarchy

System.Object
GrapeCity.Win.MultiRow.PairChar

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

Reference

PairChar Members
GrapeCity.Win.MultiRow Namespace
PairCharValidator Class