_ArrayDisplayTree()

[-Ultima-]

http://www.autoitscript.com/forum/index.php?showtopic=51621

So yeah, I tend to use nested arrays a lot (I know, it's not an advisable practice, but it still has its uses). With the current _ArrayDisplay(), I couldn't view the nested arrays, and got pretty annoyed having to manually look through each nested array, so I ended up writing this function. It supports both nested arrays, and multi-dimensional arrays.

Theoretically, an array with an unlimited number of dimensions can be handled by this function, but AutoIt has a built-in hard limit (VAR_SUBSCRIPT_MAX), which limits the number of dimensions to 64. An unlimited number of nested arrays is possible, though. That said, I'm not really sure why people would need that many subarrays and dimensions, but it's still viewable with _ArrayDisplayTree() if you so desire

_ArrayDisplayTree.au3

expandcollapse popup

#Include "Array.au3"

; Example 1: Multi-dimensional array
Local $aMain[2][4] = [["Paul", "Jim", "Richard", "Louis"], [485.44, 160.68, 275.16, 320.00]]
_ArrayDisplayTree($aMain, "Example 1: Multi-dimensional array")

; Example 2: Nested multi-dimensional arrays
Local $aSub[2][2][2][1] = [[[["Paul"], ["Jim"]], [["Richard"], ["Louis"]]], [[[485.44], [160.68]], [[275.16], [320.00]]]]
$aMain[0][0] = $aSub
_ArrayDisplayTree($aMain, "Example 2: Nested multi-dimensional arrays")oÝ÷ Ù°+­¬»Ûjëh×6#Include-Once
#include <GUIConstants.au3>
#Include <GUITreeView.au3>

;===============================================================================
;
; Description:      Displays given array in a treeview, with multi-dimensional
;                   and nested arrays supported
; Parameter(s):     $avArray - Array to display
;                   $sTitle  - [optional] Title to use for window
;                   $iWidth  - [optional] Width to use for window
;                   $iHeight - [optional] Height to use for window
; Requirement(s):   None
; Return Value(s):  On Success -  Returns 1
;                   On Failure -  Returns 0 and sets @error to 1
; Author(s):        Ultima
; Note(s):          - This function can theoretically support arrays with an
;                     unlimited number of dimensions, though in reality, it is
;                     limited by VAR_SUBSCRIPT_MAX (an AutoIt hard limit)
;                   - Unlimited nested arrays are supported
;
;===============================================================================
Func _ArrayDisplayTree(Const ByRef $avArray, $sTitle = "Array: TreeView Display", $iWidth = 400, $iHeight = 300)
    If Not IsArray($avArray) Then Return SetError(1, 0, 0)

    Local $iOnEventMode = Opt("GUIOnEventMode", 0)
    Local $hGUI = GUICreate($sTitle, $iWidth, $iHeight, DEFAULT, DEFAULT, $WS_MINIMIZEBOX + $WS_MAXIMIZEBOX)
    Local $iTreeView = GUICtrlCreateTreeView(0, 0, $iWidth-5, $iHeight-30, $GUI_SS_DEFAULT_TREEVIEW + $TVS_NONEVENHEIGHT, $WS_EX_CLIENTEDGE)
    GUICtrlSetResizing($iTreeView, $GUI_DOCKBORDERS)

    __treeAdd($iTreeView, $avArray)
    GUISetState()

    While GUIGetMsg() <> $GUI_EVENT_CLOSE
    WEnd
    GUIDelete($hGUI)

    Opt("GUIOnEventMode", $iOnEventMode)

    Return 1
EndFunc ;==>_ArrayDisplayTree

; Private
Func __treeAdd(ByRef $iTreeView, Const ByRef $avArray, $iParent = 0, $sPath = "", $iDimension = 1)
    If UBound($avArray, 0) > $iDimension Then
        For $i = 0 To UBound($avArray, $iDimension)-1
            __treeAdd($iTreeView, $avArray, _GUICtrlTreeViewInsertItem($iTreeView, "[" & $i & "]", $iParent), $sPath & $i & "][", $iDimension+1)
        Next
    Else
        For $i = 0 To UBound($avArray, $iDimension)-1
            Local $vItem = Execute("$avArray[" & $sPath & $i & "]")
            If IsArray($vItem) Then
                __treeAdd($iTreeView, $vItem, _GUICtrlTreeViewInsertItem($iTreeView, "[" & $i & "]", $iParent))
            Else
                _GUICtrlTreeViewInsertItem($iTreeView, "[" & $i & "] " & $vItem, $iParent)
            EndIf
        Next
    EndIf
EndFunc ;==>__treeAdd

I would've preferred not to use Execute() if it could have been avoided

_ArrayDisplayTree.zip

Edited August 19, 2007 by -Ultima-

[Generator]

Very nice, really useful when it comes to multi-dim array

Edited August 19, 2007 by Generator

[-Ultima-]

Thanks for the feedback

Edited August 19, 2007 by -Ultima-

[Zedna]

It's a nice idea, unfortunatelly it shows bad data on my WIN98SE.

In the first node is instead of Paul are bunch of subnodes with various data (zero or names or numbers)

[-Ultima-]

Look carefully at the example... It's intentional. The point was to show that it can accept nested arrays (not just multi-dimensional arrays), and your post simply proves that it's working as expected/intended.

Edited August 19, 2007 by -Ultima-

[Zedna]

Look carefully at the example

It's intentional. The point was to show that it can accept nested arrays (not just multi-dimensional arrays).

OK, sorry then.

Nice work

[-Ultima-]

Thanks

[RazerM]

Very nice! Your use of Execute is great, one place where it is needed. And the nested arrays are also nice.

Edited August 19, 2007 by RazerM