Choice Editor

Editor for selecting from a list of choices, supporting single or multi-selection with checkboxes and advanced list options.

Remarks

Overview

The Choice Editor control provides an interactive interface for selecting one or more values from a predefined list of choices. It is used in the Property Grid for properties that require selection from a set of valid options, such as enumerations, lists, or reference types. The editor supports both single and multi-selection, with optional checkboxes for batch selection.

UI Components

• Choice List:
  • Displays all available choices in a tabular layout.
  • Supports fixed-width columns for consistent display.
  • Checkboxes are shown for multi-select properties, allowing users to select multiple items at once.
  • The currently selected item(s) are visually highlighted.
• Selection Controls:
  • Click to select an item; use Ctrl + click for multi-select, Shift + click for range selection.
  • Checkboxes enable bulk selection and actions.
  • The first selected item is focused for keyboard navigation.
• Keyboard Navigation:
  • Up/Down: Move between choices.
  • Home/End: Jump to the first or last choice.
  • Space: Toggle checkbox selection (if enabled).
  • Ctrl + Up/Down: Multi-select.
  • Shift + Up/Down: Select a range.

Interactive Features

• Single and Multi-Selection:
  • For single-value properties, select one item from the list.
  • For list properties, select multiple items using checkboxes or multi-select controls.
• Visual Feedback:
  • Selected and focused items are highlighted for clarity.
  • Checkboxes indicate selected items in multi-select mode.
• Session Persistence:
  • The current selection is saved to the session for consistency across interactions.

Usage Guidance

Use the Choice Editor to select valid values for properties that require a list or enumeration. For multi-select properties, use checkboxes and keyboard shortcuts to efficiently select multiple items. The editor ensures only valid choices are available, and provides immediate feedback for selection changes.

• For large lists, use keyboard navigation and multi-select features for rapid selection.
• Visual cues and checkboxes help distinguish selected items.
• The editor adapts its layout and options based on the property type and configuration.

Accessibility

• Fully navigable by keyboard and mouse.
• Screen reader support for list items, checkboxes, and selection states.
• Visual highlighting for selection, focus, and checked states.

Example

┌───────────── Choice Editor ────────────┐
│ [ ] Option 1                           │
│ [x] Option 2                           │
│ [ ] Option 3                           │
│ [x] Option 4                           │
└────────────────────────────────────────┘

Child Controls

Name	Type		Summary
List Model	Object List	►	Displays a list of choices for selection, supporting single or multi-select with checkboxes. Purpose The List Model control presents all available choices in a tabular format, enabling users to select one or more items. It supports fixed-width columns, checkboxes for multi-select, and visual feedback for selection and focus. Usage Click to select an item; use Ctrl + click or Shift + click for multi-select. Checkboxes are shown for list properties, allowing batch selection. The first selected item is focused for keyboard navigation. Accessibility Fully navigable by keyboard and mouse. Screen reader support for list items and checkboxes.