Handling the cells of report table

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Controls

Array control

Handling the cells of report table

Handling the table cells

Selecting a table element

Adding a cell or a column into a table

Resizing a table cell

Moving a table column

Removing or deleting a column from a table

See also

The tables in a report

Handling the cells of report table

Handling the table cells

The table cells can be handled individually or via the table description.

The individual operations that can be performed on the table cells are as follows:

Selecting a table element.
Displaying the table description.
Adding a cell into a table.
Adding a column into a table.
Resizing the table cells.
Moving the table columns.
Deleting cells from the table.

Remark: All types of controls available in the report editor can be displayed in a table column.

Selecting a table element

To select:

a table cell: click the cell once. The selection handles appear around the column cells.
a table column:
- click a column cell twice successively. The selection handles appear around the column cells.
- hover the header of the column and click when the cursor turns into a vertical black arrow (pointing down). The selection handles appear around the column cells.
a table row: hover the left side of the row and click when the cursor turns into an horizontal black arrow (pointing to the right). The selection handles appear around the row cells.
all the table cells: click a cell three times successively. The selection handles appear around all the table cells.

Displaying the table description

By default, when a cell of a table is double-clicked, the cell description window appears.

To display the table description, perform one of the following actions:

select a cell and select "Table description" from the popup menu.
select a cell, then go to the "Modification" tab, click the dialog box launcher of the "Table" group.
click a cell three times successively (all table cells are selected) and double-click.

Adding a cell or a column into a table

Adding a cell

All types of controls available in the report editor can be added into a table. These controls can:

replace an existing cell in the table.
be added to a column (a calculation added at the bottom of column for example).

To add or replace a cell in a table:

Select the control that must be added to the table.
Select "Add to table" in the context menu of control. A wizard starts.
Select "Add to an existing column".
Select the column where the addition will be performed as well as the control position in the column (header, data or total).
Validate the cell addition.

Adding a column

You have the ability to add a column to a table. This new column may (or may not) correspond to an existing control.

To add an existing control into a table as column:

Select the control.
You can choose to:
- Drag and Drop the control to the table. After confirmation, a new column is created after the existing columns. The description of the cells found in this new column corresponds to the initial control.
- select "Add to table" in the context menu of control. A wizard allows you to specify the characteristics of this new column.

To insert a new column:

You can:
- select "Insert a column" from the popup menu of the table.
- on the "Creation" pane, in the "Structure" group, click "Table column".
Type the header caption of new column.
Select (if necessary) the item linked to the new column and validate the addition of the new column.

Resizing a table cell

The entire table is resized when a table cell is resized in the report editor.

Two cases may occur:

Modifying the width of a cell:
All the cells found in the column will also be resized.
All the columns found after the column currently resized will be moved.


Before the resize operation	After the resize operation

Modifying the height of a cell:
All the table cells found on the same row will be resized.


Before the resize operation	After the resize operation

To resize a cell:

Select the corresponding cell in the editor. Black handles appear around the cell.
Hover the black handle corresponding to the side to resize. When the mouse cursor turns into a double arrow, keep the left mouse button down and resize the cell.
Release the left mouse button. The resizing is performed.

Remark: Border of the block and border of the cell
A cell can be stuck to a report block. In this case, when the cell is resized, the block will be automatically resized or not according to the cursor displayed.
The mouse cursor differs according to the element to resize:

a small double black arrow indicates that the cell is currently resized.
a large double blue arrow indicates that the block and the cell are currently resized.

Moving a table column

Moving the table columns consists in modifying the order in which the columns are displayed in the table.

Several methods can be used to move the table columns:

in the report currently modified: select a column cell and use the keyboard arrows (or select "Move to..." from the popup menu of the cell).
from the table description window: the arrow buttons are used to move the selected column.
"Drag and Drop" a column cell in the editor.

Removing or deleting a column from a table

A column found in a table can be:

removed from the table: the column cells are no longer associated with the table. These cells remain in the report and they can be handled independently of the table.
deleted: the cells are no longer present in the table nor in the report.

Removing a column from the table

To remove a column from the table:

Select one of the cells in the column to delete (see Selecting a table cell).
Use one of the following methods:
- select "Remove from table" from the popup menu of the cell.
- on the "Modification" tab, in the "Table" group, click "Remove from table".
  Remark: If the column to remove is not located on the left extremity of the table, the report editor proposes to automatically move the column at the beginning of the table before removing it.
The different cells found in the column are independent and they can be moved in the report.

Deleting a column from the table

To delete a column from the table:

Select one of the cells in the column to delete: Column header or data control.
Use one of the following methods:
- press the Del key on the keyboard.
- select "Delete" from the popup menu of the cell.
- on the "Modification" pane, in the "Table" group, click "Delete column".
- select "Delete" in the table description window.
The column containing the cell is deleted from the table.

Remark: If you select a cell that belongs to the total row, the column will not be deleted when this cell is deleted (only the cell will be deleted).