KaxTreeView.ClientChanges Property

KaxTreeViewClientChanges Property

Gets a list of all client-side changes (adding a node, removing a node, changing a node'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<KaxTreeNode>> ClientChanges { get; }

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

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

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

Property Value

Type: IListClientOperationKaxTreeNode
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

adding a new item
removing existing item
clearing the children of an item or the control itself
changing a property of the item

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<KaxTreeNode> operation in KaxTreeView1.ClientChanges)
{
    KaxTreeNode node = operation.Item;

    switch (operation.Type)
    {
        case ClientOperationType.Insert:
            //A node has been inserted - operation.Item contains the inserted node
        break;
        case ClientOperationType.Remove:
            //A node has been inserted - operation.Item contains the removed node. 
         //Keep in mind the node has been removed from the treeview.
        break;
        case ClientOperationType.Update:
            UpdateClientOperation<KaxTreeNode> update = operation as UpdateClientOperation<KaxTreeNode>
            //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 node whose children have been removed. If operation.Item is null then the root nodes have been removed.
        break;
    }
}

For Each operation As ClientOperation(Of KaxTreeNode) In KaxTreeView1.ClientChanges
    Dim node As KaxTreeNode = operation.Item
    Select Case operation.Type
        Case ClientOperationType.Insert
            'A node has been inserted - operation.Item contains the inserted node
        Exit Select
        Case ClientOperationType.Remove
            'A node has been inserted - operation.Item contains the removed node. 
            'Keep in mind the node has been removed from the treeview.
        Exit Select
        Case ClientOperationType.Update
            Dim update As UpdateClientOperation(Of KaxTreeNode) = TryCast(operation, UpdateClientOperation(Of KaxTreeNode))
            '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 node whose children have been removed. If operation.Item is Nothing then the root nodes have been removed.
        Exist Select
    End Select
Next

Reference

KaxTreeView Class

Kettic.AspNet.Controls Namespace