# Gridlist

**Category:** Control

**Version:** 1.0

**Last Updated:** October 31, 2025

**Author:** Any2Info

***

### Description

The gridlist control allows visualization of a dataset structured like a table. The control support several table related features like filtering, sorting and footers. 

Besides the functionality for usability the control allows various styling related features regarding look and feel and line styling. 

Generally speaking, this control is used to either display a table or allow users to make selections for non-singular data entries (i.e. order lines or downtime records). 

***

### Events

<table data-header-hidden><thead><tr><th width="166"></th><th></th></tr></thead><tbody><tr><td>On update </td><td>Triggers whenever the grid receives or updates its data as a result of an initial load or filter value </td></tr><tr><td>On grid row click </td><td><p>Triggers whenever a user selects an individual row. </p><p> </p><p>This event allows some special actions that perform based on specific row values like download files or opening/copying forms. </p></td></tr></tbody></table>

### Data mapping

<table data-header-hidden><thead><tr><th width="182">Mapping</th><th></th></tr></thead><tbody><tr><td>Content  </td><td><p>Using the datasource property under Properties > Grid data the values to display in the grid can be configured </p><p> </p><p>For additional configuration regarding data formatting or styling see “Advanced configuration” </p></td></tr><tr><td>Definition header </td><td>When using the “New form for grid line action” action this mapping determines which form definition will be used </td></tr><tr><td>Document header </td><td>When using the “Download grid line document” action this mapping determines the document identification value. </td></tr><tr><td>Message header </td><td>When using either the “Open gridline form” or “Copy grid line form” action this mapping determines the message. </td></tr></tbody></table>

***

### Advanced configuration

Advanced configuration configuration of the mapped columns can be done using the overview fields property under Properties > Grid data.

<table data-header-hidden><thead><tr><th width="161">Aspect</th><th></th></tr></thead><tbody><tr><td>Header text </td><td>Allows setting the specific text displayed for the column, by default this will use the column name </td></tr><tr><td>Weight </td><td><p>Sets the weight of the column in regards to the horizontal width each column will fill in the grid. </p><p> </p><p>Using a weight of 0 will make the column invisible, which can be useful when value is used but doesn’t need to be shown </p></td></tr><tr><td>Format </td><td><p>Depending on the underlying type values in the cell can be formatted at will. </p><p> </p><p>Numerical values can have their decimal count set by using {#}. For example  €{2} would result in  €4.50 for the value 4.5. </p><p> </p><p>Date(time) values use the ISO8601 tags for format dates. </p></td></tr><tr><td>Footer  </td><td><p>Each column or column group allows setting a footer type.  </p><p> </p><p>Textual footers allow setting a text for the footer cell. </p><p> </p><p>For numerical columns additional footer types will be shown to allow mathematical operations of the shown values in the column (i.e. Sum, Min and Max). </p></td></tr><tr><td>Styling </td><td><p>Using the styling override flag an individual cell can be styled separately from the defined styling of the control. </p><p> </p><p>Additionally using this flag you can enable data driven cell background coloring </p></td></tr></tbody></table>

***

### Changelog

| Version | Date             | Change                               |
| ------- | ---------------- | ------------------------------------ |
| 1.0     | October 31, 2025 | Initial documentation version added. |