Sfairadora

  • Reference Guide

Table

The table dispel is used to display and edit sequences of structures (i.e. data tables). If you need to edit simple sequences not containing structures that could be displayed in columns, it is more appropriate to use the sequence editor.
The use of the table is explained in a separate chapter.

Functionality

Item
Description
Object name
Name of the object where the edited sequence is located. You can select one of the objects provided by parent dispels.
Data reference
Reference to a sequence within the above identified object.
Object name of data for rows
Name of the data object that will be used to provide row data containing the cell to the respective table cell dispels. The default name is row_data.
Object name of data for cells
Name of the data object representing data edited by a particular cell. That is, the component of a table row pertaining to the column in which the cell receiving the data is located. The link between the data item and the column is established by the Data reference attribute in the column definition. The default name is cell_data.
Data type of inserted element
The data type of the newly inserted sequence element. Usually, it need not be specified – it is determined automatically from the sequence elements type. However, if the type of the sequence element is Union, it may be necessary to specify the actual type to be inserted by the table.
Filter and order
Filter button
If checked, the table has a button do display a filter.
Fixed filter
If checked, the table filter cannot be modified.
Fixed unicity
If checked, the Disable Duplicity of Values property cannot be changed.
Fixed order
If checked, table order cannot be changed.
Editing filter and order
This setting determines the effect of changes to filter, order, and disabled duplicity of values (unicity) on edited data:
direct change of data
if the edited table is a view (that is, an inferred sequence, e.g. in the View document section), then the view definition is changed. If the table represents actual physical data (e.g. in the Data document section), filter setting (as well as deduplication) really physically removes data that does not satisfy the filter; order setting really physically reorders the data. As long as the filter is in place, data in conflict with the filter cannot be inserted into the table. As long as the ordering is in place, new data is automatically inserted into the right position according to the ordering so that the defined order cannot be disrupted.
create local view
always creates a local view inside the presentation. Changes of filter and order therefore affect neither the physical data, nor the view definition when the edited data is a view.
create local view if data is not a view
if the edited data is actual physical data (e.g. in the Data document section), a local view is created so that the data itself is not affected. In contrast, if the edited data is a view, its definition is modified.
Summary
Table summary is explained in a separate chapter.

Columns

Item
Description
Column lines and spaces
Line between columns
Determines the appearance of the line between columns. The line is inserted into the space between columns. If the space is not wide enough, the line is not displayed.
none
no line (default setting).
simple
a simple black line one pixel wide (the actual color may differ depending on Windows settings). The space between columns must be at least 1.
groove
three-dimensional line resembling a groove. The space between columns must be at least 2.
Line of column separator
Appearance of the line before the column if the Separator before column option is on. The line may not be displayed if the Space of column separator value is not sufficient. Available attributes are the same as those of the Line between columns option.
Space between columns
Space between adjacent columns.
Space of column separator
Space between columns if the following column has the Separator before column option set.
Columns definition
Column definition is explained in a separate chapter.

Rows

Item
Description
Space before row
The size (in pixels) of the space before (i.e. above) every row.
Space after row
The size (in pixels) of the space after (i.e. below) every row.
Space between rows
The space between rows. In contrast to the space before and after row, it is not displayed before the first and after the last row. The space between inner rows is therefore equal to the sum of the spaces before, between, and after the rows.
Line between rows
Determines the appearance of the line between rows. The line is inserted into the space between rows. If the space is not wide enough, the line is not displayed. The options are:
none
no line (default setting)
simple
a simple black line one pixel wide (the actual color may differ depending on Windows settings). The space between rows must be at least 1.
groove
three-dimensional line resembling a groove. The space between rows must be at least 2.
Row grip
Determines the appearance of the row label displayed on the left in front of every row. The user can grab the row by the label and drag it to another position with the mouse. The options are:
none
no label.
simple
only a pattern (“rough surface”) is displayed on the label.
row number
the label contains row number.
Disable deleting rows
If checked, sequence elements cannot be deleted by the table.
Confirm row deleting
If checked, a warning dialog requesting confirmation is displayed by the table before rows are deleted.
Row insertion
This option determines the method used in the table to insert new rows:
disabled
new rows cannot be inserted by the table.
no empty row
the table will not have an empty row for insertion at its end. New rows can be inserted only by the Ins key, or another dispel outside the table inserting new rows can be added (button etc.). Rows are thus inserted directly without a candidate row.
immediate
when the user inserts a row into the table, the row is immediately inserted into the edited sequence, too. Values are entered directly into rows that have been thus inserted into the sequence.
using candidate
if a new row is to be inserted, a candidate row is created first. It looks like other rows, but there are buttons on its right hand side used to insert the new record or to cancel it without inserting. The candidate can be used to enter data for insertion, but it is not really inserted until the user clicks the insertion button.
auto
automatically selects between candidate and immediate inserting. Immediate inserting is used if the table is subordinated to another sequence editor or to another table and is already located in another parent candidate. (That is, nested sequences in a candidate do not create further candidates).
Row marking
Row marking mode:
disabled
rows cannot be marked.
enabled
rows can be marked; the selection is canceled when the table is deactivated.
persistent
rows can be marked; the selection persists even if the table is deactivated.
Disable dragging rows by mouse
If checked, an unmarked row cannot be dragged by the mouse nor copied via clipboard. To perform a copy/move operation, the user has to mark the row first. This may be useful if row dispels are more complex and their dragging would appear confusing.
Definition type: Table_def