REPLACE_CONTENT_VIEW Built-in
Description
Replaces the content canvas currently displayed in the indicated window with a different content canvas.
Syntax
PROCEDURE REPLACE_CONTENT_VIEW
(window_id Window,
view_id ViewPort);
PROCEDURE REPLACE_CONTENT_VIEW
(window_name VARCHAR2,
view_id ViewPort);
PROCEDURE REPLACE_CONTENT_VIEW
(window_id Window,
view_name VARCHAR2);
PROCEDURE REPLACE_CONTENT_VIEW
(window_name VARCHAR2,
view_name VARCHAR2);
Built-in Type unrestricted procedure
Enter Query Mode yes
Parameters
- window_id
-
- Specifies the unique ID that Oracle Forms assigns the window when created.
Use the FIND_WINDOW Built-in to return the ID to an appropriately typed variable.
The data type of the ID is Window.
-
- window_name
-
- Specifies the name that you gave the window when creating it. The data type
of the name is VARCHAR2.
-
- view_id
-
- Specifies the unique ID that Oracle Forms assigns the view when it creates
the object. Use the FIND_VIEW Built-in to return the ID to an appropriately
typed variable. The data type of the ID is ViewPort.
-
- view_name
-
- Specifies the name that you gave the object when defining it. The data type
of the name is VARCHAR2.
REPLACE_CONTENT_VIEW Restrictions
- The canvas that replaces the window's current content canvas must have been
assigned to that window at design time. That is, you cannot replace a window's
content view with a content view from a different window.
- If you replace a content canvas that contains the item that currently has
focus, Oracle Forms will immediately undo the replacement to keep the focus
item visible to the end user.
REPLACE_CONTENT_VIEW Examples
/*
** Built-in: REPLACE_CONTENT_VIEW
** Example: Replace the 'salary' view with the 'history'
** view in the 'employee_status' window.
*/
BEGIN
Replace_Content_View('employee_status','history');
END;