Oracle Forms Developer – Form Builder Reference, Volume 1

Visible property
Description
Indicates whether the object is currently displayed or visible. Set Visible to Yes or No to show or hide a
canvas or window.
Applies to canvas, window
Set programmatically
Refer to Built-in
• GET_VIEW_PROPERTY
• GET_WINDOW_PROPERTY
• SET_VIEW_PROPERTY
• SET_WINDOW_PROPERTY
Default
TRUE
Usage Notes
• You cannot hide the canvas that contains the current item.
• You can hide a window that contains the current item.
NOTE: In some operating systems, it is possible to hide the only window in the form.
• When you use GET_WINDOW_PROPERTY to determine window visibility, Form Builder uses the
following rules:
• A window is considered visible if it is displayed, even if it is entirely hidden behind another
window.
• A window that has been iconified (minimized) is reported as visible to the operator because even
though it has a minimal representation, it is still mapped to the screen.
• When you use GET_VIEW_PROPERTY to determine canvas visibility, Form Builder uses the
following rules:
• A view is reported as visible when it is a) in front of all other views in the window or b) only
partially obscured by another view.
• A view is reported as not visible when it is a) a stacked view that is behind the content view in the
window or b) completely obscured by a single stacked view. Note that a view is reported as visible
even if it is completely obscured by a combination of two or more stacked views.
• The display state of the window does not affect the setting of the canvas VISIBLE property. That is,
a canvas may be reported visible even if the window in which it is displayed is not currently mapped
to the screen.
341