FileExplorer Treeview and Listview (TreeListExplorer)

[WildByDesign]

You're welcome. It was all worth it in the end. This UDF is fully featured now and I have no more ideas. I was able to just drop it into my project and everything just worked perfectly. The UDF is a very high level of quality and stability that should help people who need it. And so many of the functions would be great for people to learn from.

[Kanashius]

Well, nearly fully featured, I found something I thought should be there and added that with v2.10.0:
- A possibility to add a filter for the files/folders (e.g. in the example I filter the ListView for folders or .au3 files)
- I added the possibility to enable/disable the navigation through the ListView with a doubleclick, if someone wants to use it only to show one folder

But I left the $bShowFiles/$bShowFolders untouched, because if you only want to differentiate between them and not more details, that is faster then using the filter callback (less calls and testing/splitting strings for extensions,...).

Edited March 20 by Kanashius

[WildByDesign]

The filter callback is really quite nice. I put it through some good testing and found no issues. I tested it in treeview as well. I can see a lot of possibilities with it.

[WildByDesign]

In my current project, I only use TreeView and I am able to get all the needed details from _selectCallback.

My __TreeListExplorer_CreateSystem and __TreeListExplorer_AddView look like this at the moment:

; Create TLE system for the right side
Global $hTLESystemRight = __TreeListExplorer_CreateSystem($hGUI_1, "", "_currentFolder", "_selectCallback")
If @error Then ConsoleWrite("__TreeListExplorer_CreateSystem failed: "&@error&":"&@extended&@crlf)

; Add Views to TLE system: ShowFolders=True, ShowFiles=True
__TreeListExplorer_AddView($hTLESystemRight, $hTreeViewRight, True, True, "_clickCallback", "_doubleClickCallback", "_loadingCallback")
If @error Then ConsoleWrite("__TreeListExplorer_AddView $hTreeView failed: "&@error&":"&@extended&@crlf)

Considering that I get all of the details from _selectCallback, how can I disable all of those other calls (except _selectCallback) to make things as efficient as possible?

[Kanashius]

If you look into the UDF:

expandcollapse popup

; #FUNCTION# ====================================================================================================================
; Name ..........: __TreeListExplorer_CreateSystem
; Description ...: Create a new TLE System. This is used to manage the views by settings the root folder, the current folder,...
;                  Multiple views (TreeView/ListView) can be added, all managed by this system.
; Syntax ........: __TreeListExplorer_CreateSystem($hGui[, $sRootFolder = ""[, $sCallbackFolder = Default[, $sCallbackSelect = Default
;                  [, $iMaxDepth = Default[, $iLineNumber = @ScriptLineNumber]]]]])
; Parameters ....: $hGui                - the window handle for all views used by this system.
;                  $sRootFolder         - [optional] the root folder as string. Default is "", making the drive overview the root
;                  $sCallbackFolder     - [optional] callback function as string. Using Default will not call any function.
;                  $sCallbackSelect     - [optional] callback function as string. Using Default will not call any function.
;                  $iMaxDepth           - [optional] the max depth, to which TreeViews are limited. Default = No limit.
;                  $iLineNumber         - [optional] linenumber of the function call. Default is @ScriptLineNumber.
;                                         (Automatic, no need to change; only used for error messages)
; Return values .: The system handle $hSystem, used by the other functions
; Author ........: Kanashius
; Modified ......:
; Remarks .......: When $sRootFolder = "", there is no root directory, enabling all drives to be accessed. Otherwise the User can
;                  only select child folders of the root folder.
;                  The $sCallbackFolder calls the provided function, which must have 4 parameters ($hSystem, $sRoot, $sFolder, $sSelected) and
;                  is called, when the root folder or the current folder changes. If the parameter number is wrong an error
;                  message will be written to the console at runtime (using $iLineNumber to find it better).
;                  $sCallbackSelect must be a function with 4 parameters ($hSystem, $sRoot, $sFolder, $sSelected)
;                  and is called, when an item in the Tree-/ListView is selected (Mouse/Keyboard)
;                  If $iMaxDepth is set, it is not possible to go deeper then that depth (Example: Drive selection with $sRoot="" and $iMaxDepth=0).
;                  ListViews are not limited by $iMaxDepth.
;
;                  Errors:
;                  1 - Parameter is invalid (@extended 1 - $hGui, 3 - $sCallbackFolder, 4 - $sCallbackSelect, 5 - $iLineNumber)
;                  2 - Setting WinProc for $hGui failed
;                  3 - TLE system could not be added to map
;                  4 - TLE system ID could not be converted to TLE system handle
;                  5 - $sRootFolder is invalid and could not be set (try __TreeListExplorer_SetRoot for details)
; Related .......:
; Link ..........:
; Example .......: No
; ===============================================================================================================================
Func __TreeListExplorer_CreateSystem($hGui, $sRootFolder = "", $sCallbackFolder = Default, $sCallbackSelect = Default, $iMaxDepth = Default, $iLineNumber = @ScriptLineNumber)

Then you can see, that a lot of parameters are optional. So you can just not define them. If no parameter is defined, the one written in the Function definition is used.
So: $sCallbackFolder = Default means, that the parameter is optional, so if it is not defined when the function is called, it is "Default". In the UDF description you can read, that Default means, nothing will be called ($sCallbackFolder - [optional] callback function as string. Using Default will not call any function.).

The only problem is, if there are multiple optional parameters, but you only want one of them. If it is not the first, you have to provide values for the parameters before that.
Some programming languages (for example python) let you name optional parameters like _CoolFunction(optionalParameter10="Something"), but that is not the case in AutoIt.
In AutoIt you have to look at the documentation of the function to find out, what the value is, when you do not define it and use that.

So a call would look like:
 

; Create TLE system for the right side
Global $hTLESystemRight = __TreeListExplorer_CreateSystem($hGUI_1, "", Default, "_selectCallback")
If @error Then ConsoleWrite("__TreeListExplorer_CreateSystem failed: "&@error&":"&@extended&@crlf)

; Add Views to TLE system: ShowFolders=True, ShowFiles=True
__TreeListExplorer_AddView($hTLESystemRight, $hTreeViewRight, True, True)
If @error Then ConsoleWrite("__TreeListExplorer_AddView $hTreeView failed: "&@error&":"&@extended&@crlf)

 

Edited March 21 by Kanashius

[WildByDesign]

5 hours ago, Kanashius said:

In AutoIt you have to look at the documentation of the function to find out, what the value is, when you do not define it and use that.

So a call would look like:

Thank you, I appreciate it. The explanation helped me to understand it all better as well. You are right, some functions and some UDFs have different ways to do this. So I wasn't sure. I followed your suggestion and everything is working well.