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

Virtual Table Definition

Embedded Object Grooper.Core

Defines a virtual table for user review by selecting a multi-instance container and one or more single-instance descendant fields.

Remarks

The Virtual Table Definition class configures a custom tabular view for reviewing and editing repeating data in Grooper's user interface.

Integration with GrooperReview UI

  • Used by the Virtual Table control in the Grooper UI to render a dynamic, interactive table for collections such as Data Table rows or multi-instance Data Section items.
  • When assigned to the 'Tabular View' property of a Data View, the UI displays the virtual table instead of the default hierarchical data model view.

UI Rendering Details

  • Columns: The 'Columns' property determines which Data Fields or Data Columns are shown as columns. Their order in the list controls the column order in the UI.
  • Rows: Each item in the 'Collection' property (a Data Table or multi-instance Data Section) is rendered as a row.
  • Headers: Column headers display the field names and tooltips, and may include additional metadata such as data type.
  • Paging/Scrolling: The 'Maximum Display Rows' property controls how many rows are shown at once. If set to 0, all rows are displayed with no scrollbars; otherwise, paging or scrolling is enabled for large tables.
  • Error Display: If the underlying data instance has errors, a warning icon and tooltip are shown in the caption area.

Keyboard Navigation and Accessibility

  • Users can navigate the table using arrow keys:
    • Arrow keys move within cell contents and between cells.
    • Ctrl + arrow keys jump directly from cell to cell.
  • The table is fully keyboard-accessible for review and editing.

Customizing the Review Experience

  • Use virtual table views to focus user attention on the most relevant fields and to simplify review of structured, repeating data.
  • Unlike the default data model view (which shows the full hierarchy), the virtual table presents a flat, spreadsheet-like interface for the selected collection.
  • This is especially useful for tables, line items, or any scenario where users need to quickly scan, validate, or edit multiple similar records.

Related Concepts

  • Virtual Table control: Renders the table in the GrooperReview UI.
  • Data View: Hosts the tabular view and switches between full model and virtual table modes.

Properties

NameTypeDescription

See Also

Used By

Notification