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

SET_TREE_NODE_PROPERTY Built-in

Description

Sets the state of a branch node.

Syntax

PROCEDURE SET_TREE_NODE_PROPERTY
(item_name VARCHAR2,
node FTREE.NODE,
property NUMBER,
value NUMBER);

PROCEDURE SET_TREE_NODE_PROPERTY
(item_name VARCHAR2,
node FTREE.NODE,
property NUMBER,
value VARCHAR2);

PROCEDURE SET_TREE_NODE_PROPERTY
(item_id ITEM,
node FTREE.NODE,
property NUMBER,
value NUMBER);

PROCEDURE SET_TREE_NODE_PROPERTY
(item_id ITEM,
node FTREE.NODE,
property NUMBER,
value VARCHAR2);

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.
node
Specifies a valid node.
property

Specify one of the following properties:

NODE_STATE Possible values are EXPANDED_NODE, COLLAPSED_NODE, and LEAF_NODE.

NODE_LABEL Sets the label of the node.

NODE_ICON Sets the icon of the node.

NODE_VALUE Sets the value of the node.

 
value
 
The actual value you intend to pass.

SET_TREE_NODE_PROPERTY Example

This code could be used in a WHEN-TREE-NODE-SELECTED trigger to change the icon of the node clicked on.

/*

** Built-in: SET_TREE_NODE_PROPERTY
*/

DECLARE
htree ITEM;
current_node FTREE.NODE; 
find_node FTREE.NODE; 
BEGIN
-- Find the tree itself. 
htree := FIND_ITEM('tree_block.htree3');   
-- Change the icon of the clicked node. 
-- The icon file will be located  
-- in the virtual directory. 
FTREE.SET_TREE_NODE_PROPERTY(htree, :SYSTEM.TRIGGER_NODE, Ftree.NODE_ICON, 'Open'); 
END;