%TB_TKCREATE

Create and log a toolbar with the environment

WSupported on Windows

 

 

 

tbid = %TB_TKCREATE([orientation], [width], [height], [D_NOPLC][, D_GLOBAL])

or

xcall TB_TKCREATE([orientation], [width], [height], [D_NOPLC][, D_GLOBAL])

tbid

On Windows, the ID of the toolbar created by this function. On Unix, always returns false. On OpenVMS, always returns true. (^VAL)

orientation

(optional) The toolbar’s position in the application container. TBC_TOP (default), TBC_BOTTOM, TBC_LEFT, TBC_RIGHT. (n)

width

(optional) The width of the toolbar in pixels. Pass this when placing the toolbar on the left or right side of the container (which places the toolbar vertically). (n)

height

(optional) The height of the toolbar in pixels. Pass this when placing the toolbar on the top or bottom of the container (which places the toolbar horizontally). (n)

D_NOPLC

(optional) The no-placement flag; the toolbar will not be placed until you place it with the TB_PLACE subfunction of %TB_TOOLBAR. If not passed, it is placed immediately. (n)

D_GLOBAL

(optional) The global toolbar flag; the toolbar is logged at the global environment level. If not passed, the toolbar is logged at the current environment level. (n)

%TB_TKCREATE creates a toolbar and logs it with the current environment.     

Note

Once a toolbar has been assigned to an environment, you must leave the management of the toolbar to Toolkit. Use TB_TKDEL if you want to explicitly delete the toolbar.