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

Defining a Primary Canvas

To define the primary canvas for a window, set its Primary Canvas property to the desired canvas. Oracle Forms displays a window with its primary canvas when the window is being displayed programmatically, rather than in response to a navigation event.

When to Set the Primary Canvas Property

Setting the Primary Canvas property is optional. Most windows are displayed in response to navigation to an item on a specific canvas. In such cases, setting the Primary Canvas property is not required, since the canvas to be displayed is never ambiguous.

The first time you display a window during a session by using the SHOW_WINDOW Built-in, Oracle Forms displays the window with its primary canvas. If the Primary Canvas property is left unspecified, the window is displayed without a view, and appears empty.

You also might want to set the Primary Canvas property in the situation when a window is displayed due to navigation to an item on a stacked canvas. If you want the window's content canvas to be displayed behind the stacked canvas, you must set the Primary Canvas property accordingly.

Oracle Forms always displays the target item and canvas during a navigation event. So even if you have set the Primary Canvas property to specify a primary canvas, Oracle Forms will display a different canvas if necessary to make the target item visible.


SHOW_WINDOW Built-in