│ Grooper Help - Version 25.0
25.0.0017 2,127
  • Overview
  • Help Status

Reference Editor

Node Reference Editor Property Grid Editor GrooperReview.Controls.PropertyGrid

Provides a UI for editing properties which reference nodes in the Grooper tree structure, supporting hierarchical navigation and node selection.

Remarks

The Reference Editor control enables users to select a single node from the Grooper repository tree for properties that reference Node objects. It is designed for scenarios where a property must point to a specific configuration item, folder, project, or resource within the Grooper environment. The editor integrates a hierarchical tree viewer, search input, and selection logic to streamline node selection and validation.

UI Components

  • Tree Viewer:
    • Displays the Grooper tree structure, starting from one or more root nodes relevant to the property type.
    • Supports hierarchical navigation, expansion/collapse of branches, and filtering by node type.
    • Visual cues indicate selectable nodes, leaf nodes, and the currently selected node.
  • Search Input:
    • Allows users to filter tree nodes by name or type.
    • Typing in the editor automatically focuses the search input for rapid filtering.
    • Search results update in real time as the user types.
  • Selection Feedback:
    • The selected node is highlighted in the tree.
    • Clicking a node or pressing Enter accepts the current selection.
    • Only valid node types are selectable; non-selectable nodes are visually distinguished.
  • Context Menu:
    • Right-click to access commands relevant to the selected node, such as viewing properties or custom actions.
    • F12: View properties of the selected node.

Interactive Features

  • Hierarchical Navigation:
    • Expand/collapse branches to browse the tree.
    • Keyboard navigation: Up/Down to move, Left/Right to expand/collapse.
    • Home/End: Jump to the first or last sibling.
  • Search and Filter:
    • Type to filter nodes by name or type.
    • Focus automatically transfers to the search input when typing.
    • Search results are highlighted and navigable via keyboard.
  • Node Selection:
    • Click a node or press Enter to select it.
    • Only nodes of the required type are selectable; others are disabled.
  • Context Menu Commands:
    • Access additional actions via right-click, such as viewing node properties or running custom commands.

Usage Guidance

Use the Reference Editor to select a valid node for properties that require a reference to a Grooper tree item. Navigate the tree, use the search input to filter results, and select the desired node. The editor ensures only valid nodes are selectable and provides immediate feedback for selection changes.

  • For configuration properties, select the appropriate folder, project, or resource node.
  • Use the search input to quickly locate nodes in large trees.
  • Access context menu commands for advanced actions and property review.

Accessibility

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

Example

┌───────────── Reference Editor ───────────┐
│ {Search Input}: [__________]             │
│ {Tree Viewer}                            │
│   - Project A                            │
│     - Folder 1                           │
│     - Folder 2                           │
│   - Project B                            │
│     - Folder 3                           │
│ {Selected Node}: Folder 2                │
└──────────────────────────────────────────┘

Child Controls

NameTypeSummary
Notification