在PB的TREEVIEW控件中实现自动查询2.doc

在PB的TreeView控件中实现自动查询2
（深圳：独孤求败 2003-05-30）
    PowerBuilder提供的TreeView控件可以使我们以树形方式分层组织和显示数据，使程序的表现更为灵活，用户的操作更加方便。通常情况下，在TreeView控件中通过展开和折叠各分枝，可以方便地对所需信息进行查找和定位，但是如果该控件中的内容层次较多，用户对其内容又不非常了解时，要让用户逐一展开各分枝进行定位就会使效率降低，这种情况下就需要提供一种自动查询方式，让用户输入要找的信息，由程序来完成在TreeView控件中的查找和定位。 
    PowerBuilder的TreeView控件没有直接提供完成这一功能的函数或方法，也就是说不能直接在TreeView控件的各节点中查找所需的数据。该控件具有一个FindItem()函数，可用于查找节点项，但该函数不能直接对我们所要找的数据进行查找，例如字符文本或数值数据，它只能基于TreeView控件的某一节点项的句柄进行查找。不过我们可以利用该函数来获得节点项的句柄，再通过该句柄进一步获得节点项的详细信息。FindItem() 函数的语法如下： 
treeviewname.FindItem ( navigationcode, itemhandle )
    其中，treeviewname是我们要在其中进行查找的TreeView控件的名称； 
    navigationcode参数是一个TreeNavigation枚举数据类型，用来表明itemhandle参数与要找的节点项之间的关系，有效的取值如下： 
RootTreeItem! 
查找第一层的第一项；
NextTreeItem! 
在同一级中查找itemhandle后的下一项；
PreviousTreeItem! 
在同一级中查找itemhandle前面的一项；
ParentTreeItem!
查找itemhandle的父节点；
ChildTreeItem! 
查找itemhandle的第一个子节点；
FirstVisibleTreeItem! 
查找在TreeView控件中可视的第一项而不论层次；
NextVisibleTreeItem!
查找itemhandle后已展开的第一项，不分层次；
PreviousVisibleTreeItem! 
查找itemhandle前已展开的第一项，不分层次；
CurrentTreeItem! 获得当前所选项；
DropHighlightTreeItem! 
查找DropHighlighted属性最近被设置过的项。
Itemhandle参数表示节点项的句柄。
    该函数返回一个长整形值，若执行成功返回找到的节点的句柄，若失败则返回 -1。除了ChildTreeItem!，FindItem不查找未展开的项。利用FindItem只能获得节点项的句柄，要得到某一节点的详细信息，还需要利用TreeView控件的GetItem()函数。该函数可通过节点项句柄得到节点项的状态信息，如label、picture index、childen等，只有比较这些状态信息如label的值，我们才能确定是否已经找到所需的节点项。该函数如下所示： 
treeviewname.GetItem ( itemhandle, item)
    其中，treeviewname是TreeView控件的名称；itemhandle 是要获取信息的节点项的句柄；item参数是一个TreeViewItem系统对象变量，用于存放节点项的信息。