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

Tree Viewer

Control GrooperReview.Controls

Displays a hierarchical view of Grooper repository objects, enabling navigation, selection, and manipulation of nodes in a tree structure.

Remarks

The Tree Viewer control presents Grooper repository objects in a hierarchical tree format, allowing users to browse, select, and interact with nodes such as Projects, Folders, Batches, Batch Folders, Batch Pages, and configuration items. It is a core navigation and selection component used throughout the Grooper web client, including design, review, and batch processing interfaces.

Display Modes

  • Small Icon Mode:
    • Uses 16x16 icons for a compact view.
    • Supports multiple root nodes.
    • Commonly used in configuration UIs, Property Editors, and the Design Page.
    • May display checkboxes beside nodes for multi-selection or property editing.
  • Large Icon Mode:
    • Uses 64x64 icons for enhanced visibility.
    • Displays a single root node, typically a Batch Object.
    • Multi-select is limited to objects of the same type.
    • Used in Batch Viewer, Test Source, and batch-centric UIs.

Interactive Features

  • Node Selection:
    • Single-click to select a node.
    • Ctrl + click for multi-select.
    • Shift + click to select a range.
  • Node Expansion/Collapse:
    • Double-click to expand or collapse nodes.
    • Keyboard navigation with arrow keys, Home, End, and multi-select shortcuts.
  • Checkboxes:
    • When enabled, checkboxes allow for hierarchical or multi-node selection.
    • Space toggles the checkbox for the focused node.
  • Drag and Drop:
    • Drag nodes to reposition them within the tree.
    • Drop files onto Batch Folders, Projects, or Folders to create new child objects or attach resources.
  • Context Menu:
    • Right-click to access commands relevant to the selected node(s), such as viewing properties, validation, or custom actions.

Keyboard Shortcuts

  • Up/Down: Navigate between sibling nodes.
  • Left/Right: Expand/collapse nodes or move up/down the hierarchy.
  • Home/End: Jump to the first or last sibling.
  • Shift + Up/Down: Multi-select range.
  • Shift + Home/End: Multi-select to start/end of siblings.
  • Ctrl + A: Select all siblings (same type in large icon mode).
  • Space: Toggle checkbox (if enabled).

Drag and Drop Operations

  • Node Reordering:
    • Drag nodes to move them before, after, or inside other nodes.
  • File Import:

Context Menu Commands

  • View Properties (F12):
    • Displays properties of the selected node.
  • Go to Flagged (Ctrl + G):
    • Moves to the next flagged item in a batch.
  • Validate Branch (Alt + F11):
    • Validates the selected branch or project.
  • Additional commands may be available depending on node type and context.

Usage Scenarios

  • Design and Configuration:
    • Browse and edit repository objects, assign properties, and organize nodes.
  • Batch Review and Processing:
    • Navigate batch content, flag items, validate branches, and manage attachments.
  • Property Editing:
    • Select nodes for property editing, with support for multi-select and checkboxes.
  • Resource Management:
    • Import files, create new objects, and manage hierarchical relationships.

Accessibility and Usability

  • Icons, tooltips, and keyboard shortcuts enhance usability and accessibility.
  • Context menus and drag-and-drop support streamline common workflows.
  • The control adapts its layout and features based on the current mode and context.

Example

┌───────────── Tree Viewer ────────────┐
│ Project A                            │
│ ├─ Folder 1                          │
│ │  ├─ Document 1                     │
│ │  └─ Document 2                     │
│ └─ Folder 2                          │
│    └─ Document 3                     │
└──────────────────────────────────────┘

Related Controls

For more information, see the documentation for Node, Batch, Batch Folder, Project, and Resource File.

Derived Types

There are 2 implementations of Tree Viewer.

Editor Tree A tree control designed for use in Property Editors which select nodes from the tree structure, supporting hierarchical navigation, search, and selection.
Override Tree Displays a hierarchy of Data Elements for override management.

Context Menu Commands

Command Shortcut Description
file_copy Copy Ctrl+C Copies the current selection to the clipboard. Items will be duplicated when pasted.
content_cut Cut Ctrl+X Copies the current selection to the clipboard. Items will be moved when pasted.
flag Go to Flagged Ctrl+G Moves to the next flagged item in the batch.
content_paste Paste Ctrl+V Pastes the clipboard content to the selected node.
verified Validate Branch Alt+F11 Validates the selected branch or project.
web View Properties F12 Displays properties of the currently-selected item.

Child Controls

NameTypeSummary

Used By

Notification