Multi Reference Editor

Allows selection of multiple nodes from the Grooper tree structure, supporting hierarchical navigation and multi-select via checkboxes.

Remarks

The Multi Reference Editor control provides an interactive interface for selecting multiple nodes from the Grooper repository tree. It is designed for properties that reference a list of Node objects, such as projects, folders, or configuration items. The editor supports hierarchical navigation, multi-selection via checkboxes, and adapts its display to the context and node type.

UI Components

• Editor Tree:
  • Displays one or more branches of the Grooper tree structure.
  • Each selectable node is shown with a checkbox, allowing users to select multiple nodes.
  • Supports hierarchical navigation, expansion/collapse of branches, and filtering by node type.
  • Visual cues indicate selected nodes, leaf nodes, and hierarchy mode.
• Root Node Selection:
  • The tree may display multiple root nodes, depending on the property type and context.
  • Roots are determined by the editor's configuration and may include projects, folders, or other top-level objects.
• Contextual Features:
  • The tree adapts its hierarchy mode and selection logic based on the editor's settings.
  • Only valid node types are selectable; leaf nodes and non-selectable types are visually distinguished.

Interactive Features

• Multi-Selection:
  • Select nodes using checkboxes beside each item.
  • Ctrl + click for multi-select, Shift + click for range selection.
  • Space toggles the checkbox for the focused node.
• Hierarchical Navigation:
  • Expand/collapse branches to navigate the tree.
  • Keyboard navigation: Up/Down to move, Left/Right to expand/collapse.
  • Home/End: Jump to the first or last sibling.
• Context Menu:
  • Right-click to access commands relevant to the selected node(s), such as viewing properties or custom actions.
  • F12: View properties of the selected node.
• Drag and Drop:
  • Drag nodes to reposition them within the tree (if supported).
  • Drop files onto nodes to create new child objects or attach resources.

Usage Guidance

Use the Multi Reference Editor to select multiple nodes for properties that require a list of references. Navigate the tree to find the desired nodes, use checkboxes for selection, and leverage keyboard shortcuts for efficient multi-select. The editor ensures only valid nodes are selectable and provides visual feedback for the current selection.

• For project references, select multiple projects from the root or referenced projects.
• For folder or resource lists, browse the tree and select the required items.
• Use context menu commands for advanced actions and property review.

Accessibility

• Fully navigable by keyboard and mouse.
• Screen reader support for tree nodes, checkboxes, and context menu commands.
• Visual highlighting for selection, focus, and expanded nodes.

Example

┌──────────── Multi Reference Editor ────────────┐
│ {Editor Tree}                                  │
│   - Project A [ ]                              │
│     - Extractor 1 [ ]                          │
│     - Extractor 2 [x]                          │
│   - Project B [ ]                              │
│     - Extractor 3 [x]                          │
│ {Selected Nodes}: Extractor 2, Extractor 3     │
└────────────────────────────────────────────────┘

Child Controls

Name	Type		Summary
Tree Model	Editor Tree	►	Displays one or more branches of the Grooper tree structure, with checkboxes beside each selectable node. The Editor Tree control allows users to browse the Grooper tree and multi-select nodes using checkboxes. It supports hierarchical navigation, expansion/collapse, and adapts its selection logic to the editor's hierarchy mode. Usage Browse the tree to locate nodes of interest. Select nodes by checking the box beside each item. Use keyboard shortcuts for efficient navigation and selection. Only valid node types are selectable; leaf nodes and non-selectable types are visually distinguished. Accessibility Fully navigable by keyboard and mouse. Screen reader support for tree nodes and checkboxes.