Subform Controls (Magic xpa 3.x)
You can use the Subform control to integrate a task form into the form of another task, while maintaining the subform's task data handling and record cycle activities as independent of the parent task.
You cannot define a Control logic unit or an Event logic unit for a Subform control.
The Subform control properties are listed by categories:
General
Details
Appearance
Mobile
Parking
Navigation
Since version: Android and iOS support – 2.2a
You can park on the line of a parent task and see the details from the subtask, for a one-to-many task relation.
Magic xpa automatically refreshes the Subform data view according to the parent task only when passing parameters.
Magic xpa retains your last position in the Subform data view when you leave and reenter.
A tab cycle is provided for the Subform task.
You can jump to the called program or task by right-clicking on the control and selecting Go to Object (Ctrl+F5). Once you are done, you can return to the previous program or task by right-clicking and selecting Return to Object (Ctrl+Shift+F5).
A Subform control works only with interactive tasks, which means that the subform will not be active for the Main or Batch program.
A Subform control behaves like a child window task, but also permits event activation from a parent task and automatically relocates to the last record when the focus is returned to the subform.
The runtime engine automatically handles the navigation between the parent task and the called task displayed in the subform.
The runtime engine automatically refreshes the subform view when any of the passed arguments to the called task are changed.
The subform task is initially executed as the first Record Prefix operation of the parent task.
In Online tasks, all of the subform fields are treated as one control.
The runtime engine executes the subtask’s prefix operations and Record Prefix operations, creates the subtask data view, and executes the Record Suffix operations and subtask’s suffix operations.
|
Note:
|
When the called task has an XML table as the Main Source, it should also be declared in the current task (where the subform is declared).
|
Offline Tasks
Browser Subform Control Properties
Preset Properties
Subform Functions
Subform Refresh Event
Handlers for Subforms
Subform's Runtime Behavior
Keyboard Access to Subforms
Subforms chapter in the Mastering Magic xpa guide
How Do I Associate a Task to a Specific Tab in a Tab Control?
