UpdateMode Property

Gets/sets the circumstances under which cell values are committed to the underlying data source.

Syntax

Visual Basic

'Declaration
 
Public Property UpdateMode As UpdateMode

C#

public UpdateMode UpdateMode {get; set;}

Remarks

The UpdateMode property defines which type of navigation by the end user will result in cell value(s) being committed to the underlying data source. When set to 'OnActiveCellChange', the value is committed when the currently active cell "loses focus"; for example, the end user clicks on or otherwise navigates to a different cell. The 'OnActiveCellChangeOrLostFocus' setting produces the same result as the 'OnActiveCellChange' setting, except that the cell value(s) will also be committed if the control loses the input focus. When set to 'OnActiveNodeChange', the value is committed when the currently active node "loses focus"; for example, the end user clicks on or otherwise navigates to a cell in a different node. The 'OnActiveNodeChangeOrLostFocus' setting produces the same result as the 'OnActiveNodeChange' setting, except that the cell value(s) will also be committed if the control loses the input focus.

Example

The following code sample demonstrates how to configure the UltraTree such that changes made to cell values by the end user are committed when the cell whose value has changed loses the focus.

Visual Basic

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinTree

    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click

        Me.ultraTree1.Override.CellClickAction = CellClickAction.ActivateCell
        Me.ultraTree1.UpdateMode = UpdateMode.OnActiveCellChangeOrLostFocus

    End Sub

C#

using Infragistics.Win;
using Infragistics.Win.UltraWinTree;
using System.Diagnostics;

		private void button1_Click(object sender, System.EventArgs e)
		{
			this.ultraTree1.Override.CellClickAction = CellClickAction.ActivateCell;
			this.ultraTree1.UpdateMode = UpdateMode.OnActiveCellChangeOrLostFocus;
		}

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