lh = addlistener(Hsource,EventName,callback)
lh = addlistener(Hsource,property,EventName,callback)
Hsource is an array, the listener responds
to the named event on any object in the
a function handle referencing the callback function.
|Event Name||Event Occurs|
Immediately before the property value is set, before calling its set access method
Immediately after the property value is set
Immediately before a property value query is serviced, before calling its get access method
Immediately after returning the property value to the query
Hsource— Event source
Event source is the object that is source of the event, or an array of source objects, specified as a handle array.
EventName— Name of event
Name of event that is triggered on the source objects, specified as case-sensitive, quoted text. For property events, the event name is one of the four predefined property events.
property— Name of property
Name of the property whose property event triggers your listener, specified as one of these values:
A character vector or a cell array of character vectors,
where each character vector is the name of a property defined for
the objects in
An array of
You can attach listeners to property events on dynamic properties
Hsource is scalar. If
non-scalar, then the properties must belong to the class of
Hsource and cannot
include dynamic properties (which are not part of the class definition).
The class defining the source property must set the
attributes to enable you to listen to the property events.
callback— Listener callback
Listener callback specified as a function handle
Listener object created by
as the handle to an
event.listener or an
To learn about attributes of methods, see Method Attributes in the MATLAB® Object-Oriented Programming documentation.
To remove a listener, delete the listener object returned by
calls the handle class delete method to delete the object from the workspace and remove the listener.
Redefining or clearing the variable containing the
handle of the listener (for example,
lh) does not
delete the listener. The event object (
still has a reference to the
the listener's lifecycle to the object that is the source of the event.
To define a listener that is not tied to the event
object, use the
event.listener constructor directly
to create the listener.
When you need the lifecycle of the listener object to be independent
of the source object lifecycle, use the