Property

Description

Mobile Support

Color

The color of the control taken from the Application Color repository.

When the Set Table Color property is set to Column, this color will be used for the remaining area after the last column. Since version: 3.1

Platform specific:

• On Android and iOS devices, when a system color is used, a white color will be used as the background of 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.

Android, iOS and Windows 10 Mobile

Set Table Color

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

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

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

Platform specific: For Android and iOS devices, only the 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.

• On Android and iOS devices, when a system color is used, the alternate lines will appear white.

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

Android, iOS and Windows 10 Mobile

Title BG Color

Defines the background color of the Table control’s title.

If the setting is defined as 0 (default), the background color will be grey.

Note:

• This setting does not affect the table's borders or separators, which will have the Windows colors.

• This property does not affect the Table control’s title foreground color. The foreground color is taken from the column's Color property

Since version: 3.1 (Android and iOS support – Since version: 3.0)

Android, iOS and Windows 10 Mobile

Divider Color

Defines the color of the column dividers and line dividers. The dividers will appear using the color's Foreground value.

For the column divider, this property affects the color of both the divider on the column title and the divider in the lines area.

If the column divider is not shown, this property affects the line color of the column divider in the title.

If the line divider is not shown, this property does not affect the line divider.

This property does not affect the border color of the table. To change the table's border color, use the Border Color property.

Since version: 3.1

Windows 10 Mobile

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

Android, iOS and Windows 10 Mobile

Border

Specifies whether the control will have a border.

Online support: Since version: 2.0

Android and iOS support: Since version: 2.2a

Android, iOS and Windows 10 Mobile

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, iOS and Windows 10 Mobile

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 = False, 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.

Platform specific: For Windows 10 Mobile devices, the Highlight style is not supported. However, there is a default highlight style. This style will only affect Edit controls and will not affect the FG 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.

Platform specific: For Windows 10 Mobile devices, only the background color will be used.

Android, iOS and Windows 10 Mobile

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 Designer.

Android, iOS and Windows 10 Mobile

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, iOS and Windows 10 Mobile

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.

Fill Width

Specifies whether the columns will be spread over the width of the entire table. This lets you automatically resize the other columns if a column gets hidden or visible or if a vertical scroll bar appears.

This property does not change the width of the table.

If this property is set to True, then:

• When the form is loaded, if the table has a blank area, the placement will be done and the columns will occupy the entire width of the table (except for the vertical scrollbar area).

• When a column gets hidden or visible, the rest of the columns will be resized (according to the column’s placement) on the entire table width.

• If the table has a horizontal scrollbar and you hide a column then:

• • If after hiding the column there is still a horizontal scrollbar, no resize will occur.

  • If after hiding the column there is empty space in the table, the placement will take place.

• When a column becomes visible then:

• • If the table has a horizontal scroll bar, the column will be added without affecting other columns.

  • If the table does not have a horizontal scroll bar, the rest of the columns will be shortened (according to the placement values) and the new column will be added so that all the columns will occupy the table width.

Note: In version 1.9, for non-Windows tables with Keep Width=Yes, only the nearest column was resized. In Magic xpa 3.1 and above, all of the columns take part in the placement mechanism.

Since version: 3.1

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.

Multi Column Display

Specifies whether or not controls can exceed their column.

False means that the controls in the table will be cut at the end of the column (as in Magic xpa 3.0).

True means that the controls in the table can be shown on multiple columns (as in uniPaaS 1.9).

Since version: 3.1a