Hiding A Window Or Disabling A Control

Subchapters

Hiding A Window Or Disabling A Control

Syntax	`hide(`caption`) hide(`handle`)`
See Also	show , iconify

Description
If caption is a character row vector, hides the window with the specified caption . If caption is "toolbar" and no such window exists, the O-Matrix toolbar is disabled (i.e., grayed out). If caption is "omatrix" then the entire O-Matrix application is hidden. That is no user interface or icon appears on the desktop.

Note that when running the O-Matrix VM (The re-distributable run-time engine provided with the O-Matrix Development Kit), the O-Matrix startup state is to be displayed. For many applications in which you have provided the desired end-user interface it is desirable to run O-Matrix hidden,




     show("omatrix")

If handle is an integer column vector with two elements, the control specified by handle is disabled (i.e., grayed out), where handle is the value returned by the call to addcontrol that created the control. Controls with the bitmap style cannot be disabled.

Caption Example
If you enter




     hide("Graphic 0")

the default graphics window will disappear. You can use




     show("Graphic 0")

to make the window reappear.

Handle Example
The following program creates a dialog window with a push button labeled "Disable". When the button is pressed, it is disabled and cannot be activated again. The dialog can be deleted using the control on its caption bar.






clear

#

Caption  = "Test Dialog"

geometry = [100, 100, 150, 100]

callback = "delwin(Caption);"

adddialog(Caption, geometry, callback);

#

geometry = [40, 20, 70, 20]

name     = "Disable"

callback = "hide(Handle);"

Handle   = addcontrol(Caption, geometry, "pushbutton", name, callback)