SelectTypeCell Property

Returns or sets a value that determines the cell selection type.

Syntax

Visual Basic

'Declaration
 
Public Property SelectTypeCell As SelectType

C#

public SelectType SelectTypeCell {get; set;}

Remarks

This property is used to specify which selection type will be used for the cells in the band or the grid controlled by the specified override. You can choose to allow the user to have multiple cells selected, only one cell at a time selected, or to disallow the selection of cells.

You can use the SelectTypeCol and SelectTypeRow properties to specify the way in which columns and rows may be selected.

Because you may want to enable different types of selection at different levels of a hierarchical record set, SelectTypeCell is a property of the UltraGridOverride object. This makes it easy to specify different selection options for each band by assigning each UltraGridBand object its own UltraGridOverride object. If a band does not have an override assigned to it, the control will use the override at the next higher level of the override hierarchy to determine the properties for that band. In other words, any band without an override will use its parent band's setting for SelectTypeCell, and the top-level band will use the grid's setting.

Example

Following code shows how to control cell-selection in the UltraGrid.

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid

  Private Sub Button49_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button49.Click

      ' Set the SelectTypeCell to Single so only a single cell can be selected at a
      ' time. Setting it on the layout's Override applies it to the whole grid.
      Me.UltraGrid1.DisplayLayout.Override.SelectTypeCell = SelectType.Single

      ' You can override grid-wide settings (settings on the layout's Override) on a 
      ' particular band by setting the associated properties on that band's Override. 
      ' Following code sets the SelectTypeCell on the band 0 override to allow the user
      ' to select multiple cells in that band.
      Me.UltraGrid1.DisplayLayout.Bands(0).Override.SelectTypeCell = SelectType.Extended

	' Set the MultiCellSelectionMode
   Me.ultraGrid1.DisplayLayout.Bands(0).Override.MultiCellSelectionMode = MultiCellSelectionMode.Snaking


      ' You can set the MaxSelectedCells to limit the number of cells the user can select.
      Me.UltraGrid1.DisplayLayout.Bands(0).Override.MaxSelectedCells = 100

     
  End Sub

C#

using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

private void button49_Click(object sender, System.EventArgs e)
{

	// Set the SelectTypeCell to Single so only a single cell can be selected at a
	// time. Setting it on the layout's Override applies it to the whole grid.
	this.ultraGrid1.DisplayLayout.Override.SelectTypeCell = SelectType.Single;

	// You can override grid-wide settings (settings on the layout's Override) on a 
	// particular band by setting the associated properties on that band's Override. 
	// Following code sets the SelectTypeCell on the band 0 override to allow the user
	// to select multiple cells in that band.
	this.ultraGrid1.DisplayLayout.Bands[0].Override.SelectTypeCell = SelectType.Extended;


	// Set the MultiCellSelectionMode
   this.ultraGrid1.DisplayLayout.Bands[0].Override.MultiCellSelectionMode = MultiCellSelectionMode.Snaking;

	// You can set the MaxSelectedCells to limit the number of cells the user can select.
	this.ultraGrid1.DisplayLayout.Bands[0].Override.MaxSelectedCells = 100;

}

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, 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