RemoveSelection(Int32,String) Method

Deselects the specified Cell.

Syntax

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

Public Overloads Sub RemoveSelection( _
   ByVal rowIndex As Integer, _
   ByVal cellName As String _
)

Dim instance As GcMultiRow
Dim rowIndex As Integer
Dim cellName As String
 
instance.RemoveSelection(rowIndex, cellName)

public void RemoveSelection( 
   int rowIndex,
   string cellName
)

Parameters

rowIndex: The row index of the cell.
cellName: The cell name of the cell.

Exceptions

Exception	Description
System.ArgumentOutOfRangeException	The rowIndex is less than 0 or greater than or equal to the RowCount property. -or- The cellName cannot be found.

Exception

Description

System.ArgumentOutOfRangeException

The rowIndex is less than 0 or greater than or equal to the RowCount property.

-or-

The cellName cannot be found.

Remarks

Initially, all cells and rows do not have an actual instance in the GcMultiRow control. When you get a cell or row's instance, the cell creates an instance. That policy saves memory and improves performance. A cell instance is created if you deselect a specific cell by setting the Cell.Selected property value to false. To avoid this state, call this method instead of setting the property directly. This method's function and setting the Cell.Selected property's value to false are the same.

Example

This example uses the RemoveSelection 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;
            gcMultiRow1.AddSelection(0);
            gcMultiRow1.AddSelection(1, 1);           
        }

        private void button1_Click(object sender, EventArgs e)
        {
        gcMultiRow1.RemoveSelection(0);
        gcMultiRow1.RemoveSelection(1, 1);
        //gcMultiRow1.RemoveSelection(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
        GcMultiRow1.AddSelection(0)
        GcMultiRow1.AddSelection(1, 1)
    End Sub

    Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click
        GcMultiRow1.RemoveSelection(0)
        GcMultiRow1.RemoveSelection(1, 1)
        'GcMultiRow1.RemoveSelection(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