CellStyleNotify Class

Represents a special AppearanceActionBase that displays the InvalidCellStyle on the validating Cell if the validation fails.

Object Model

Syntax

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

<ToolboxBitmapAttribute()>
<DefaultPropertyAttribute("InvalidCellStyle")>
Public Class CellStyleNotify 
   Inherits AppearanceActionBase
   Implements INamedObject

Dim instance As CellStyleNotify

[ToolboxBitmap()]
[DefaultProperty("InvalidCellStyle")]
public class CellStyleNotify : AppearanceActionBase, INamedObject

Remarks

Only properties that do not have an inherited value can affect the appearance when the action is executed.

The InvalidCellStyle property setting does not affect the cell's Style property value.

You should not set InvalidCellStyle properties that are not related to the cell's appearance.

Example

The following code example uses the PairCharValidator to validate whether the input string matches the char pair '( )'. When you enter edit mode and input 2*(3+4 , the right ')' does not match the left '('. The input text's 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.CellValidateAction
      GrapeCity.Win.MultiRow.AppearanceActionBase
         GrapeCity.Win.MultiRow.CellStyleNotify

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

CellStyleNotify Members
GrapeCity.Win.MultiRow Namespace
CellValidateAction Class