External Interfaces/API Reference

isevent (COM)

Determine if an item is an event of a COM control

Syntax

• isevent(h, 'name')
  

Arguments

h
   Handle for a MATLAB COM control object.

name
   Name of the item to test.

Description

Returns a logical 1 (true) if the specified name is an event that can be recognized and responded to by the control, h. Otherwise, isevent returns logical 0 (false).

isevent returns the same value regardless of whether the specified event is registered with the control or not. In order for the control to respond to the event, you must first register the event using either actxcontrol or registerevent.

The string specified in the name argument is not case sensitive.

Examples

Create an mwsamp control and test to see if DblClick is an event recognized by the control. isevent returns true:

• f = figure ('pos', [100 200 200 200]);
  h = actxcontrol ('mwsamp.mwsampctrl.2', [0 0 200 200], f);
  
  isevent(h, 'DblClick')
  ans =
       1
  

Try the same test on Redraw, which is a method, and isevent returns false:

• isevent(h, 'Redraw')
  ans =
       0
  

See Also

events, eventlisteners, registerevent, unregisterevent, unregisterallevents

invoke (COM)

ismethod (COM)