EventLibrary.ahk


;Event Library
;Version: 1.0
;Author: KuroiLight/klomb
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

;https://msdn.microsoft.com/en-us/library/windows/desktop/dd373640(v=vs.85).aspx
;dwFlags: Flag values that specify the location of the hook function and of the events to be skipped.
global WINEVENT_OUTOFCONTEXT := 0x0000
     , WINEVENT_SKIPOWNTHREAD := 0x0001
     , WINEVENT_SKIPOWNPROCESS := 0x0002
     , WINEVENT_INCONTEXT := 0x0004

;https://msdn.microsoft.com/en-us/library/windows/desktop/dd318066(v=vs.85).aspx
;eventMin/eventMax: Specifies the event constant for the lowest/highest event value in the range of events that are handled by the hook function.
;0x00000001-0x7FFFFFFF
global EVENT_OBJECT_ACCELERATORCHANGE := 0x8012
     , EVENT_OBJECT_CLOAKED := 0x8017
     , EVENT_OBJECT_CONTENTSCROLLED := 0x8015
     , EVENT_OBJECT_CREATE := 0x8000
     , EVENT_OBJECT_DEFACTIONCHANGE := 0x8011
     , EVENT_OBJECT_DESCRIPTIONCHANGE := 0x800D
     , EVENT_OBJECT_DESTROY := 0x8001
     , EVENT_OBJECT_DRAGSTART := 0x8021
     , EVENT_OBJECT_DRAGCANCEL := 0x8022
     , EVENT_OBJECT_DRAGCOMPLETE := 0x8023
     , EVENT_OBJECT_DRAGENTER := 0x8024
     , EVENT_OBJECT_DRAGLEAVE := 0x8025
     , EVENT_OBJECT_DRAGDROPPED := 0x8026
     , EVENT_OBJECT_END := 0x80FF
     , EVENT_OBJECT_FOCUS := 0x8005
     , EVENT_OBJECT_HELPCHANGE := 0x8010
     , EVENT_OBJECT_HIDE := 0x8003
     , EVENT_OBJECT_HOSTEDOBJECTSINVALIDATED := 0x8020
     , EVENT_OBJECT_IME_HIDE := 0x8028
     , EVENT_OBJECT_IME_SHOW := 0x8027
     , EVENT_OBJECT_IME_CHANGE := 0x8029
     , EVENT_OBJECT_INVOKED := 0x8013
     , EVENT_OBJECT_LIVEREGIONCHANGED := 0x8019
     , EVENT_OBJECT_LOCATIONCHANGE := 0x800B
     , EVENT_OBJECT_NAMECHANGE := 0x800C
     , EVENT_OBJECT_PARENTCHANGE := 0x800F
     , EVENT_OBJECT_REORDER := 0x8004
     , EVENT_OBJECT_SELECTION := 0x8006
     , EVENT_OBJECT_SELECTIONADD := 0x8007
     , EVENT_OBJECT_SELECTIONREMOVE := 0x8008
     , EVENT_OBJECT_SELECTIONWITHIN := 0x8009
     , EVENT_OBJECT_SHOW := 0x8002
     , EVENT_OBJECT_STATECHANGE := 0x800A
     , EVENT_OBJECT_TEXTEDIT_CONVERSIONTARGETCHANGED := 0x8030
     , EVENT_OBJECT_TEXTSELECTIONCHANGED := 0x8014
     , EVENT_OBJECT_UNCLOAKED := 0x8018
     , EVENT_OBJECT_VALUECHANGE := 0x800E
     , EVENT_SYSTEM_ALERT := 0x0002
     , EVENT_SYSTEM_ARRANGMENTPREVIEW := 0x8016
     , EVENT_SYSTEM_CAPTUREEND := 0x0009
     , EVENT_SYSTEM_CAPTURESTART := 0x0008
     , EVENT_SYSTEM_CONTEXTHELPEND := 0x000D
     , EVENT_SYSTEM_CONTEXTHELPSTART := 0x000C
     , EVENT_SYSTEM_DESKTOPSWITCH := 0x0020
     , EVENT_SYSTEM_DIALOGEND := 0x0011
     , EVENT_SYSTEM_DIALOGSTART := 0x0010
     , EVENT_SYSTEM_DRAGDROPEND := 0x000F
     , EVENT_SYSTEM_DRAGDROPSTART := 0x000E
     , EVENT_SYSTEM_END := 0x00FF
     , EVENT_SYSTEM_FOREGROUND := 0x0003
     , EVENT_SYSTEM_MENUPOPUPEND := 0x0007
     , EVENT_SYSTEM_MENUPOPUPSTART := 0x0006
     , EVENT_SYSTEM_MENUEND := 0x0005
     , EVENT_SYSTEM_MENUSTART := 0x0004
     , EVENT_SYSTEM_MINIMIZEEND := 0x0017
     , EVENT_SYSTEM_MINIMIZESTART := 0x0016
     , EVENT_SYSTEM_MOVESIZEEND := 0x000B
     , EVENT_SYSTEM_MOVESIZESTART := 0x000A
     , EVENT_SYSTEM_SCROLLINGEND := 0x0013
     , EVENT_SYSTEM_SCROLLINGSTART := 0x0012
     , EVENT_SYSTEM_SOUND := 0x0001
     , EVENT_SYSTEM_SWITCHEND := 0x0015
     , EVENT_SYSTEM_SWITCHSTART := 0x0014

/*
    ;C callback definition
    void CALLBACK WinEventProc(
       HWINEVENTHOOK hWinEventHook,
       DWORD         event,
       HWND          hwnd,
       LONG          idObject,
       LONG          idChild,
       DWORD         dwEventThread,
       DWORD         dwmsEventTime
    );
    ;AHK callback definition
    WinEventProc(hHook, event, hwnd, idObject, idChild, dwEventThread, dwmsEventTime)
*/

EventHookTable := {}, _hHookTable := {}

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

HookEvent(functionname, events, pid := "0", flags := "0") {
    global EventHookTable
    
    for i, event_id in events {
        if(!EventHookTable[event_id])
            EventHookTable[event_id] := Array() 
        if(CreateWinEventHook(functionname, event_id, pid, flags))
            EventHookTable[event_id].Push(functionname)
    }
}

UnHookEvent(functionname, events) {
    global EventHookTable

    for i, event_id in events {
        if(EventHookTable[event_id]) {
            for i2, v2 in EventHookTable[event_id] {
                if(v2 == functionname) {
                    DeleteWinEventHook(functionname, event_id)
                    EventHookTable[event_id].RemoveAt(i2)
                }
            }
            if(EventHookTable[event_id].Length() == 0)
                EventHookTable.Delete(event_id)
        }
    }
}

CreateWinEventHook(functionname, event, pids := "0", dwflags := "0") {
    global _hHookTable

    cb := RegisterCallback(functionname)
    DeleteWinEventHook(functionname, event)
    DllCall("CoInitialize", UInt, 0)
    if(hHook := DllCall("SetWinEventHook", UInt, event, UInt, event, UInt, 0, UInt, cb, UInt, pids, UInt, 0, UInt, dwflags))
        _hHookTable[functionname . "_" . event] := hHook

    return (hHook != 0)
}

DeleteWinEventHook(functionname, event) {
    global _hHookTable
    
    hHook := _hHookTable.Delete(functionname . "_" . event)

    return (hHook != 0 ? DllCall("UnhookWinEvent", UInt, hHook) : false)
}