Home | Using Katmandoo | Quick Start Guide | How-to | Task MenuGlossary | See Also | Collapse All

Dual List

Overview

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):
Dual List(Click it to change its size)
  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. 

Available List

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.

Included List

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.

Command Buttons

The dual list has following buttons. See illustrative snapshot. The following buttons are available in the Extended Dual List only.

See Also