A script-enabled browser is required for this page to function properly.

FIND_TAB_PAGE Built-in

Description

Searches the list of tab pages in a given tab canvas and returns a tab page ID when it finds a valid tab page with the given name. You must define a variable of type TAB_PAGE to accept the return value.

Syntax

FUNCTION FIND_TAB_PAGE
(tab_page_name VARCHAR2);

Built-in Type unrestricted function

Returns tab_page

Enter Query Mode yes

Parameters

tab_page_name 
 
The unique tab page name. Datatype is VARCHAR2. (Note: if multiple tab canvases have tab pages with identical names, you must provide a fully-qualified name for the tab page (i.e., MY_TAB_CVS.TAB_PAGE_1).

Usage Notes

If you pass a string to SET_TAB_PAGE_PROPERTY or GET_TAB_PAGE_PROPERTY, it implicitly calls FIND_TAB_PAGE in order to find the page. So, since FIND_TAB_PAGE accepts tab_canvas.tab_page, so do the GET_TAB_PAGE_PROPERTY and SET_TAB_PAGE_PROPERTY.

FIND_TAB_PAGE Example

/* Use FIND_TAB_PAGE to find the ID of the top-most tab

** page on tab canvas TAB_PAGE_1, then use the ID to set
** properties of the tab page:
*/
DECLARE
tp_nm VARCHAR2(30);
tp_id TAB_PAGE;

BEGIN
tp_nm := GET_CANVAS_PROPERTY('tab_page_1', topmost_tab_page);
tp_id := FIND_TAB_PAGE(tp_nm);
SET_TAB_PAGE_PROPERTY(tp_id, visible, property_true);
SET_TAB_PAGE_PROPERTY(tp_id, label, 'Order Info');
END;


Referencing Oracle Forms Objects by Internal ID