# Function Reference

# _GUICtrlToolbar_SetHotItem

Sets the hot item

#include <GuiToolbar.au3>
_GUICtrlToolbar_SetHotItem ( $hWnd, $iIndex )

## Parameters

$hWnd | Handle to the control
$iIndex | Index of the item that will be made hot. If this value is -1, none of the items will be hot.

## Return Value

Returns the index of the previous hot item, or -1 if there was no hot item.

## Remarks

A button is considered hot when the cursor is over it

## Related

_GUICtrlToolbar_GetHotItem

## Example

    #include "Extras\HelpFileInternals.au3"

    #include <GUIConstantsEx.au3>
    #include <GuiToolbar.au3>
    #include <StructureConstants.au3>
    #include <WinAPIConstants.au3>
    #include <WindowsNotifsConstants.au3>
    #include <WindowsStylesConstants.au3>

    Global $g_hToolbar
    Global $g_iItem ; Command identifier of the button associated with the notification.
    Global Enum $e_idNew = 1000, $e_idOpen, $e_idSave, $e_idHelp

    Example()

    Func Example()
        ; Create GUI
        Local $hGUI = GUICreate("Toolbar Get Hot Item (v" & @AutoItVersion & ")", 600, 400)
        $g_hToolbar = _GUICtrlToolbar_Create($hGUI)
        Local $aSize = _GUICtrlToolbar_GetMaxSize($g_hToolbar)

        _MemoCreate(2, $aSize[1] + 20, 596, 396 - ($aSize[1] + 20), $WS_VSCROLL)
        GUISetState(@SW_SHOW)
        GUIRegisterMsg($WM_NOTIFY, "_WM_NOTIFY")

        ; Set ANSI format
    ;~     _GUICtrlToolbar_SetUnicodeFormat($hToolbar, False)

        ; Add standard system bitmaps
        _GUICtrlToolbar_AddBitmap($g_hToolbar, 1, -1, $IDB_STD_LARGE_COLOR)

        ; Add buttons
        _GUICtrlToolbar_AddButton($g_hToolbar, $e_idNew, $STD_FILENEW)
        _GUICtrlToolbar_AddButton($g_hToolbar, $e_idOpen, $STD_FILEOPEN)
        _GUICtrlToolbar_AddButton($g_hToolbar, $e_idSave, $STD_FILESAVE)
        _GUICtrlToolbar_AddButtonSep($g_hToolbar)
        _GUICtrlToolbar_AddButton($g_hToolbar, $e_idHelp, $STD_HELP)

        ; Gets the hot item
        Local $iHotItem = _GUICtrlToolbar_GetHotItem($g_hToolbar)
        _MemoWrite("before $iHotItem= " & $iHotItem)

        ; Sets the hot item
        _GUICtrlToolbar_SetHotItem($g_hToolbar, 2)
        ; Gets the hot item
        $iHotItem = _GUICtrlToolbar_GetHotItem($g_hToolbar)
        _MemoWrite("after $iHotItem= " & $iHotItem)

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

    ; WM_NOTIFY event handler
    Func _WM_NOTIFY($hWndGUI, $iMsgID, $wParam, $lParam)
        #forceref $hWndGUI, $iMsgID, $wParam
        Local $tNMHDR, $hWndFrom, $iCode, $iNew, $iFlags, $iOld
        Local $tNMTBHOTITEM
        $tNMHDR = DllStructCreate($tagNMHDR, $lParam)
        $hWndFrom = DllStructGetData($tNMHDR, "hWndFrom")
        $iCode = DllStructGetData($tNMHDR, "Code")
        Switch $hWndFrom
            Case $g_hToolbar
                Switch $iCode
                    Case $NM_LDOWN
                        ;----------------------------------------------------------------------------------------------
                        _MemoWrite("$NM_LDOWN: Clicked Item: " & $g_iItem & " at index: " & _GUICtrlToolbar_CommandToIndex($g_hToolbar, $g_iItem))
                        ;----------------------------------------------------------------------------------------------
                    Case $TBN_HOTITEMCHANGE
                        $tNMTBHOTITEM = DllStructCreate($tagNMTBHOTITEM, $lParam)
                        $iOld = DllStructGetData($tNMTBHOTITEM, "idOld")
                        $iNew = DllStructGetData($tNMTBHOTITEM, "idNew")
                        $g_iItem = $iNew
                        $iFlags = DllStructGetData($tNMTBHOTITEM, "dwFlags")
                        If BitAND($iFlags, $HICF_LEAVING) = $HICF_LEAVING Then
                            _MemoWrite("$HICF_LEAVING: " & $iOld)
                        Else
                            Switch $iNew
                                Case $e_idNew
                                    ;----------------------------------------------------------------------------------------------
                                    _MemoWrite("$TBN_HOTITEMCHANGE: $e_idNew")
                                    ;----------------------------------------------------------------------------------------------
                                Case $e_idOpen
                                    ;----------------------------------------------------------------------------------------------
                                    _MemoWrite("$TBN_HOTITEMCHANGE: $e_idOpen")
                                    ;----------------------------------------------------------------------------------------------
                                Case $e_idSave
                                    ;----------------------------------------------------------------------------------------------
                                    _MemoWrite("$TBN_HOTITEMCHANGE: $e_idSave")
                                    ;----------------------------------------------------------------------------------------------
                                Case $e_idHelp
                                    ;----------------------------------------------------------------------------------------------
                                    _MemoWrite("$TBN_HOTITEMCHANGE: $idHelp")
                                    ;----------------------------------------------------------------------------------------------
                            EndSwitch
                        EndIf
                EndSwitch
        EndSwitch
        Return $GUI_RUNDEFMSG
    EndFunc   ;==>_WM_NOTIFY