The requested page is not available for the requested platform. You are viewing the content for Default platform.

ASPxClientListBox.BeginUpdate Method

Prevents the client list box editor from being rendered until the ASPxClientListBox.EndUpdate method is called.

Declaration

BeginUpdate(): void

Remarks

The list box editor allows a sequence of operations that affect its appearance and/or functionality to be performed on the client side, without having the editor render itself after each modification (for instance, multiple items within the editor can be dynamically added/removed at the same time). To do this, the code performing sequential changes to the editor must be enclosed within calls to the BeginUpdate and ASPxClientListBox.EndUpdate methods. This improves performance, and avoids unnecessary render operations on the client side.

Examples

The following section of the Moving Items Between Two List Boxes online demo illustrates how moving ASPxListBox items is implemented using the ASPxClientListBox.GetSelectedItems, ASPxClientListBox.AddItem, ASPxClientListBox.RemoveItem, ASPxClientListBox.BeginUpdate and ASPxClientListBox.EndUpdate client methods.

function AddSelectedItems() {
    MoveSelectedItems(lbAvailable, lbChoosen);
...
}

function RemoveSelectedItems() {
    MoveSelectedItems(lbChoosen, lbAvailable);
...
}
function MoveSelectedItems(srcListBox, dstListBox) {
    srcListBox.BeginUpdate();
    dstListBox.BeginUpdate();
    var items = srcListBox.GetSelectedItems();
    for(var i = items.length - 1; i >= 0; i = i - 1) {
        dstListBox.AddItem(items[i].text, items[i].value);
        srcListBox.RemoveItem(items[i].index);
    }
    srcListBox.EndUpdate();
    dstListBox.EndUpdate();
}
See Also