一、樹的簡介
developer 6.0以上版本提供了hierarchy tree(層次樹)的概念,htree控件非常方便,只需要少量的編程即可實現顯示層次結構的目的。
樹的特有屬性中如下幾個較為重要:
l 多項選擇(multi-selection):是否允許一次選中樹的多個節點。如果不允許,那么 選中第二個節點時,第一個被選中的節點會取消選擇。
l 記錄組(record group):指定生成樹的記錄組的名字。
簡單介紹一下跟樹相關的觸發子(built-in):
l function get_tree_node_property (item_name varchar2, node node, property number);
功能:取得樹節點的屬性
其中property有如下幾種:
node_state:expanded_node(擴展節點)
collapsed_node(收縮節點)
leaf_node(葉節點)--注:不能展開或收縮
node_depth:既節點在樹中的層級。
node_label:節點的顯示文本
node_icon:節點的圖標
node_value:節點的值。
例子:
declare
htree item;
node_value varchar2(100);
begin
-- 得到樹
htree := find_item('tree_block.htree3');
-- 得到當前選中節點的值
node_value := ftree.get_tree_node_property(htree, :system.trigger_node, ftree.node_value);
...
end;
注釋:其中: system.trigger_node指當前選中的樹節點。
l function get_tree_property (item_name varchar2,property number);
功能:取得樹的屬性
其中property有如下幾種:
datasource
record_group
query_text
node_count:返回樹中節點的個數。
selection_count
allow_empty_branches
allow_multi-select
l procedure set_tree_node_property (item_name varchar2,node ftree.node,property number,value varchar2);
功能:設置樹節點的屬性
l procedure set_tree_property (item_name varchar2,property number, value varchar2);
procedure set_tree_property (item_name varchar2,property number, value recordgroup);
功能:設置樹的屬性
l procedure populate_tree (item_name varchar2);
功能:清空樹中已有數據,并根據記錄組或數據查詢重新生成樹。
l procedure add_tree_data (item_name varchar2,node ftree.node, offset_type number,offset number,data_source number,data varchar2);
功能:在指定節點下添加樹中數據
注:使用比較麻煩。
l function find_tree_node(item_name varchar2,earch_string varchar2, search_type number,search_by number,search_root node,start_point node);
功能:找到顯示文本或值符合search_string的節點。
參數:
search_type:find_next
find_next_child
search_by:node_label
node_value
search_root:查詢的根節點,一般是ftree.root_node
start_point:查找的開始節點,一般是ftree.root_node
l function add_tree_node(item_name varchar2,node ftree.node, offset_type number,offset number,state number,label varchar2, icon varchar2,value varchar2);
功能:添加樹節點。
offset_type:指定節點的分支類型,parent_offset和sibling_offset
offset:指定新節點的位置,
parent_offset:1..n
last_child
sibling_offset:next_node
previous_node
state:expanded_node(擴展節點)
collapsed_node(收縮節點)
leaf_node(葉節點)
l procedure delete_tree_node(item_name varchar2,node node);
功能:刪除樹節點
l function get_tree_node_parent(item_name varchar2,node node);
功能:得到指定節點的父節點。
l function get_tree_selection(item_name varchar2,selection number);
功能:得到處于選中狀態的節點。
l procedure set_tree_selection(item_name varchar2,node node, selection_type number);
功能:指定單個節點的選中狀態
參數:
selection_type:select_on
select_off
select_toggle
form運行態時有關的觸發器:
l when-tree-node-activated:用戶雙擊節點或在節點選中時按[enter]鍵時觸發。
l when-tree-node-expanded:節點展開或收縮時觸發
l when-tree-node-selected:當節點選中或取消選擇時觸發
二、生成樹的方式
樹控件一般單獨放在一個控制塊中(注:不能放在數據塊中),在畫布(canvas)上放置樹很容易,并且,如無必要,樹的屬性也不需要設置。
生成樹的方式有幾種:
l 運行前通過設置記錄組或數據查詢屬性來生成
l 通過add_tree_data觸發子來實現
l 運行態,通過add_tree_node等觸發子來實現
l 運行態,通過添加或刪除記錄組的數據元素來實現
分析:
一、 對樹直接操作
描述:find_tree_node找到指定節點,add_tree_node來添加其下級節點。
缺點:編程較為復雜,操作不靈活,而且易出錯。
優點:可以對添加節點等過程進行控制,實現一些特殊要求。
例子:
--dept_cur為取單位的cursor,emp_cur為取雇員的cursor
htree := find_item('tree_view.tree_emp');
open dept_cur;
loop
fetch dept_cur into aa;
exit when dept_cur%notfound;
del_node := ftree.find_tree_node ( htree,aa.kjmc, ftree.find_next, ftree.node_label, ftree.root_node, ftree.root_node);
-- 刪除單位節點及其子節點
if not ftree.id_null(del_node) then
ftree.delete_tree_node(htree, del_node);
end if;
end loop;
close dept_cur;
-- 根據用cursor取得的單位生成樹的第一層節點
open dept_cur;
loop
fetch dept_cur into aa;
exit when dept_cur%notfound;
new_node := ftree.add_tree_node(htree, ftree.root_node, ftree.parent_offset, ftree.last_child, ftree.expanded_node, aa.dname, '', aa.deptno);
end loop;
close dept_cur;
--根據雇員cursor生成樹的下層節點
open emp_cur;
loop
fetch emp_cur into bb;
exit when emp_cur%notfound;
find_node := ftree.find_tree_node(htree, bb.kjbh, ftree.find_next,
ftree.node_value, ftree.root_node, ftree.root_node);
new_node := ftree.add_tree_node(htree, find_node, ftree.parent_offset, ftree.last_child, ftree.expanded_node, bb.ename, '', bb.empno);
end loop;
close emp_cur;
-- 得到樹的根節點
ss := ftree.get_tree_property(htree,ftree.node_count);
-- 循環,直到樹的所有節點都展開
for j in 1..ss loop
exp_node := ftree.find_tree_node(htree, '');
state := ftree.get_tree_node_property(htree, j, ftree.node_state);
if state = ftree.collapsed_node then
ftree.set_tree_node_property(htree, j, ftree.node_state, ftree.expanded_node);
end if;
end loop;
二、 動態記錄組
層次樹所使用記錄組的數據格式:
+ — car
|
- — airplane
| — boeing
| — boeing
初始狀態
層數
顯示文本
圖標
值
-1(收縮節點)
1
‘car’
''
‘car’
0(葉節點)
2
'honda'
''
'civic'
1(展開節點)
1
'airplane'
''
'plane'
0
2
'boeing'
''
'747'
0
2
'boeing'
''
'757'
生成記錄組的方式又分為兩種。
1、 從查詢生成記錄組
描述:利用樹的查詢語句(connect by…prior…start with…)生成記錄組,設置樹的屬性來生成。
優點:編程簡單,方便。
缺點:只適用于可以構造出樹狀查詢語句的情況下。
例子:
v_ignore number;
rg_emps recordgroup;
begin
rg_emps := find_group('emps');
--如果非空,則清空數據
if not id_null(rg_emps) then
delete_group(rg_emps);
end if;
--構造記錄組
rg_emps := create_group_from_query('emps',
'select 1, level, ename, null, to_char(empno) ' ||
'from emp ' ||
'connect by prior empno = mgr ' ||
'start with job = ''president''');
v_ignore := populate_group(rg_emps);
ftree.set_tree_property('tree_view.tree_emp', ftree.record_group, rg_emps);
end;
2、 用行列數據直接構造記錄組
描述:記錄組一般為行列結構,以循環方式直接向記錄組中添加單元數據。
優點:可直接控制記錄組的樣式。
缺點:對多層結構,編程也較為復雜。
例子:
--單位cursor
cursor cursor_dept is
select dname, deptno from dept order by dname;
--雇員cursor
cursor cursor_emp(p_dno number) is
select ename, empno from emp where deptno = p_dno order by ename;
v_i number;
v_ignore number;
rg_emps recordgroup;
rg_depts recordgroup;
v_init_state groupcolumn;
v_level groupcolumn;
v_label groupcolumn;
v_icon groupcolumn;
v_value groupcolumn;
begin
rg_depts := find_group('depts');
--如有數據,則清空記錄組
if not id_null(rg_depts) then
delete_group(rg_depts);
end if;
rg_depts := create_group('depts');
--這里自定義你需要的記錄組中列的數據類型和長度
--初始狀態(指展開、收縮還是葉節點)
v_init_state := add_group_column(rg_depts, 'init_state', number_column);
--所在層數
v_level := add_group_column(rg_depts, 'level', number_column);
--顯示文本
v_label := add_group_column(rg_depts, 'label', char_column, 40);
--圖標
v_icon := add_group_column(rg_depts, 'icon', char_column, 20);
--值
v_value := add_group_column(rg_depts, 'value', char_column, 5);
v_i := 1;
for deptrec in cursor_dept loop
add_group_row(rg_depts, v_i);
set_group_number_cell(v_init_state, v_i, 1);
set_group_number_cell(v_level , v_i, 1);
set_group_char_cell (v_label , v_i, deptrec.dname);
set_group_char_cell (v_icon , v_i, null);
set_group_char_cell (v_value , v_i, to_char(deptrec.deptno));
v_i := v_i + 1;
for emprec in cursor_emp(deptrec.deptno) loop
add_group_row(rg_depts, v_i);
set_group_number_cell(v_init_state, v_i, 1);
set_group_number_cell(v_level , v_i, 2);
set_group_char_cell (v_label , v_i, emprec.ename);
set_group_char_cell (v_icon , v_i, null);
set_group_char_cell (v_value , v_i, to_char(emprec.empno));
v_i := v_i + 1;
end loop;
end loop;
ftree.set_tree_property('tree_view.tree_org', ftree.record_group, rg_depts);
end;
結論:進行數據庫設計時盡量把父子結構放在一張表,這樣,使用查詢生成記錄組再生成樹的方式最簡單實用。如果不能實現,那么直接構造記錄組也可生成樹。如無特殊要求,一般不采取對樹直接操作的方式。
附注:作者一般將生成樹的程序放在form builder的“程序單元”中,在需要的地方調用來實時刷新樹。
參考:developer 6.0自帶的pl/sql程序庫:navigate.pll
三、遺留問題
由于developer簡化了樹的設計,那么一些對樹的轉移、拷貝等操作就不太容易實現。這個課題還需要繼續研究。