{STRETCH}

Syntax

{STRETCH=[Horizontal],[Vertical]

Argument	Type	Description
Horizontal	C	Optional. The allowed values are: "Left", "Right", and "Width".
Vertical	C	Optional. The allowed values are: "Top", "Bottom", and "Height".

Description

The {STRETCH} command allows the dialog box to be stretched. It requires at least one argument. In the absence of the {STICKTO} command, it will affect control and region placement. When the arguments are Width or Height, the object will be stretched along with the dialog box. The other arguments will cause the dialog to stretch away from the control in the specified direction.

When the {STICKTO} command is added, the {STRETCH} command does not affect control or region placement.

Version 6 Note

If you have this command:

{stretch=width}{stickto=bottom}

In v6 it is interpreted as : {stretch=width,top}, which will give you the intended result. Similarly, if you have:

{stretch=width,height}{stickto=bottom}

This is interpreted as: {stretch=width,height,top}.

Version 5 Note

If you have this command:

{stretch=width}{stickto=bottom}

would be interpreted as: {stickto=bottom}, which is not what you would have intended. Similarly, in V5, the commands:

{stretch=width,height}{stickto=bottom}

would be interpreted as: {stickto=bottom}.

Supported By

Alpha Five Version 5 and Above

Limitations

Desktop applications only

Example

ui_dlg_box("Stretch",<<%dlg%

{stretch=height,width}

<Ok>

%dlg% )

[Picture]