# win.ui.explorer 库模块帮助文档 ## win.ui 成员列表 # ### win.ui.explorer # 用于创建类似资源管理器的文件树形视图 ### win.ui.explorer() # 创建类似资源管理器的文件树形视图。请在参数中指定一个已创建的 treeview 视图对象。创建对象时会自动启用 treeview 控件的滚动条。默认会在树形视图控件顶部自动搜索下拉框用于显示驱动器列表。 [返回对象:winUiExplorerObject](#winUiExplorerObject) ## winUiExplorerObject 成员列表 # ### winUiExplorerObject.combobox # 用于显示驱动器的下拉框, 默认会在树形视图控件顶部自动搜索下拉框,也可以自行指定 [返回对象:comboboxObject](#comboboxObject) ### winUiExplorerObject.getCurrentFilePath() # 返回当前选中节点文件路径注意onClick事件触发时树形控件尚未更改选中状态 ### winUiExplorerObject.getFilePath(hItem) # 返回节点文件路径,不指定节点句柄时返回根路径 ### winUiExplorerObject.insertDir(name,path,hItemParent) # 插入目录节点。参数 @name 指定显示名称。参数 @path 指定节点绑定的目录路径。可选用 @hItemParent 指定父节点句柄,不指定 @hItem 时添加到根节点 ### winUiExplorerObject.insertFile(name,path,hItemParent) # 插入文件节点。参数 @name 指定显示名称。参数 @path 指定节点绑定的文件路径。可选用 @hItemParent 指定父节点句柄,不指定 @hItem 时添加到根节点 ### winUiExplorerObject.insertItem(filename,hItemParent) # 添加文件名或目录名到指定节点。可选用 @hItemParent 指定父节点句柄,不指定 @hItem 时添加到根节点 ### winUiExplorerObject.loadFile # 搜索文件并加载到树形视图 ### winUiExplorerObject.loadFile("目录路径","通配符","模式匹配") # 搜索文件并加载到树形视图不指定任何参数调用此函数时默认显示所有硬盘分区, 除参数@1以外,其他参数可选参数@2使用模式匹配语法匹配文件名通配符默认值是"*.*",也可以传入通配符数组 ### winUiExplorerObject.pattern # 用于匹配要显示的文件或目录名的模式串 ### winUiExplorerObject.reloadFile # 重新加载指定目录下的文件 ### winUiExplorerObject.reloadFile("目录路径",节点句柄) # 重新加载指定目录下的文件到参数@2指定的节点, 参数@2如果省略则刷新所有节点 ### winUiExplorerObject.rootPath # 文件视图根目录路径 ### winUiExplorerObject.setIconSize("large") # 显示大图标可选参数有：large,small,extralarge,syssmall,jumbo ### winUiExplorerObject.setItemText(hItem,text) # 设置节点显示文本。参数 @hItem 指定树视图节点句柄。参数 @text 指定要显示的文本。 ### winUiExplorerObject.translatePath # function(dirPath,files,dirs){ __/*转换显示名称。 dirPath 为当前目录路径。 files,dirs 为 fsys.list 返回的文件名与子目录数组。数组同时包含显示名称与实际路径对照的名值对。必须返回相同结构的 files,dirs。*/ return files,dirs; } ### winUiExplorerObject.wildcard # 用于匹配要显示的文件名通配符 ## winUiExplorerObject 事件列表 # ### winUiExplorerObject.onClick # ```aardio winUiExplorerObject.onClick = function(filePath,hItem){ /*用户单击节点或节点图标,此时尚未改变选中节点*/ } ``` ### winUiExplorerObject.onDoubleClick # ```aardio winUiExplorerObject.onDoubleClick = function(filePath,hItem){ /*用户双击节点或节点图标,此时尚未改变选中节点*/ } ``` ### winUiExplorerObject.onExpandedOnce # ```aardio winUiExplorerObject.onExpandedOnce = function(hItem){ /*第一次展开参数指定的节点*/ } ``` ### winUiExplorerObject.onRightClick # ```aardio winUiExplorerObject.onRightClick = function(filePath,hItem,x,y){ /*用户右键单击节点*/ } ``` ### winUiExplorerObject.onSelChanged # ```aardio winUiExplorerObject.onSelChanged = function(filePath,hItem){ /*用户已改变选中节点*/ } ```