;+
; Generic event handler for writing object widget programs. XMANAGER will not
; allow methods to be called via the EVENT_HANDLER keyword. To get around this:
; <ol> 
;   <li>Specify EVENT_HANDLER='mg_object_event_handler' as a keyword to 
;       XMANAGER</li>
;   <li>Put the object widget's reference in the TLB's UVALUE.</li>
;   <li>Write a handleEvents method in your object widget.</li>
; </ol>
;
; @param event {in}{required}{type=structure} events for all widgets generating
;        events in the widget hierarchy
;-
pro mg_object_event_handler, event
    compile_opt strictarr

    widget_control, event.top, get_uvalue=owidget
    owidget->handleEvents, event
end