_GUICtrlListView_InsertGroup - a question about $iIndex paramater

[mLipok]

I try to use _GUICtrlListView_InsertGroup() funcion.

The help file and example are not clear to me - I just don't understand them (in this small part of course).

According to helpfile:

Quote

$iIndex

Index where the group is to be added. If this is -1, the group is added at the end of the list.

 

But in the examples it is not added "at the end of the ListView"

So what kind of list it is ?

I even tried to play with the example and change:

_GUICtrlListView_InsertGroup($hListView, -1, 1, "Group 1")
    _GUICtrlListView_InsertGroup($hListView, -1, 2, "Group 2")

to

_GUICtrlListView_InsertGroup($hListView, 2, 1, "Group 1")
    _GUICtrlListView_InsertGroup($hListView, 3, 2, "Group 2")

and nothing new happend - no change at all.

What exactly $iIndex do?

Edited 1 hour ago by mLipok

[pixelsearch]

Hello. Please try this in the example file. Instead of...

_GUICtrlListView_InsertGroup($idListview, -1, 1, "Group 1")
_GUICtrlListView_InsertGroup($idListview, -1, 2, "Group 2")

...we can try this :

_GUICtrlListView_InsertGroup($idListview, -1, 1, "Group 1")
_GUICtrlListView_InsertGroup($idListview, 0, 2, "Group 2")

Does group 2 display before group 1?

[pixelsearch]

The help file example, with an additional item and additional group, allows to better test the -1 value, changing it to 0 or 1 and see exactly where the group is inserted.

expandcollapse popup

#include <GUIConstantsEx.au3>
#include <GuiImageList.au3>
#include <GuiListView.au3>

Example()

Func Example()
    GUICreate("ListView Insert Group (v" & @AutoItVersion & ")", 400, 300)
    Local $idListview = GUICtrlCreateListView("", 2, 2, 394, 268)
    ; Enable extended control styles
    _GUICtrlListView_SetExtendedListViewStyle($idListview, BitOR($LVS_EX_FULLROWSELECT, $LVS_EX_SUBITEMIMAGES))
    GUISetState(@SW_SHOW)

    ; Set ANSI format
;~     _GUICtrlListView_SetUnicodeFormat($idListview, False)

    ; Load images
    Local $hImage = _GUIImageList_Create()
    _GUIImageList_Add($hImage, _GUICtrlListView_CreateSolidBitMap($idListview, 0xFF0000, 16, 16))
    _GUIImageList_Add($hImage, _GUICtrlListView_CreateSolidBitMap($idListview, 0x00FF00, 16, 16))
    _GUIImageList_Add($hImage, _GUICtrlListView_CreateSolidBitMap($idListview, 0x0000FF, 16, 16))
    _GUICtrlListView_SetImageList($idListview, $hImage, 1)

    ; Add columns
    _GUICtrlListView_AddColumn($idListview, "Column 1", 100)
    _GUICtrlListView_AddColumn($idListview, "Column 2", 100)
    _GUICtrlListView_AddColumn($idListview, "Column 3", 100)

    ; Add items
    _GUICtrlListView_AddItem($idListview, "Row 0: Col 0", 0)
    _GUICtrlListView_AddSubItem($idListview, 0, "Row 0: Col 1", 1, 1)
    _GUICtrlListView_AddSubItem($idListview, 0, "Row 0: Col 2", 2, 2)
    _GUICtrlListView_AddItem($idListview, "Row 1: Col 0", 1)
    _GUICtrlListView_AddSubItem($idListview, 1, "Row 1: Col 1", 1, 2)
    _GUICtrlListView_AddItem($idListview, "Row 2: Col 0", 2)
    _GUICtrlListView_AddItem($idListview, "Row 3: Col 0")

    ; Build groups
    _GUICtrlListView_EnableGroupView($idListview)
    _GUICtrlListView_InsertGroup($idListview, -1, 0, "Group 0")
    _GUICtrlListView_InsertGroup($idListview, -1, 1, "Group 1")
    _GUICtrlListView_InsertGroup($idListview, -1, 2, "Group 2")
    _GUICtrlListView_SetItemGroupID($idListview, 0, 0)
    _GUICtrlListView_SetItemGroupID($idListview, 1, 1)
    _GUICtrlListView_SetItemGroupID($idListview, 2, 2)
    _GUICtrlListView_SetItemGroupID($idListview, 3, 2)

    ; Loop until the user exits.
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
    GUIDelete()
EndFunc   ;==>Example

 

1 hour ago, mLipok said:

What exactly $iIndex do?

It indicates the place where a group will be displayed, relatively to the other groups.
Its value starts with 0, to display the group before any others, 1 to have it displayed just after the 1st group etc... or -1 to display it after all other groups.

Hope it helps