===== MultiselectDualList =====

com.ergotech.vib.graphics.MultiselectDualList

==== Image Examples ====

| {{:mistudio:graphics:more_layout:text_display_lists:pasted:20260627-110608.png?40|MultiselectDualList in the graphics palette}} | {{:mistudio:graphics:more_layout:text_display_lists:pasted:20260627-110747.png?120|MultiselectDualList graphic example}} |
| //MultiselectDualList in the graphics palette.// | //MultiselectDualList graphic example.// |

==== Overview ====

The MultiselectDualList graphic is a More Layout list graphic used to display list-style values in a dual-list layout.

MultiselectDualList is useful when an application needs users to move or select multiple items between two list areas.

The moved or selected item count can be sent through the output.

==== Common Uses ====

  * Displaying list-style values
  * Moving items between two list areas
  * Selecting multiple items
  * Showing list values from an array-style source
  * Sending the moved or selected item count into application logic
  * Creating dual-list selection controls in an application screen

==== Input Behavior ====

MultiselectDualList supports list-style input through **valueInput** and **updateDisplayedValue**.

Array-style or list-style values update the displayed list contents.

==== Output Behavior ====

MultiselectDualList sends selection and move behavior through **PrimaryOutPort**.

When items are moved or selected manually, **PrimaryOutPort** outputs how many elements moved from one column to another.

==== MultiselectDualList-Specific Behavior ====

MultiselectDualList is designed for dual-list selection behavior.

MultiselectDualList-specific settings include:

  * **Name** Sets the name of the MultiselectDualList graphic.
  * **ListDisabled** Controls whether the list is disabled.
  * **Visible** Controls whether the MultiselectDualList is shown.

==== Logic Ports ====

In the Logic Editor, MultiselectDualList includes these default ports:

  * **PrimaryOutPort**
  * **updateDisplayedValue**
  * **valueInput**

The **PrimaryOutPort** sends the moved or selected item count.

The **updateDisplayedValue** port updates the displayed list values from another source.

The **valueInput** port also updates the displayed list values from another source.

==== Notes ====

Use MultiselectDualList when users need to move or select multiple items between two list areas.

Use [[mistudio:design_editor:more_layout:text_display_lists:multiselectlist|MultiselectList]] when users need to select multiple items from a single list.

Use [[mistudio:design_editor:more_layout:text_display_lists:list|List]] when users only need to select one item.

For general graphic behavior, see [[mistudio:design_editor:active_graphic|Active Graphic]].

==== Related Pages ====

  * [[mistudio:design_editor:start|MIStudio Design Editor]]
  * [[mistudio:design_editor:more_layout:start|More Layout]]
  * [[mistudio:design_editor:more_layout:text_display_lists:start|Text, Display, Lists, and Tables]]
  * [[mistudio:design_editor:more_layout:text_display_lists:list|List]]
  * [[mistudio:design_editor:more_layout:text_display_lists:multiselectlist|MultiselectList]]
  * [[mistudio:design_editor:active_graphic|Active Graphic]]