Activation Enumeration

Determines how the cell will behave when it is activated.

Syntax

Visual Basic

'Declaration
 
Public Enum Activation 
   Inherits System.Enum

C#

public enum Activation : System.Enum 

Members

Member	Description
ActivateOnly	Activate Only. The object may be selected (to copy and paste) but may not be edited.
AllowEdit	Allow Edit. The grid will attempt to edit the content of the object.
Disabled	Disabled. The object may not be activated and text may not be selected or edited.
NoEdit	No Edit. The object may be activated(text highlighted), but cells cannot be edited or selected(to copy and paste).

Remarks

This enum is used for specifying UltraGridColumn's UltraGridColumn.CellActivation, UltraGridRow's UltraGridRow.Activation and UltraGridCell's UltraGridCell.Activation properties.

Example

Following code sets various properties that control whether the user can modify data in the UltraGrid in various ways.

Visual Basic

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

  Private Sub Button31_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button31.Click

      ' There are three properties off the override that control whether modifying rows
      ' as well as adding and deleting rows are allowed. If you set these properties
      ' on the Override off the DisplayLayout, then these settings apply to the whole 
      ' UltraGrid.
      Me.ultraGrid1.DisplayLayout.Override.AllowUpdate = DefaultableBoolean.True
      Me.ultraGrid1.DisplayLayout.Override.AllowAddNew = AllowAddNew.No
      Me.ultraGrid1.DisplayLayout.Override.AllowDelete = DefaultableBoolean.False

      ' You can set them on a specific band as well. These settings override those
      ' set on the DisplayLayout's Override object for this band.
      Me.ultraGrid1.DisplayLayout.Bands(0).Override.AllowUpdate = DefaultableBoolean.True
      Me.ultraGrid1.DisplayLayout.Bands(0).Override.AllowAddNew = AllowAddNew.No
      Me.ultraGrid1.DisplayLayout.Bands(0).Override.AllowDelete = DefaultableBoolean.False

      ' There are Activation properties on row, column and cells that dictate whether 
      ' associated cells can be modified, or can even enter in edit mode.
      Dim column As UltraGridColumn = Me.ultraGrid1.DisplayLayout.Bands(0).Columns("CustomerID")
      Dim row As UltraGridRow = Me.ultraGrid1.Rows(0)

      ' Set the CellActivation off the column something other than AllowEdit to prevent
      ' the user from modifying cells in that column. ActivateOnly allows the user to 
      ' go into edit mode so the user can select and copy text, however the cell will
      ' be read-only thus preventing any data modification.
      column.CellActivation = Activation.ActivateOnly

      ' You can override cell activation setting for a particular row. 
      row.Activation = Activation.ActivateOnly

      ' Furthermore you can override activation on a cell as well.
      row.Cells(column).Activation = Activation.AllowEdit

  End Sub

C#

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

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

	// There are three properties off the override that control whether modifying rows
	// as well as adding and deleting rows are allowed. If you set these properties
	// on the Override off the DisplayLayout, then these settings apply to the whole 
	// UltraGrid.
	this.ultraGrid1.DisplayLayout.Override.AllowUpdate = DefaultableBoolean.True;
	this.ultraGrid1.DisplayLayout.Override.AllowAddNew = AllowAddNew.No;
	this.ultraGrid1.DisplayLayout.Override.AllowDelete = DefaultableBoolean.False;

	// You can set them on a specific band as well. These settings override those
	// set on the DisplayLayout's Override object for this band.
	this.ultraGrid1.DisplayLayout.Bands[0].Override.AllowUpdate = DefaultableBoolean.True;
	this.ultraGrid1.DisplayLayout.Bands[0].Override.AllowAddNew = AllowAddNew.No;
	this.ultraGrid1.DisplayLayout.Bands[0].Override.AllowDelete = DefaultableBoolean.False;
	
	// There are Activation properties on row, column and cells that dictate whether 
	// associated cells can be modified, or can even enter in edit mode.
	UltraGridColumn column	= this.ultraGrid1.DisplayLayout.Bands[0].Columns["CustomerID"];
	UltraGridRow	row		= this.ultraGrid1.Rows[0];

	// Set the CellActivation off the column something other than AllowEdit to prevent
	// the user from modifying cells in that column. ActivateOnly allows the user to 
	// go into edit mode so the user can select and copy text, however the cell will
	// be read-only thus preventing any data modification.
	column.CellActivation = Activation.ActivateOnly;
	
	// You can override cell activation setting for a particular row. 
	row.Activation = Activation.ActivateOnly;

	// Furthermore you can override activation on a cell as well.
	row.Cells[column].Activation = Activation.AllowEdit;

}

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