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

POPULATE_TREE Built-in

Description

Clears out any data already in the hierarchical tree, and obtains the data set specified by the RecordGroup or QueryText properties.

Syntax

PROCEDURE POPULATE_TREE
(item_name VARCHAR2);

PROCEDURE POPULATE_TREE
(item_id ITEM);

Built-in Type unrestricted procedure

Enter Query Mode no

Parameters

item_name

Specifies the name of the object created at design time. The data type of the name is VARCHAR2 string.

item_id

Specifies the unique ID that Oracle Forms assigns to the item when created. Use the FIND_ITEM Built-in to return the ID to an appropriately typed variable. The data type of the ID is Item.

POPULATE_TREE Examples

/*

** Built-in: POPULATE_TREE
*/

-- This code will cause a tree to be re-populated using
-- either the record group or query already specified
-- for the hierarchical tree.

DECLARE
htree ITEM; 
top_node FTREE.NODE; 
find_node FTREE.NODE; 
BEGIN
-- Find the tree itself. 
htree := FIND_ITEM('tree_block.htree3');   
-- Populate the tree with data. 
FTREE.POPULATE_TREE(htree); 
END;