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

GET_TREE_NODE_PROPERTY Built-in

Description

Returns the value of the specified property of the hierarchical tree node.

Syntax

FUNCTION GET_TREE_NODE_PROPERTY
(item_name VARCHAR2,
node NODE,
property NUMBER);

FUNCTION GET_TREE_NODE_PROPERTY
(item_id ITEM,
node NODE,
property NUMBER);

Returns VARCHAR2

Built-in Type unrestricted function

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.

node

Specifies a valid node.

property

Specify one of the following properties:

NODE_STATE Returns the state of the hierarchical tree node. This is either EXPANDED_NODE, COLLAPSED_NODE, or LEAF_NODE.

NODE_DEPTH Returns the nesting level of the hierarchical tree node.

NODE_LABEL Returns the label

NODE_ICON Returns the icon name

NODE_VALUE Returns the value of the hierarchical tree node.

GET_TREE_NODE_PROPERTY Example

/*

** Built-in: GET_TREE_NODE_PROPERTY
*/
 
-- This code could be used in a WHEN-TREE-NODE-SELECTED
-- trigger to return the value of the node that was
-- clicked on. 
DECLARE
htree ITEM; 
node_value VARCHAR2(100); 
BEGIN
-- Find the tree itself. 
htree := Find_Item('tree_block.htree3');   
-- Find the value of the node clicked on. 
node_value := Ftree.Get_Tree_Node_Property(htree, :SYSTEM.TRIGGER_NODE, Ftree.NODE_VALUE);   
... 
END;