Oracle Forms Developer – Form Builder Reference, Volume 1

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 Form Builder 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 Form Builder 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, Form Builder will
immediately undo the replacement to keep the focus item visible to the end user.
REPLACE_CONTENT_VIEW examples
338
/*
** Built-in: REPLACE_CONTENT_VIEW
** Example: Replace the ’salary’ view with the ’history’
** view in the ’employee_status’ window.