Ordered Reference Editor

Used for editing an ordered list of GrooperNodes in a PropertyGrid, supporting selection, reordering, and management of node references.

Remarks

Overview

The Ordered Reference Editor control provides an interactive interface for managing an ordered list of Node references within Grooper. It is designed for properties that require a specific sequence of referenced nodes, such as configuration lists, processing steps, or resource collections. The editor supports selection from the Grooper tree, reordering, and review of referenced nodes in a tabular format.

UI Components

• Selected Nodes:
  • Displays the current ordered list of selected reference nodes in a table.
  • Columns show node identifiers and type display names for clarity.
  • Supports multi-select, visual highlighting, and custom attributes.
• Selectable Nodes:
  • Presents a hierarchical tree view of selectable reference nodes.
  • Allows browsing, searching, and selecting nodes from the Grooper repository.
  • Supports expansion/collapse, filtering, and context menu commands.
• Action Buttons:
  • Move Up / Move Down: Reorder selected items in the list to adjust their sequence.

Interactive Features

• Selection Controls:
  • Select nodes from the tree to add them to the ordered list.
  • Click to select items in the list; use Ctrl + click for multi-select, Shift + click for range selection.
• Reordering:
  • Move items up or down in the list using the action buttons.
  • Keyboard shortcuts may be available for rapid reordering.
• Tree Navigation:
  • Expand/collapse branches to locate nodes.
  • Filter or search for specific node types or names.
  • Right-click for context menu commands relevant to the selected node(s).
• Validation and Feedback:
  • Visual cues indicate selection, focus, and valid/invalid states.
  • The editor ensures only valid nodes are selectable and maintains the correct order.

Usage Guidance

Use the Ordered Reference Editor to build and manage ordered lists of node references for configuration, workflow, or resource management. Select nodes from the tree, review and reorder them in the list, and use context menu commands for advanced actions.

• For workflow steps, ensure the order matches the intended processing sequence.
• For resource lists, use type display names and identifiers to verify correct selection.
• Use multi-select and batch actions for efficient management.

Accessibility

• Fully navigable by keyboard and mouse.
• Screen reader support for list items, tree nodes, and action buttons.
• Visual highlighting for selection, focus, and error feedback.

Example

┌──────────── Ordered Reference Editor ─────────────┐
│ Selectable Nodes                                  │
│   - Project A                                     │
│     [X] Extractor 1                               │
│     [ ] Extractor 2                               │
│     [X] Extractor 3                               │
│ ───────────────────────────────────────────────── │
│ Selected Nodes                                    │
│ | Id          | Type           |                  │
│ |-------------|----------------|                  │
│ | Extractor 1 | Value Reader   | [↑↓]             │
│ | Extractor 3 | Value Reader   | [↑↓]             │
│ {Move Up} {Move Down}                             │
└───────────────────────────────────────────────────┘

Command Buttons

Button	Shortcut Key		Summary
north move_up		►	Move the selected item up. Purpose The Move Up button reorders the selected item(s) in the list, moving them one position higher. Usage Select one or more items in the List Model. Click the move up button to move them up. The list updates immediately to reflect the new order. Accessibility Screen reader support for button label and action.
south move_down		►	Move the selected item down. Purpose The Move Down button reorders the selected item(s) in the list, moving them one position lower. Usage Select one or more items in the List Model. Click the move down button to move them down. The list updates immediately to reflect the new order. Accessibility Screen reader support for button label and action.

Child Controls

Name	Type		Summary
Selected Nodes	Object List	►	List of selected reference nodes. Purpose The Selected Nodes control displays the current ordered list of selected reference nodes in a table format. Columns include node identifiers and type display names, providing clarity and context for each item. Usage Review the sequence of selected nodes. Select one or more items for reordering or removal. Use visual cues and custom attributes for integration with scripts and styling. Accessibility Fully navigable by keyboard and mouse. Screen reader support for row and column data.
Selectable Nodes	Editor Tree	►	Tree view of selectable reference nodes. Purpose The Selectable Nodes control presents a hierarchical view of selectable reference nodes from the Grooper repository. Users can browse, search, and select nodes to add to the ordered list. The tree supports expansion/collapse, filtering, and context menu commands for advanced actions. Usage Browse the tree to locate nodes of interest. Select nodes to add them to the ordered list. Use context menu commands for property review and advanced actions. Accessibility Fully navigable by keyboard and mouse. Screen reader support for tree nodes and context menu commands.