Refresh When Hidden Property (Magic xpa 4.x)

Magic xpa provides the Refresh When Hidden control property, which governs the subform initialization and automatic refresh timing.

When this property is set to Yes, there is no difference whether or not the subform is visible, meaning:

• The subform's task initialization will be executed after the Record Prefix of the first record in the data view.

• The subform refresh will be done according to the Automatic Refresh property.

When this property is set to No, the subform's task initialization and automatic refresh will only happen if the subform is visible. This means that:

• Before executing each subform's task, its visibility will be checked and if it is invisible, the subform's task will not execute, and will be deferred. Once the client requires the subform to be displayed, there will be a call to the server, and the subform's task will be displayed for the first time.

• The execution of the subform's Task Prefix will also be deferred to the first time that the subform is visible.

• If the subform's visible expression is a client-side expression, then when the task loads, the subform will be regarded as visible.