VISIBLE property [Revelation On-Line Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== VISIBLE property ======


 
==== Applies To ====
 
All controls.  The System Monitor.
 
==== Description ====
 
Returns or sets visibility status of specified control. If true, the control is visible at run-time. If false, the control is invisible at run-time
 
==== Usage ====
 
//visiblestate// = **Get_Property**(//objectname//, "**VISIBLE**")

//existingstate// = **Set_Property**(//objectname//, "**VISIBLE**", //visiblestate//)
 
==== Remarks ====
 
The visiblestate value passed to [[set_property|Set_Property()]] can be any of the valid show-window states, (those states accepted by the Windows API function //ShowWindow//). For example, the Windows SDK file "windows.h" defines SW_RESTORE as 9; this value restores a minimized window to its previous size, equivalent to the "Restore" choice on the Window's system menu.

Note:  To hide a menu item, set its visible property to 0.  A top level menu (on the menu bar) cannot be hidden this way.  To hide it, set its [[text|TEXT property]] to null.
 
==== Returns ====
 
Values returned by Get_Property and Set_Property:

^Value^Description^
|//visiblestate//|0=Hidden.\\ 1=Visible.\\ 2=Minimized.\\ 3=Maximized.|
|//existingstate//|Visibility status, when [[set_property|Set_Property()]] was run.|
 
==== See Also ====
 
[[redraw|REDRAW property]], [[size|SIZE property]]

==== Example ====

Making Menu Items Invisible: On a window, under the TOOLS menu bar item are menu items called TOOLS1, TOOLS2, TOOLS3, and TOOLS4.  To hide these menu items, set the VISIBLE property to 0. Do this in the [[create_event|CREATE event]]


<code>
declare subroutine Set_Property

for i = 1 to 4

  Set_Property(@window: ".MENU.TOOLS.TOOL": i, "VISIBLE", 0)

next i
</code>