XIConstructContainer function

Unit: XIConstruct

Declaration:

function XIConstructContainer(const Container: TWinControl; aClientRect: TRect;
  aRoot: TxiBaseControlNode; aCanResize: Boolean = True; aExplodeLast: Boolean = False): TRect;

Constructs an UI from a tree-like structure of control nodes using their LayoutControl methods. Container is the container controls should be placed on.

aClientRect is a rectangle on Container, which specifies the zone controls should fit in. If aClientRect equal to xiRect0 then the client area of the Control is used, calculated by the XIGetContainerClientRect function.

aRoot s the root control node the UI will be constructed from.

aCanResize specifies whether the Container will be resized (as a result of call to the XIResizeContainer function) if the next control would not fit into it.

aExplodeLast specifies whether the last control layed on the Control filled the residuary space (if any). Not all control nodes have that capability.

Return value: the resulting rectangle on Container that contaisn all the controls.