Working with the Raise on Entry Canvas Property
The canvas property Raise on Entry determines how stacking order is affected by navigation (by the end user or the application) to an item on the canvas. If you set Raise on Entry to:
- No, Oracle Forms raises the canvas to the front of the window only if
the target item is hidden behind another canvas in that same window (when
the end user or application navigates to an item on that canvas.
- Yes, Oracle Forms raises the canvas to the front of the window whenever
the end user or the application navigates to an item on that canvas. (Be careful
about setting Raise on Entry to Yes for a content canvas; since a content
canvas occupies the entire content area of its window, it always will obscure
any stacked canvases when Oracle Forms raises it to the front of the canvas
stack.)
Stacked Canvases
Setting the Raise on Entry property for a stacked canvas can be tricky. To get it right, you may have to consider window interaction, default navigation, stacking order, and programmatic manipulation of windows and canvases.
A stacked canvas with Raise on Entry property set to No can be displayed only through navigation or programmatic control.
Recall that when an end user (or your application) navigates to an item on the stacked canvas, Oracle Forms displays the canvas in its assigned window. But a window also can be shown programmatically, or in response to navigation to an item on the window's content canvas. In these situations, you must set Raise on Entry to Yes so Oracle Forms will display the stacked canvas when the window is first displayed.
Note that a stacked canvas with its Raise on Entry property set to Yes might still be hidden in the following situations:
- If the stacked canvas' position in the stacking order places it behind a
content canvas or other stacked canvas in the same window.
- If the window is displayed because of navigation to an item on another of
its canvases, Oracle Forms will hide the stacked canvas if it overlaps
the target item. (Oracle Forms at first displays the stacked canvas, then
immediately raises the target canvas in front of the stacked canvas so that
the target item visible.)
- If the window is displayed because of navigation to an item on another of
its canvases, and the target canvas has Raise on Entry set to Yes, Oracle Forms
will raise the target canvas in front of the stacked canvas, even if the stacked
canvas does not overlap the target item.
Related topics
HIDE_VIEW Built-in
SET_VIEW_PROPERTY Built-in
SHOW_VIEW Built-in