InvalidateCell(Cell) Method

Invalidates the specified cell of the GcMultiRow control, forcing it to repaint.

Syntax

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

Public Overloads Sub InvalidateCell( _
   ByVal cell As Cell _
)

Dim instance As GcMultiRow
Dim cell As Cell
 
instance.InvalidateCell(cell)

public void InvalidateCell( 
   Cell cell
)

Parameters

cell: The Cell to invalidate.

Exceptions

Exception	Description
System.ArgumentNullException	The cell is a null reference (Nothing in Visual Basic).
System.ArgumentException	The cell already belongs to another GcMultiRow control.

Remarks

This method is useful for forcing a cell to repaint in conditions that would not normally cause a repaint. For example, you can use this method with a custom cell type that changes its appearance as a result of external events.

Example

This example uses the InvalidateCell method.

private void Form1_Load(object sender, EventArgs e)
        {
            GrapeCity.Win.MultiRow.TextBoxCell text1 = new GrapeCity.Win.MultiRow.TextBoxCell();
            GrapeCity.Win.MultiRow.TextBoxCell text2 = new GrapeCity.Win.MultiRow.TextBoxCell();
            text1.Name = "text1";
            text2.Name = "text2";
            text2.Style.Format = "c";
            GrapeCity.Win.MultiRow.Template template1 = GrapeCity.Win.MultiRow.Template.CreateGridTemplate(new GrapeCity.Win.MultiRow.Cell[] { text1, text2 }, 160, GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.ColumnHeader | GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.RowHeaderAutoNumber);
            template1.ColumnHeaders[0].Cells[0].Value = "Column1";
            template1.ColumnHeaders[0].Cells[1].Value = "Column2";
            gcMultiRow1.Template = template1;
            gcMultiRow1.RowCount = 3;
            gcMultiRow1[1, 1].Value = 5;
        }

        private void button1_Click(object sender, EventArgs e)
        {
            //gcMultiRow1.InvalidateCell(gcMultiRow1[1, 1]);
            //gcMultiRow1.InvalidateCell(0, 0);
            gcMultiRow1.InvalidateCell(1, "text2");
        }

VB.NET

Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load
        Dim text1 As New GrapeCity.Win.MultiRow.TextBoxCell()
        Dim text2 As New GrapeCity.Win.MultiRow.TextBoxCell()
        text1.Name = "text1"
        text2.Name = "text2"
        text2.Style.Format = "c"
        Dim template1 As GrapeCity.Win.MultiRow.Template = GrapeCity.Win.MultiRow.Template.CreateGridTemplate(New GrapeCity.Win.MultiRow.Cell() {text1, text2}, 160, GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.ColumnHeader Or GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.RowHeaderAutoNumber)
        template1.ColumnHeaders(0).Cells(0).Value = "Column1"
        template1.ColumnHeaders(0).Cells(1).Value = "Column2"
        GcMultiRow1.Template = template1
        GcMultiRow1.RowCount = 3
        GcMultiRow1(1, 1).Value = 5
End Sub

Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click
        'GcMultiRow1.InvalidateCell(GcMultiRow1(1, 1))
        'GcMultiRow1.InvalidateCell(0, 0)
        GcMultiRow1.InvalidateCell(1, "text2")
End Sub

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

GcMultiRow Class
GcMultiRow Members
Overload List