KaxTabControl.ClientChanges Property

KaxTabControlClientChanges Property

Gets a list of all client-side changes (adding a tab, removing a tab, changing a tab's property) which have occurred.

Namespace: Kettic.AspNet.Controls
Assembly: Kettic.AspNet.Controls (in Kettic.AspNet.Controls.dll) Version: 2014.4.1129.0 (2014.04.1129.0)

Syntax

C++

Copy

public IList<ClientOperation<KaxTab>> ClientChanges { get; }

Public ReadOnly Property ClientChanges As IList(Of ClientOperation(Of KaxTab))
	Get

public:
property IList<ClientOperation<KaxTab^>^>^ ClientChanges {
	IList<ClientOperation<KaxTab^>^>^ get ();
}

member ClientChanges : IList<ClientOperation<KaxTab>> with get

Property Value

Type: IListClientOperationKaxTab
A list of ClientOperationT objects which represent all client-side changes the user has performed. By default the ClientChanges property returns empty list. Client-changes are recorded if and only if the client-side methods trackChanges()/commitChanges() have been invoked.

Remarks

You can use the ClientChanges property to respond to client-side modifications such as

The ClientChanges property is available in the first postback (ajax) request after the client-side modifications have taken place. After this moment the property will return empty list.

Examples

The following example demonstrates how to use the ClientChanges property

C++

Copy

foreach (ClientOperation<KaxTab> operation in KaxTabControl1.ClientChanges)
{
    KaxTab tab = operation.Item;

    switch (operation.Type)
    {
        case ClientOperationType.Insert:
            //An tab has been inserted - operation.Item contains the inserted tab
        break;
        case ClientOperationType.Remove:
            //An tab has been inserted - operation.Item contains the removed tab. 
         //Keep in mind the tab has been removed from the tabcontrol.
        break;
        case ClientOperationType.Update:
            UpdateClientOperation<KaxTab> update = operation as UpdateClientOperation<KaxTab>
            //The "UpdateOperation" provides an additional property "PropertyName". This is the property whose value was changed from the client side.
        break;
        case ClientOperationType.Clear:
            //All children of have been removed - operation.Item contains the parent tab whose children have been removed. If operation.Item is null then the root tabs have been removed.
        break;
    }
}

For Each operation As ClientOperation(Of KaxTab) In KaxTabControl1.ClientChanges
    Dim tab As KaxTab = operation.Item
    Select Case operation.Type
        Case ClientOperationType.Insert
            'A tab has been inserted - operation.Item contains the inserted tab
        Exit Select
        Case ClientOperationType.Remove
            'A tab has been inserted - operation.Item contains the removed tab. 
            'Keep in mind the tab has been removed from the tabcontrol.
        Exit Select
        Case ClientOperationType.Update
            Dim update As UpdateClientOperation(Of KaxTab) = TryCast(operation, UpdateClientOperation(Of KaxTab))
            'The "UpdateOperation" provides an additional property "PropertyName". This is the property whose value was changed from the client side.
        Exit Select
        Case ClientOperationType.Clear
            'All children of have been removed - operation.Item contains the parent tab whose children have been removed. If operation.Item is Nothing then the root tabs have been removed.
        Exist Select
    End Select
Next

Reference

KaxTabControl Class

Kettic.AspNet.Controls Namespace