List Editor

Displays a drop-down list property editor with a list of possible values, supporting keyboard and mouse selection.

Remarks

The List Editor control provides an interactive drop-down list for selecting property values from a predefined set of choices. It is used in the Property Grid for properties that have a limited set of valid values, such as enumerations, type lists, or color selections. The editor supports both mouse and keyboard navigation, with instant feedback and optional tooltips for each choice.

UI Components

• Drop-Down List:
  • Displays all available choices for the property.
  • Supports single selection; the selected value is highlighted.
  • May show icons or color swatches for certain types (e.g., color lists, type lists).
• Keyboard Navigation:
  • Up/Down: Move between choices.
  • Enter: Accept the current selection.
  • Type a letter or digit to jump to the next matching value.
• Mouse Operations:
  • Click a value to select it.
  • Hover to view tooltips or additional information (e.g., type summary, color value).
• Color List Support:
  • For color properties, displays color swatches and hexadecimal values.
  • Selecting a color updates the property with the corresponding RGB value.
• Type List Support:
  • For type properties, displays type names and optional icons.
  • Tooltips provide type summaries for quick reference.

Interactive Features

• Selection Feedback:
  • The selected value is visually highlighted.
  • Tooltips and summaries provide context for each choice.
• Type Conversion:
  • Uses property converters to parse and display values in the correct format.
  • Supports advanced type resolution for type lists.
• Custom Display:
  • Adapts its display for color lists, type lists, and other specialized value sets.

Usage Guidance

Use the List Editor to select a valid value for a property from a drop-down list. Navigate using the keyboard or mouse, and review tooltips or color swatches for additional context. The editor ensures only valid choices are selectable and provides immediate feedback for selection changes.

• For color properties, use the color swatch and hexadecimal value to select the desired color.
• For type properties, use the type name and summary to choose the correct type.
• Keyboard shortcuts and mouse interactions streamline selection for large lists.

Accessibility

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

Example

┌──────────── List Editor ─────────────┐
│ [ ] Red   #FF0000                    │
│ [ ] Green #00FF00                    │
│ [ ] Blue  #0000FF                    │
│ [ ] Custom Type                      │
│ [ ] Another Type                     │
└──────────────────────────────────────┘