MATLAB Function Reference

eventlisteners (COM)

Return a list of events attached to listeners

Syntax

• eventlisteners(h)
  

Arguments

h
   Handle for a MATLAB COM control object.

Description

eventlisteners lists any events, along with their callback or event handler routines, that have been registered with control, h. The function returns a cell array of strings, with each row containing the name of a registered event and the handler routine for that event. If the control has no registered events, then eventlisteners returns an empty cell array.

Events and their callback or event handler routines must be registered in order for the control to respond to them. You can register events either when you create the control, using actxcontrol, or at any time afterwards, using registerevent.

Examples

Create an mwsamp control, registering only the Click event. eventlisteners returns the name of the event and its event handler routine, myclick:

• f = figure('pos', [100 200 200 200]);
  h = actxcontrol('mwsamp.mwsampctrl.2', [0 0 200 200], f, ...
      {'Click' 'myclick'});
  
  eventlisteners(h)
  ans = 
      'click'    'myclick'
  

Register two more events: DblClick and MouseDown. eventlisteners returns the names of the three registered events along with their respective handler routines:

• registerevent(h, {'DblClick', 'my2click'; ...
      'MouseDown' 'mymoused'});
  
  eventlisteners(h)
  ans = 
      'click'        'myclick' 
      'dblclick'     'my2click'
      'mousedown'    'mymoused'
  

Now unregister all events for the control, and eventlisteners returns an empty cell array, indicating that no events have been registered for the control:

• unregisterallevents(h)
  
  eventlisteners(h)
  ans = 
       {}
  

See Also

events, registerevent, unregisterevent, unregisterallevents, isevent

evalin

events (COM)