Infragistics(R) NetAdvantage(R) Windows Forms
Activation Enumeration
Example  See Also  E-mail your feedback on this topic.
Infragistics.Win.UltraWinGrid Namespace : 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

MemberDescription
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).

Example

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

Visual BasicCopy Code
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#Copy Code
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;

}

Remarks

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

See Also