Data Controls

Data Controls

Data controls present structured information.

Common Types

  • Tables and policy rows.
  • Lists and item collections.
  • Tree views.
  • Scroll areas with horizontal and vertical scroll bars.

Class Diagram

QWidget
  ├─ QTableView
  │   └─ UIGQTableView + IUIGQWidgetBase
  ├─ QTreeView
  │   └─ UIGQTreeView + IUIGQWidgetBase
  ├─ QListView
  │   └─ UIGQListView + IUIGQWidgetBase
  ├─ QListWidget
  │   └─ UIGQList + IUIGQWidgetBase
  └─ QScrollArea
      └─ UIGQScrollView + IUIGQWidgetBase
          └─ UIGQPropertyList

Notes

Keep row height, column width, and selection states stable. For large datasets, prefer incremental loading or virtualization strategies instead of creating every row at once.

Common APIs

Method Description Parameters Return
setItemHeight(int height) Sets row or item height. height: height in pixels. void
setCheckstyle(bool enabled) Enables the table checkbox style. enabled: whether checkbox style is enabled. void
setColumnWidget(int column, UIGQContainer* widget) Configures a custom control container for a table column. column: column index; widget: custom container. void
selectedRows() const Returns selected table rows. None. QList<int>
headerCheckedChanged(bool checked) Signal emitted when the header checkbox changes. checked: header checkbox state. void
customControlClicked(int row, const QString& name) Signal emitted when a custom cell control is clicked. row: row index; name: control name. void