DualSelectBox has next client side events:

Client-side event	Description
onItemMoved	Occurs when an item is moved.
onFilterChange	Occurs after the filter is changed but before the filter is applied to the item list.
onFilterSet	Occurs after the filter is applied to the item list.
onItemsRequested	Occurs when items is already requested from server
onItemsRequesting	Occurs when items is needed to request from server

Also DualSelectBox has some client-side API functions to easily manipulate with control and its value without postback.

Client-side API functions list: 

Function name	Description
al_DualSelectBox_SetEnable(clientID, isEnable)	Enables or disables the control with given identifier clientID, new state sets with isEnable value
al_DualSelectBox_IsEnabled(clientID)	Returns is the control enabled or not.
al_DualSelectBox_SetVisible(clientID, isVisible)	Shows or hides the control with identifier clientID, new state depends on isVisible value
al_DualSelectBox_IsVisible(clientID)	Returns is the control visible or not.
al_DualSelectBox_ClearFilter(clientID); al_DualSelectBox_ClearFilter(clientID, clearValueFilter);	Clear filter textbox of the control with identifier clientID. By default clears only text textbox. But you also can clear value textbox.
al_DualSelectBox_SetSelectedValue(clientID, value)	Sets the control's option with value=value as selected
al_DualSelectBox_GetSelectedValues(clientID)	Gets the control's selected values array in JavaScript Array object

Example:

<cc1:DualSelectBox ID="DualSelectBox1" runat="server"></cc1:DualSelectBox>

<input id="btn1" onclick="al_DualSelectBox_SetEnable('DualSelectBox1', false);" type="button" value="Disable DualSelectBox" />

<input id="btn2" onclick="al_DualSelectBox_SetEnable('DualSelectBox1', true);" type="button" value="Enable DualSelectBox" />

<input id="btn2" onclick="al_DualSelectBox_SetVisible('DualSelectBox1', true);" type="button" value="Show DualSelectBox" />

<input id="btn2" onclick="al_DualSelectBox_SetVisible('DualSelectBox1', false);" type="button" value="Hide DualSelectBox" />

<input id="btn2" onclick="al_DualSelectBox_SetSelectedValue('DualSelectBox1', '1');" type="button" value="Set DualSelectBox option '1' to selected" />

<input id="btn2" onclick="alert(al_DualSelectBox_GetSelectedValues('DualSelectBox1'));" type="button" value="Get DualSelectBox selected values" />

<input id="btn2" onclick="al_DualSelectBox_ClearFilter('dualselectbox1');" type="button" value="Clear text filter" />

<input id="btn2" onclick="al_DualSelectBox_ClearFilter('dualselectbox1', true);" type="button" value="Clear value filter" />

Controls: DualSelectBox

 

 

---

© 2002-2007 Astron Digital. All Rights Reserved.