Oracle Forms Developer – Form Builder Reference, Volume 1

FIND_VIEW built-in
Description
Searches the list of canvases and returns a view ID when it finds a valid canvas with the given name.
You must define an appropriately typed variable to accept the return value. Define the variable with a
type of ViewPort.
Syntax
FUNCTION FIND_VIEW
(viewcanvas_name VARCHAR2);
Built-in Type unrestricted function
Returns ViewPort
Enter Query Mode yes
Parameters
viewcanvas_name Specifies the VARCHAR2 name of the canvas.
FIND_VIEW examples
/*
** Built-in: FIND_VIEW
** Example: Change the visual attribute and display position
** of a stacked view before making it visible to
** the user.
*/
DECLARE
vw_id ViewPort;
BEGIN
vw_id := Find_View(’Sales_Summary’);
Set_Canvas_Property(’Sales_Summary’, VISUAL_ATTRIBUTE,
’Salmon_On_Yellow’);
Set_View_Property(vw_id, VIEWPORT_X_POS, 30);
Set_View_Property(vw_id, VIEWPORT_Y_POS, 5);
Set_View_Property(vw_id, VISIBLE, PROPERTY_TRUE);
END;
141