ChildPanelOnRelativReturn()

Opens a child panel with a return value, relative to the calling object.

Synopsis

ChildPanelOnReturn(string FileName, string PanelName, dyn_string Parameter, int x, int y, dyn_float &resultFloat, dyn_string &resultText, time timeout=86400);

Parameters

Parameter Meaning
FileName File name of the child panel to be opened
PanelName Name under which the child panel is to be displayed
Parameters Parameters for transfer to the child panel
x, y Position of the child panel
resultFloat Return field for floats
resultText Return field for strings
timeout Optional timeout for the panel, default 1 day. 0 = no timeout. If the user does not close the panel, the function returns the value anyway after the specified timeout.

Return Value

Depending on the parameters set, see standard dialogs for an example.

Description

Opens a child panel with return values. The position of the panel is relative to the calling object, the coordinates are specified via offsetX and offsetY. The return values are handled in the same way like ChildPanelOnReturn()ChildPanelOnReturn(). Before the panel is opened a check is made as to whether this panel is already open (isPanelOpen()). The size ratio between child and parent panel is 1 (scale = 1). If the size of the parent panel is changed, the child panel is not scaled to the new size. See chapter ChildPanelOnRelativModalReturn() for an example.

A child panel can not be resized. The only exception to this is the use of Layout Management in the child panel.

This function cannot be used in panel events.

Assignment

panel.ctl

Availability

UI