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

POPULATE_GROUP_FROM_TREE Built-in

Description

Populates a record group with the data from the hierarchical tree.

Syntax

PROCEDURE POPULATE_GROUP_FROM_TREE
(group_name VARCHAR2,
item_name VARCHAR2,
node FTREE.NODE);

PROCEDURE POPULATE_GROUP_FROM_TREE
(group_name VARCHAR2,
item_id ITEM,
node FTREE.NODE);

PROCEDURE POPULATE_GROUP_FROM_TREE
(group_id RECORDGROUP,
item_name VARCHAR2,
node FTREE.NODE);

PROCEDURE POPULATE_GROUP_FROM_TREE
(group_id RECORDGROUP,
item_id ITEM,
node FTREE.NODE);

Built-in Type unrestricted procedure

Enter Query Mode no

Parameters

group_name

Specifies the name of the group.

group_id

Specifies the ID assigned to the group.

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.

node

Specifies a valid node. If specified, indicates a sub-tree used to populate the RecordGroup, including the specified node.

Usage Note

POPULATE_GROUP_FROM_TREE Example

/*
   
** Built-in: POPULATE_GROUP_FROM_TREE 
*/
-- This code will transfer all the data from a hierarchical tree
-- that is parented by the node with a label of "Zetie" to a
-- pre-created record group.
   
DECLARE 
  htree      ITEM;  
  find_node   NODE; 
BEGIN
  -- Find the tree itself.  
  htree := Find_Item('tree_block.htree3');    

  -- Find the node with a label "Zetie".  
  find_node := FTREE.FIND_TREE_NODE(htree, 'Zetie', FTREE.FIND_NEXT, FTREE.NODE_LABEL, FTREE.ROOT_NODE, FTREE.ROOT_NODE);    

  -- Populate the record group with the tree data.  
  -- The record group must already exist.  
  FTREE.POPULATE_GROUP_FROM_TREE('tree_data_rg', htree, find_node);  
END;