Hide
PowerScript function
Description
Makes an object or control invisible. Users cannot interact with an
invisible object. It does not respond to any events, so the object is
also, in effect, disabled.
Applies to
Any object
Syntax
|
1 |
objectname.Hide ( ) |
|
Argument |
Description |
|---|---|
|
objectname |
The name of the object or control you want to make |
Return value
Integer.
Returns 1 if it succeeds and -1 if an error occurs. If objectname is
null, Hide returns null.
Usage
If the object you want to hide is already invisible, then Hide has
no effect.
You cannot use Hide to hide a drop-down or cascading menu or any
menu that has an MDI frame window as its parent window. Nor can you hide a
window that has been opened as an MDI sheet.
You can use the Disable function to disable menu items, which
displays them in the disabled color and makes them inactive.
To disable an object so that it does not respond to events, but is
still visible, set its Enabled property.
You can set an object’s Visible property instead of calling
Hide:
|
1 |
objectname.Visible = false |
This statement:
|
1 |
lb_Options.Visible = FALSE |
is equivalent to:
|
1 |
lb_Options.Hide() |
Examples
This statement hides the ListBox lb_options:
|
1 |
lb_options.Hide() |
In the script for a menu item, this statement hides the
CommandButton cb_delete on the active sheet in the MDI frame w_mdi. The
active sheets are of type w_sheet:
|
1 2 3 |
w_sheet w_active w_active = w_mdi.GetActiveSheet() IF IsValid(w_active) THEN w_active.cb_delete.Hide() |
See also