Dual List

This component is used by forms to allow users to add the items in the included list to or removing items from the Included List. It has a list of Available Items,  a list of Included Items  and buttons to move the items between the two lists. There are two types of dual list, one is the standard dual list and the other is the extended dual list that has additional buttons to alter the position of the items in Included Items list.

Illustrative snapshot (extemded dual list):

1. Available List: (in this example "Available Columns") lists additional columns that are available to be added into the "Included Item" list (in this example "Included Columns"). 
2. Included Item: (In this example "Included Columns") lists the columns currently selected for inclusion in the export file.
3. Click on column name in the "Available Columns" to select one or more column name. Then click on [ Add ] to include the column name into the "Included Columns" list.
4. Alternately, click on [ Add All ] to add all the column names (whether they are selected or not) from the "Available Columns" into the "Included Columns" list.
5. Select one or more column names in the "Included Columns" and then click on [ Remove ] button to remove the items from the "Included Columns" and add into the "Available Columns" list.
6. Alternately, click on [ Remove All ] to remove all the column names (whether they are selected or not) of the "Included Columns" list and add into the "Available Columns" list.
7. Click [ Sort ] button to sort the items listed in the "Included Columns" list.
8. Select a column name (but not the last one) in the "Included Columns" and then click on [ Move Down ] button to move the selected column name down one position.
9. Select a column name (but not the first one) in the "Included Columns" and then click on [ Move Up ] button to move the selected column name up one  position.
10. When the mouse pointer moves over an item in the "Available Columns" or "Included Columns" list a  tool-tip is displayed with the item description. 

The Available List contains items available to add into the Included List. The items in this list are sorted in ascending order by default.

The [ Add ] or [ Add All ] buttons can be used to move items between the Available List and the Included List. See illustrative snapshot.

The Included List contains the items that will be used by the parent component of the dual list (see illustrative snapshot). The items in this list are not sorted and are listed in the order they are added. The [ Move Up ] , [ Move Down ] and [ Sort ] buttons (if available) can be used to alter the position of the items in the list.

The [ Remove ] or [ Remove All ] buttons can be used to remove the items from the list. See illustrative snapshot.

The dual list has following buttons. See illustrative snapshot.

• Add: When clicked, the selected item/s are removed from the Available List and added to the Included List.
• Add All: When clicked, all the column names (whether they are selected or not) are removed from the Available List and are added into the Included List.
• Remove: When clicked, the selected items in the Included Items are removed and added into the Available List.
• Remove All: When clicked all the items (whether they are selected or not) are removed from the Included List and added into the Available List.

The following buttons are available in the Extended Dual List only.

• Sort: When clicked, the items in the Included List are sorted in ascending order.
• Move Down: When clicked, the selected item (but not the last one) in the Included List is moved one position down in the Included List.
• Move Up: When clicked, the selected item (but not the first one) in the Included List is moved one position up in the Included List.