Function Reference


_GUICtrlTreeView_CreateDragImage

Creates a dragging bitmap for the specified item

#include <GuiTreeView.au3>
_GUICtrlTreeView_CreateDragImage ( $hWnd, $hItem )

Parameters

$hWnd Control ID/Handle to the control
$hItem Handle to the item

Return Value

Success: the image list handle to which the dragging bitmap was added.
Failure: 0.

Remarks

If you create the control without an associated image list, you cannot use this function to create the image to display during a drag operation.
You must implement your own method of creating a drag cursor.
You are responsible for destroying the image list when it is no longer needed.

Example

#include <GUIConstantsEx.au3>
#include <GuiImageList.au3>
#include <GuiTreeView.au3>
#include <WinAPIGdiDC.au3>
#include <WinAPIMisc.au3>
#include <WinAPISysWin.au3>
#include <WindowsConstants.au3>

Example()

Func Example()
        Local $hGUI = GUICreate("TreeView Create Drag Image (v" & @AutoItVersion & ")", 400, 300)

        Local $iStyle = BitOR($TVS_EDITLABELS, $TVS_HASBUTTONS, $TVS_HASLINES, $TVS_LINESATROOT, $TVS_SHOWSELALWAYS, $TVS_CHECKBOXES)
        Local $hTreeView = GUICtrlGetHandle(GUICtrlCreateTreeView(2, 2, 396, 268, $iStyle, $WS_EX_CLIENTEDGE))

        GUISetState(@SW_SHOW)

        ; Load images
        Local $hImage = _GUIImageList_Create(16, 16, 5, 3)
        _GUIImageList_AddIcon($hImage, "shell32.dll", 110)
        _GUIImageList_AddIcon($hImage, "shell32.dll", 131)
        _GUIImageList_AddIcon($hImage, "shell32.dll", 165)
        _GUIImageList_AddIcon($hImage, "shell32.dll", 168)
        _GUIImageList_AddIcon($hImage, "shell32.dll", 137)
        _GUIImageList_AddIcon($hImage, "shell32.dll", 146)
        _GUIImageList_Add($hImage, _GUICtrlTreeView_CreateSolidBitMap($hTreeView, 0xFF0000, 16, 16))
        _GUIImageList_Add($hImage, _GUICtrlTreeView_CreateSolidBitMap($hTreeView, 0x00FF00, 16, 16))
        _GUIImageList_Add($hImage, _GUICtrlTreeView_CreateSolidBitMap($hTreeView, 0x0000FF, 16, 16))
        _GUICtrlTreeView_SetNormalImageList($hTreeView, $hImage)

        _GUICtrlTreeView_BeginUpdate($hTreeView)
        Local $iImage, $hItem
        For $x = 0 To 5
                $iImage = Random(0, 8, 1)
                $hItem = _GUICtrlTreeView_Add($hTreeView, 0, StringFormat("[%02d] New Item", $x), $iImage, $iImage)
                For $y = 0 To 3
                        $iImage = Random(0, 8, 1)
                        _GUICtrlTreeView_AddChild($hTreeView, $hItem, StringFormat("[%02d] New Child", $y), $iImage, $iImage)
                Next
        Next
        _GUICtrlTreeView_EndUpdate($hTreeView)
        _GUICtrlTreeView_SelectItem($hTreeView, 0)

        ; Loop until the user exits.
        Local $bDragging = False, $hDrag
        While 1
                Switch GUIGetMsg()
                        Case $GUI_EVENT_MOUSEMOVE
                                If $bDragging Then DrawDragImage($hTreeView, $hDrag)

                        Case $GUI_EVENT_PRIMARYDOWN
                                Local $hSelected = _GUICtrlTreeView_GetSelection($hTreeView)
                                If $hSelected Then
                                        $bDragging = True
                                        ; Create drag image
                                        $hDrag = _GUICtrlTreeView_CreateDragImage($hTreeView, $hSelected)
                                        DrawDragImage($hTreeView, $hDrag)
                                EndIf

                        Case $GUI_EVENT_PRIMARYUP
                                If $bDragging Then
                                        $bDragging = False
                                        ; delete image list
                                        _GUIImageList_Destroy($hDrag)
                                        _WinAPI_InvalidateRect($hTreeView)
                                        _WinAPI_InvalidateRect(HWnd($hGUI))
                                EndIf
                        Case $GUI_EVENT_CLOSE
                                ExitLoop
                EndSwitch
        WEnd
        GUIDelete()
EndFunc   ;==>Example

; Draw drag image
Func DrawDragImage(ByRef $hControl, ByRef $hDrag)
        Local $tPoint, $hDC
        $hDC = _WinAPI_GetWindowDC($hControl)
        $tPoint = _WinAPI_GetMousePos(True, $hControl)
        _WinAPI_InvalidateRect($hControl)
        _GUIImageList_Draw($hDrag, 0, $hDC, DllStructGetData($tPoint, "X"), DllStructGetData($tPoint, "Y"))
        _WinAPI_ReleaseDC($hControl, $hDC)
EndFunc   ;==>DrawDragImage