BeginUpdate Method (UltraTilePanel)

Sets the Infragistics.Win.UltraControlBase.IsUpdating flag to true which prevents painting.

Syntax

Visual Basic

'Declaration
 
Public Overrides Sub BeginUpdate() 

C#

public override void BeginUpdate()

Remarks

This is used to optimize performanance while setting a number of properties or adding a number of items (e.g. nodes in a tree control) so that all paint messages are ignored until EndUpdate(Boolean) is called.

Example

The following code demonstrates how to add multiple tiles to the UltraTilePanel as a single operation.

Visual Basic

Imports System.Windows.Forms
Imports Infragistics.Win
Imports Infragistics.Win.Misc

' Begin an updte operation the UltraTilePanel so it doesn't layout the 
' UltraTiles while multiple tiles are being added.

Me.UltraTilePanel1.BeginUpdate()

' Add a few UltraTiles to the UltraTilePanel
Dim tile1 As New UltraTile
tile1.Control = New Button()
tile1.State = TileState.Large
Me.UltraTilePanel1.Tiles.Add(tile1)

Dim tile2 As New UltraTile
tile2.Control = New TextBox()
Me.UltraTilePanel1.Tiles.Add(tile2)

Dim tile3 As New UltraTile
tile3.Control = New Label()
Me.UltraTilePanel1.Tiles.Add(tile3)

' End the update operation so the UltraTilePanel can continute managing 
' the UltraTile objects.
Me.UltraTilePanel1.EndUpdate()

C#

using System.Windows.Forms;
using Infragistics.Win;
using Infragistics.Win.Misc;

// Begin an updte operation the UltraTilePanel so it doesn't layout the 
// UltraTiles while multiple tiles are being added.
this.ultraTilePanel1.BeginUpdate();

// Add a few UltraTiles to the UltraTilePanel
UltraTile tile1 = new UltraTile();
tile1.Control = new Button();
tile1.State = TileState.Large;
this.ultraTilePanel1.Tiles.Add( tile1 );

UltraTile tile2 = new UltraTile();
tile2.Control = new TextBox();
this.ultraTilePanel1.Tiles.Add( tile2 );

UltraTile tile3 = new UltraTile();
tile3.Control = new Label();
this.ultraTilePanel1.Tiles.Add( tile3 );

// End the update operation so the UltraTilePanel can continute managing 
// the UltraTile objects.
this.ultraTilePanel1.EndUpdate();

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