A script-enabled browser is required for this page to function properly.

Displaying and Closing a Window Programmatically

Displaying a Window

To display a window that does not contain navigable items, you must display it programmatically. For such windows, you also must set the Primary Canvas property to specify the content canvas that you want displayed in the window.

To display a window at runtime, use either the SHOW_WINDOW or SET_WINDOW_PROPERTY Built-in procedures. (When you use SHOW_WINDOW, you have the option to specify X,Y display coordinates. If you do not, Oracle Forms uses the window's current display coordinates.)

When you display a window programmatically, Oracle Forms displays the following canvases in the window:

Closing a Window

To close a window, you can use either the HIDE_WINDOW or SET_WINDOW_PROPERTY Built-in procedures.

The Current Item

When you display and hide windows programmatically, keep in mind that Oracle Forms always keeps the item that currently has focus visible to the end user. If you attempt to programmatically close the window that contains the current item, Oracle Forms ignores the call. If you display a window that obscures the current item, Oracle Forms executes the call, but then immediately raises windows or canvases as necessary to keep the current item visible.

Displaying and closing a window programmatically: Examples

/*

** Example 1: These 2 procedure calls display a window named
** MY_WIN, with equivalent results:

SHOW_WINDOW('my_win');
SET_WINDOW_PROPERTY('my_win', visible, property_true);

** Example 2: This procedure call displays the same window at
** screen coordinates 5 and 10:

SHOW_WINDOW('my_win', 5, 10);

** Example 3: The SET_WINDOW_PROPERTY Built-in sets only one
** window property at a time; you must call it twice to achieve
** the same result as the previous example:

SET_WINDOW_PROPERTY('my_win', visible, property_true);
SET_WINDOW_PROPERTY('my_win', window_position, 5, 10);

** Example 4: These 2 procedure calls close a window named MY_WIN,
** with equivalent results:

HIDE_WINDOW('my_win');
SET_WINDOW_PROPERTY('my_win', visible, property_false);

*/


SET_WINDOW_PROPERTY Built-in

SHOW_WINDOW Built-in