User Tools

Site Tools


unregister_unregister_event_handler_.htm
Navigation:  Language Reference > 13 - Built-in Functions >====== UNREGISTER (unregister event handler) ====== Previous pageReturn to chapter overviewNext page

UNREGISTER( [event ] [, handler ] [, object ] [,window] [,control] )

blk2blue.jpg

UNREGISTER Unregisters an event handling procedure.
event An integer constant, variable, expression, or EQUATE containing an event number. A value in the range 400h to 0FFFh is a User-defined event. If omitted, all events are unregistered.
handler A LONG variable, or expression containing the return value from ADDRESS for the PROCEDURE to handle the event. If omitted, all handlers are unregistered.
object A LONG integer constant, variable, or expression containing any 32-bit unique value to identify the specific handler. This is generally the return value of ADDRESS(SELF) when the handler is a CLASS method.
window The label of the WINDOW or REPORT whose event to handle. If omitted, the current target WINDOW or REPORT is assumed.
control An integer constant, EQUATE, variable, or expression containing the field number of the specific control whose event to handle. If omitted, the event is handled for every control on the window.

UNREGISTER prevents a previously REGISTERed event handler PROCEDURE from being called to handle its event.

NoteBox.jpg

Can also be prototyped as UNREGISTEREVENT.

Example:

WindowResizeClass.Kill PROCEDURE

CODE

UNREGISTER(EVENT:Sized,ADDRESS(SELF.TakeResize),ADDRESS(SELF))

!Other code follows

WindowResizeClass.TakeResize PROCEDURE

ReturnValue  BYTE

CODE

ReturnValue  = Level:Benign

RETURN(ReturnValue)

See Also:

REGISTER

ACCEPT

EVENT

unregister_unregister_event_handler_.htm.txt · Last modified: 2021/04/15 15:57 by 127.0.0.1