Editor Tree

A tree control designed for use in Property Editors which select nodes from the tree structure, supporting hierarchical navigation, search, and selection.

Remarks

Overview

The Editor Tree control presents Grooper repository nodes in a hierarchical tree format, tailored for property editors that require node selection. It supports single or multi-select modes, search filtering, and context-sensitive expansion, making it ideal for selecting configuration items, folders, projects, or other nodes within the Grooper environment.

UI Components

• Tree Structure:
  • Displays nodes in a hierarchical tree, starting from one or more root nodes.
  • Supports expansion/collapse of branches for navigation.
  • Visual cues indicate selectable nodes, leaf nodes, and focused nodes.
• Search Input (when enabled):
  • Allows users to filter nodes by name or path.
  • Search results are highlighted and the tree is dynamically filtered.
• Selection Feedback:
  • Selected or focused nodes are visually highlighted.
  • Supports single or multi-select modes, depending on editor configuration.
• Icons:
  • Node icons are displayed at 16x16 for compactness.
  • Icons adapt to node type and hierarchy level.

Interactive Features

• Node Selection:
  • Click to select a node; Ctrl + click for multi-select (if enabled).
  • Shift + click to select a range.
  • Space toggles checkbox selection (if checkboxes are shown).
• Node Expansion/Collapse:
  • Double-click or use arrow keys to expand/collapse nodes.
  • The tree auto-expands to show selected or focused nodes.
• Search and Filter:
  • Enter search text to filter nodes by name or path.
  • Matching nodes and their ancestors are included in the filtered view.
• Context Menu:
  • Right-click to access commands relevant to the selected node(s), such as viewing properties or custom actions.

Usage Guidance

Use the Editor Tree to select nodes for property values in Grooper editors. Navigate the tree, use search to filter large structures, and select the desired node(s). The control ensures only valid nodes are selectable, with context-sensitive expansion and feedback.

• For configuration properties, select the appropriate folder, project, or resource node.
• Use search 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

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

Context Menu Commands

Command	Shortcut	Description
flag Go to Flagged	Ctrl+G	Moves to the next flagged item in the batch.
verified Validate Branch	Alt+F11	Validates the selected branch or project.
web View Properties	F12	Displays properties of the currently-selected item.

Child Controls

Name	Type		Summary
Context Menu	Context Menu	►	Displays commands which apply to the currently selected nodes. The Context Menu property provides access to a dynamic, hierarchical menu of commands and actions relevant to the current selection in the Tree Viewer. When you right-click on a node or group of nodes, the Context Menu appears, offering quick access to commands such as viewing properties, validation, clipboard operations, and other workflow-specific actions. Usage Guidance Use the Context Menu to perform actions quickly and efficiently on selected items in the Tree Viewer. Right-click to open the menu and select the desired command. The menu adapts to the current context, ensuring only valid actions are available. Keyboard shortcuts and icons help users work faster and more accurately. Common commands include Cut, Copy, Paste, Undo, Redo, Add, Remove, Move, Sort, and specialized actions for batch processing, classification, and data extraction. Submenus organize commands by category, making it easy to find related actions. The menu supports both single and multi-selection scenarios, adapting its contents accordingly. Accessibility Fully navigable by keyboard and mouse. Screen reader support for menu items, icons, and tooltips. Keyboard shortcuts are displayed for all major commands.

Used By

Profile BrowserBatch ViewerTest SourceDesign PageBatch Folder - GeneralBatch - ViewerContent Type - LabelsContent Type - OverridesMulti Reference EditorOrdered Reference EditorReference Editor