Property

Description

Mobile Support

Color

The color of the control taken from the Application Color repository. This property is enabled only when the Set table Color is set to By Table.

Platform specific:

• On mobile devices, when a system color is used it will show the operating system's default color for the control.

• On Android, using a transparent color in a Table control or in any control attached to it is not recommended since it will slow down the performance.

All

Set Table Color

Specifies whether to set the background color for each column or for the entire table.

When By Column is selected, the column's color will be according to the Color property in each of the columns.

When By Table is selected, the Table control's color will be according to the Color property.

Platform specific: For Android and iOS devices, only the By Table option is supported.

Alternating BG Color

The color of an alternating row for a table. The default value is zero (0). Magic xpa accepts zero as a valid value. This property does not support a dynamic value used in an expression. The Alternating BG Color property is disabled when the Set Table Color property is set By Column.

In runtime, the row background switches from the table color to the alternating color from one record to another. In the order of appearance, odd records display the table color and even records display the alternate color. When records are added or deleted, the background color of the affected records change depending whether they have become even or odd. When the table is not full, the table color and alternate color are displayed for the remaining rows.

Platform specific: On Android devices, using an Alternate color is not recommended since it will slow down the performance.

See also How Do I Show a Table Control with Alternating Colors?

All

Tooltip

Specifies whether a Tooltip is associated with this control. A number specifies the number of the Tooltip Help in the Help list.

You can enter an expression for a Tooltip so that the Tooltip is dynamic. You can create the expression in Unicode format.

Visible

All

Border

Specifies whether the control will have a border.

Online support: Since version: 2.0

Android and iOS support: Since version: 2.2a

Android and iOS

Scroll Bar

Specifies whether the Table control has a scroll bar.

Line Divider

Specifies whether the table displays a divider between its rows.

Android and iOS support: Since version: 2.2a

See also How Do I Hide or Show the Table Control Dividers?

Android and iOS

Row Highlight Style

The style by which the table highlights its current row. The available options are:

None – The current row will not be highlighted.

Frame – The current row is highlighted by a rectangular box surrounding the row. The color of the rectangle frame color is the foreground color defined in the Highlight Color property. When the Line Divider = No, the rectangle frame is displayed.

Background – The current row is highlighted by a background color specified in the Highlight Color property.

BG & Controls – The current row is highlighted by a background color just like the Background option. This mode also modifies the color of all controls in the current row to display highlighted color.

Android and iOS support: Since version: 2.3

Android and iOS

Row Highlight Color

The highlight color according to the Row Highlight Style property.

When this property is set to zero (0), the operating system’s default color is used.

Android and iOS

Title Height

The title height of a Table control. You can also set this property by clicking and dragging the lower border of the title bar in the Form Editor.

Android and iOS

Row Height

The row height of a Table control. You can also set this property by clicking and dragging the lower edge of the first row of the table.

Android and iOS

Bottom Position Interval

Specifies how the bottom position of the Table control will be displayed. The options are:

Row Height – The bottom position displays only full rows in the Table control.

None (default) – Partial rows are displayed and the bottom position matches the full height of the table. As you increase the size of the Table control, the table increases pixel by pixel.

This property is available in Online tasks only.

Columns

The number of columns in a Table control. The number of columns can only be changed from the form layout.

Column Divider

Specifies whether the table displays a divider between its columns.

See also How Do I Hide or Show the Table Control Dividers?

Allow Column Resize

Specifies whether to allow the end user to change the size of each column by dragging the adjacent column divider. A column can be resized in two ways:

• Clicking on a column divider and dragging it to a different location – This action modifies the width of the columns on both sides of the divider.

• Clicking on a column divider, pressing the Shift key and dragging it to a different location – This action modifies the width of the column positioned on the left side of the column divider (in RTL projects it will be for the column on right) and the table width will be affected accordingly.

Resizing the column by its right divider will increase the size of the column and push the remaining columns to the right. The remaining columns will maintain their size, so increasing the size of the column will increase the size of the entire table. Though the table will be the same size on the form, fewer columns will be displayed. When the table is resized so that the table columns cannot be displayed together, a horizontal scroll bar will appear for the table.

Allow Column Reorder

Specifies whether the end user can re-order the columns at runtime. When set to Yes, the end user can change the order of the columns by dragging a column by its header by pressing the left mouse button and dragging the column along the table title. When releasing the mouse button, the dragged column is located at the new location, moving the remaining columns to the right.

Multi Marking

Specifies whether to allow the end user to multi-mark various rows displayed in the table, perform user defined logic on all the marked rows, and use the Magic xpa internal Delete operation on all the marked rows.

Note: When the Cache Strategy is set to None, it is not possible to multi-mark records.

This property is available in Online tasks only.