CoCreate OneSpace Designer - Commands Reference Manual

SET_TOOLBOX_MAX_HEIGHT terminate action

SET_TOOLBOX_MAX_HEIGHT sets the maximum height of the TOOLBOX menu.

Syntax


                               +--------------------<-----------------+
                               |                                      |
---->(SET_TOOLBOX_MAX_HEIGHT)--+--(:TOOLBOX)-----|toolbox name|-------+---->
                               |                                      |
                               +--(:HEIGHT)------|max toolbox ht|-----+

Options

The following options are available.

:TOOLBOX - specifies the TOOLBOX as the home menu.
:HEIGHT - specifies the maximum number of buttons in each column.

When to use

Use this action to restrict the size of the TOOLBOX menu area.

Depending on the height you specify, if you have created more buttons than can be displayed at one time, a horizontal scroll button automatically appears at the bottom of the window.

The initial size of the toolbox is 2 columns and 4 rows of buttons. The default maximum height of the toolbox is 6 buttons. Therefore, if you create more than 12 menu buttons, the horizontal scrollbar is automatically displayed.

Example

The following parameter sequence sets a menu height of 2 buttons.

SET_TOOLBOX_MAX_HEIGHT :TOOLBOX "TOOLBOX" :HEIGHT 2 COMPLETE