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

SET_TREE_SELECTION Built-in

Description

Specifies the selection of a single node.

Syntax

PROCEDURE SET_TREE_SELECTION
(item_name VARCHAR2, 
node NODE, 
selection_type NUMBER);  

PROCEDURE SET_TREE_SELECTION
(item_id ITEM, 
node NODE, 
selection_type NUMBER);  

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.
 
selection_type
 
Specifies the type of selection:

SELECT_ON Selects the node.

SELECT_OFF Deselects the node.

SELECT_TOGGLE Toggles the selection state of the node.

SET_TREE_SELECTION Example

This code could be used in a WHEN-TREE-NODE-EXPANDED trigger and will mark the clicked node as selected. 

/*

** Built-in: SET_TREE_SELECTION
*/

DECLARE
htree ITEM; 
BEGIN
-- Find the tree itself. 
htree := FIND_ITEM('tree_block.htree3');   
-- Mark the clicked node as selected. 
FTREE.SET_TREE_SELECTION(htree, :SYSTEM.TRIGGER_NODE, FTREE.SELECT_ON); 
END;