Table Controls (Magic xpa 3.x)

Table controls have two parts: Title area and Repeated area, in which the lines of the table appear.

When you resize a form grid that has a Table control, the Table control resizes accordingly. For Horizontal placement, the Table control has the Placement property that controls the resizing percentage for the table. For example, if the Placement property is set to 80%, and the size of the form is increased by 10 pixels, then the size of the Table control is increased by 8 pixels.

For Vertical placement, the Table control will display additional or fewer rows according to how the form is resized. The Table control displays empty rows when no more data is available. The parked Table Control row is always displayed.

Drag-and-drop operations can be performed for the selected text in the Table control. For a Table control with marked records, the Drag Begin event is raised for every marked record. Magic xpa identifies the Drag operation and does not open the Edit mode when the mouse’s left button is clicked and held.

The Table control properties are listed by categories:

General

Details

Input

Appearance

Mobile

Navigation

Note:

Add Column and Remove Column links are available at the bottom of the property sheet. You can also add columns by dropping controls on the table and you can remove columns by selecting them and pressing the Delete key. Since version: 3.0

Note:

• To select a column, press on the column header or press Alt+Click.

• To select all of the controls on a table without the table itself, do one of the following (Since version: 3.1):

• Press Shift+Click on the table.

• Click on the table, then click on the action arrow on the top right side of the Table control and choose the Select attached controls option.

• Click on the table, then click the Select attached controls link at the bottom of the property sheet.

• Only one Table control is allowed on a form. Therefore, the Table control icon on the Toolbox will be dimmed when there is a Table control on the form.

• All controls placed on a Table control must be attached to the control. Otherwise they will be shown behind the Table control.

• In Display forms, if you drop a control on the table or move it with the mouse to the table area, the control will be automatically attached to the table. If you want the control to appear behind the table, you should drop it on the form and move it behind the table using the arrow keys.

• In Output forms, if you drop a control on the table, it is automatically attached. If you drop it outside the table and then move it to the table area, it is not attached to the table (and will be seen behind the table) and you need to attach it manually (Drawing menu > Attach to Table).

• In Magic xpa, when using a Table control in a Class > 0 form, the detail area is duplicated for each printed line. This is unlike Class = 0 forms (GUI Display) where the number of lines is fixed and the end user can scroll between the records. This behavior allows us to print data in table format without having to deal with the table design.

• The following controls cannot be linked to a Table control: .NET, Browser, List Box, Radio Button, and Tab.

• For Display forms, a Table control cannot be placed on a Tab control using the mouse (Since version: 3.0). If you want to have a Table control on a Tab control, place the Table control on the form and move it onto the Tab control using the arrow keys. However, the controls will not be linked.

Platform Specific

For mobile devices, horizontal scrolling is not supported in Table controls. If you need to scroll the table in a specific form area, place the table in a subform so the scrolling will be done on the subform area.

For Windows 10 Mobile devices:

• Row selection color is not supported, but the row color will be taken from the system accent color. The accent color can be changed via the device's System->Personalization->Colors.

• Highlight style is not supported. There is a default highlight style. This style will only affect Edit controls and will not affect the FG color.

• Line controls cannot be used on the Table control.

• Sorting is currently not supported.

• Using a date or time picker on Table controls will slow down performance.

Runtime Behavior

Rich Client and Browser tables allow you to scroll through the records without leaving the selected record. You do this by using the tables' scroll bar, the mouse wheel, or the context menu on the mouse wheel.

In addition, you can use Ctrl+PgUp/PgDn to set the selected record to be the first/last record of the current visible records.

Related Topics

Browser Table Control Properties

Column Properties