APP_WINDOW: Window Utilities

The following utilities operate at the window level.

APP_WINDOW.CLOSE_FIRST_WINDOW

Summary 
procedure  APP_WINDOW.CLOSE_FIRST_WINDOW;
Description This call exits the form. It raises FORM_TRIGGER_FAILURE if it fails.

APP_WINDOW.PROGRESS

Summary 
procedure  APP_WINDOW.PROGRESS( percent    number);
Description This call manages all aspects of the progress_indicator object. If it is not already visible, the call opens and centers the window. When the percent >= 99.9, the window automatically closes. For any other percent, the progress bar resizes (with a four inch wide maximum).

Arguments (input)

percent A number between 0 and 99.9, expressing the amount competed.

APP_WINDOW.SET_COORDINATION

Summary 
procedure  APP_WINDOW.SET_COORDINATION(
		event           varchar2,
		coordination    varchar2,
		relation_name   varchar2);
Description This call sets the deferred coordination attribute of a relation to ON or OFF based on the state of the coordination check box. The check box is either "DEFERRED" or "IMMEDIATE."
For a closed window, the relation is always "DEFERRED."
When coordination is set to "DEFERRED," AutoQuery is turned on.

Arguments (input)

event The name of the trigger event (either WHEN-CHECKBOX-CHANGED, WHEN-WINDOW-CLOSED, or OPEN-WINDOW)
coordination IMMEDIATE or DEFERRED. Defaults to IMMEDIATE
relation_name Name of the relation, which is listed in the Oracle Forms Designer under the Block object in the Relation object

See: Master-Detail Relations

APP_WINDOW.SET_WINDOW_POSITION

Summary 
procedure  APP_WINDOW.SET_WINDOW_POSITION(
		child          varchar2,
		rel            varchar2,
		parent         varchar2     default  NULL);
Description This call positions a window in the following styles:

  • CASCADE

  • RIGHT

  • BELOW

  • OVERLAP

  • CENTER

  • FIRST_WINDOW


If the window was open but obscured, this call raises the windows. If the window was minimized, the call normalizes it.
If system resources are low (especially on MS Windows), a warning message appears.

Arguments (input)

child The name of the window to be positioned
rel The style of the window's position
parent Name of the window to relative to which you want to position the child window

See: Non-Modal Windows.

APP_WINDOW.SET_TITLE

Summary 
procedure  APP_WINDOW.SET_TITLE(

	window_name  varchar2, 
	session      varchar2,
	instance1    varchar2 default 'APP_ARGUMENT_NOT_PASSED',
	instance2    varchar2 default 'APP_ARGUMENT_NOT_PASSED',
	instance3    varchar2 default 'APP_ARGUMENT_NOT_PASSED');
Description Use this utility to set the title of a window in the standard format.

Arguments (input)

window_name The name of the window to set the title for
session General session information (for example, Org, Set of Books), no more than 64 characters
instance[1,2,3] Context information from the master record (optional). The combined length should be no more than 250 characters.

See: Non-Modal Windows