REMOVEHANDLER

Unregister a registered event handler

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows

 

 

REMOVEHANDLER(event, method_name)

or

event ‑= method_name

Arguments

event

The name of an event, or an object reference to a field that is of the type Synnet.DotNetEvent or inherited from Synnet.DotNetEvent.

method_name

The name of the method (including the instance) that handles the event. (Synergy .NET only)

Discussion

The REMOVEHANDLER statement removes a registered event. In traditional Synergy, REMOVEHANDLER can only be used with code generated by the gennet40 utility, and method_name cannot be passed.

Method_name is in the form instance.method. For example, if c1 is an instance of class1, method_name could be any of the following:

When the event goes out of scope, all the methods registered for the event are automatically unregistered.

If you use REMOVEHANDLER for an event handler that has not been previously registered, the statement will be ignored.

See also

Examples

See ADDHANDLER.