Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version 24.2 (latest)

AllowCellEdit Property (UltraTreeColumnSettings)

Gets/sets whether cells can be activated and/or edited.
Syntax
public AllowCellEdit AllowCellEdit {get; set;}
Remarks

The AllowCellEdit property is exposed by each of the column-related objects (UltraTreeNodeColumn, UltraTreeColumnSet, and UltraTreeColumnSettings), and the UltraTreeNodeCell object exposes an AllowEdit property, which is named differently but functionally identical. The AllowCellEdit property of the UltraTreeColumnSettings object is the least specific of all the levels, that is, applies to the most cells.

Cells can be disabled by setting the AllowCellEdit property to 'Disabled'.

The end user can be prevented from changing a cell's contents, while still being allowed to copy the cell's contents, by setting the AllowCellEdit property to 'ReadOnly'.

The AllowCellEdit property does not, by itself, determine the behavior exhibited when a cell is clicked with the mouse; the CellClickAction property also determines whether a cell can be activated and/or edited when it is clicked with the mouse.

Example
The following code samples demonstrates how to use the cell editing related properties of the UltraTreeColumnSettings object to configure the cell editing functionality for all cells in the UltraTree:

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinTree

    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
        '	Use the ActiveCellAppearance to bring attention to the cell
        '	with the input focus
        Me.ultraTree1.ColumnSettings.ActiveCellAppearance.BackColor = Color.Red
        Me.ultraTree1.ColumnSettings.ActiveCellAppearance.ForeColor = Color.White

        '	Set AllowCellEdit to 'ActivateOnly' so that clicking a cell does
        '	not put in into edit mode immediately
        Me.ultraTree1.ColumnSettings.AllowCellEdit = AllowCellEdit.ActivateOnly

        '	Set TabNavigation to 'NextCell' so that the tab key can be used to
        '	navigate to a cell
        Me.ultraTree1.ColumnSettings.TabNavigation = TabNavigation.NextCell

        '	Enable tooltips for cells whose value is not fully visible
        Me.ultraTree1.ColumnSettings.TipStyleCell = TipStyleCell.Show

    End Sub
'Declaration
 
Public Property AllowCellEdit As AllowCellEdit
 
using Infragistics.Win;
using Infragistics.Win.UltraWinTree;
using System.Diagnostics;

		private void button1_Click(object sender, System.EventArgs e)
		{
			//	Use the ActiveCellAppearance to bring attention to the cell
			//	with the input focus
			this.ultraTree1.ColumnSettings.ActiveCellAppearance.BackColor = Color.Red;
			this.ultraTree1.ColumnSettings.ActiveCellAppearance.ForeColor = Color.White;

			//	Set AllowCellEdit to 'ActivateOnly' so that clicking a cell does
			//	not put in into edit mode immediately
			this.ultraTree1.ColumnSettings.AllowCellEdit = AllowCellEdit.ActivateOnly;

			//	Set TabNavigation to 'NextCell' so that the tab key can be used to
			//	navigate to a cell
			this.ultraTree1.ColumnSettings.TabNavigation = TabNavigation.NextCell;

			//	Enable tooltips for cells whose value is not fully visible
			this.ultraTree1.ColumnSettings.TipStyleCell = TipStyleCell.Show;
		}
'Declaration
 
Public Property AllowCellEdit As AllowCellEdit
 
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

See Also