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 |