This functionality is only available for certain module packages.

You are here: Reference > Form-UI > Tables > pureTable

pureTable

The element <pureTable> is used to display large amounts of data in a table. Within a table column only one of the elements <label> or <input> are presented. For the <input> element only the types check, text and combo are allowed.

The attribute receiver has to return a list which is used to iterate over in the table.

Sorting the content:

The content of the table is displayed in order of iterations, but can be sorted in ascending or descending order for each column. Each mouse click on the columns header switches between unsorted, ascending order and descending order. The manually selected value is stored persistently.

Content filtering:

To limit the amount of viewable content filters can be activated and configured as needed. The following filter types are possible:

Filter for free text:

If this filter is configured, a row underneath the header row appears, where filter text may be input for each column. Predefined filter are also displayed underneath the header row and may be overwritten.

If the content is limited by a predefined filter and the filter is changed afterwards to show more content, a scrollbar appears on the right border of the table.

The manually entered value is stored persistently.

Filter for selection of existing cell content out of a drop-down list:

If this filter is configured, a row underneath the header row appears, containing a drop-down list box for each column. The drop-down list boxes are filled-up with values of the respective column. The selected value of a drop-down list box limits the shown number of table rows.

A selected filter value is stored persistently.

Column width:

The width of the columns is predefined by several attributes but may be changed manually. The manually entered columns widths are stored persistently.

Modifying of cell contents:

To start the editor in a modifiable cell the following actions are possible:

Marking and copying of table contents:

The content of a single table cell (attribute selectionMode="cell") is marked copied to the clipboard by means of the mouse and the key-combination [Ctrl] + [C]. Further table cells are marked by pressing the [Ctrl] key at the same time and an area of cells is marked by pressing the [Shift] key at the same time. A complete table row is also marked with the mouse, if the selectionMode="row" attribute is set.

To past the content of the clipboard back into table cells the key combination [Strg] + [V] is used. The files in the clipboard should be conform to the Excel format, meaning that columns are separated by tabulators, rows by line breaks, cells are surrounded by quotation marks. To show a quotation mark it must be written twice.

Possible inserting modes:

If the clipboard contains as many values as cells are marked in the table, the values are pasted into the marked cells.

If the clipboard contains less values than cells are marked in the table, then the values of clipboard are pasted into the according number of table cells.

If the clipboard contains only a single value, this value is pasted into all marked table cells.

Attribute name Usage Attribute values Default value Description
columnsMax optional, only together with freezeLeft and/or freezeRight Maximum number of displayed columns beside/between fixed columns.
freezeLeft optional true, false false Number of fixed columns on the left side of the table.
freezeRight optional true, false false Number of fixed columns on the right side of the table.
height optional Integer, fillForm Height of the entire table.
Integer = height of the table in pixel
fillForm = the table occupies the entire height of the Form-UI
maxHeight optional, only together with height="fillForm" The pureTable will not grow higher than the maximum height in pixel when the Form-UI window is enlarged.
maxWidth optional, only in conjunction with width="fitToForm" The pureTable will not grow wider than the maximum width in pixel when the Form-UI window is enlarged.
minHeight optional, only together with height="fillForm" The Form-UI window cannot become smaller than the minimum height of the pureTable in pixels.
minWidth optional, only in conjunction with width="fitToForm" The Form-UI window cannot become smaller than the minimum width of the pureTable in pixels.
readonly optional true, false true = pureTable is read-only.
false = Input can be written to the pureTable.
receiver required A list has to be returned. In the table is iterated over the list and thus the number of lines below the header determined.
If a formula returns a list of components, the determined component can be referenced for each iteration.
selectionMode optional cell, row row Switches the selection mode between cell content and row content.
rows optional Number of displayed table rows
rowsMax optional Maximum number of displayed table rows
rowsMin optional Minimum number of displayed table rows The minimum number of table rows cannot be less than 3.
variable optional Name of the variable
visible optional true, false true true = table is visible
true = table is invisible
width optional Integer, fitToForm Width of the entire table.
Integer = Width of the table in pixels
fillForm = Table takes on the entire width of the Form-UI
Allowed sub-elements Quantity
column any
filters 0..1

Table with two columns:

The following example shows a table that lists, for all the components of type Pfuderer_ModularSystem.Mechatronic.SensorsActuators.Base.SensorActuator, the parameters Place and Name.

Table with three columns of predefined width:

The following example shows a table, that lists the name of the circular transfer system and of all components of the type 'Pfuderer_ModularSystem.Mechatronic.SensorsActuators.Base.SensorActuator' the parameters Place and Name.

Table with predefined filter:

The following example shows a table, that lists the name of the circular transfer system and of all components of the type 'Pfuderer_ModularSystem.Mechatronic.SensorsActuators.Base.SensorActuator' the parameters Place and Name. The number of items to display should be limited to the sensors and actuators, which are installed in the station St21.

Table with limited number of rows:

The following example shows a table, which has a limited number of rows with rowsMax="10".

Table with minimum number of rows:

The following example shows a table, which has a minimum number if rows, predefined with rowsMin="10".

Double-clicking on a table row starts an action

In the following table an action is started by double-clicking any row.

Table with fixed columns:

The following example shows a table which representation is limited to a maximum of 5 rows and 7 columns. On the left side 7 columns and on the right side one column is fixed. The columns and rows in between are reached by means of scrollbars.

Table with fixed height:

The following example shows a table whose height is fixed at 150 pixels.

Result:

Table with a dynamic height:

The following example shows a table whose height matches that of the Form-UI.

Result:

Table with fixed width:

The following example shows a table whose width is fixed at 350 pixels.

Result:

Table with dynamic width:

The following example shows a table, whose width matches that of the Form-UI.

Result: