5-16 SOMobjects Base Toolkit Programmer’s Reference
Manual
someRegisterEv Method
Purpose
Registers the (object, method, Environment parameter) combination of a callback with
EMan, given a specified registerData object.
IDL Syntax
long someRegisterEv (
in SOMEEMRegisterData registerData,
in SOMObject targetObject,
inout Environment callbackEv,
in string targetMethod,
in void *targetData);
Description
This method allows for registering an event interest with EMan with an object method as
callback. The callbackEv is used as the environment pointer when EMan makes the
callback. It is assumed that the target method has been declared as using IDL callstyle. The
event of interest and its details are filled in a registration data object registerData. The
information about the callback routine is indicated by targetObject and targetMethod.
A mismatch in the target method’s callstyle and the registration method called
(someRegister vs. someRegisterEv) can result in unpredictable results.
Note: The target method is called using name-lookup method resolution.
Parameters
receiver A pointer to an object of class SOMEEMan.
ev A pointer to the Environment structure for the calling method.
registerData A pointer to registration data object that contains all the necessary
information about the event for which an interest is being registered with
EMan.
targetObject A pointer to the object which is the target of the callback method
callbackEv A pointer to the Environment structure to be passed to the callback method
targetMethod The name of the callback method.
targetData A pointer to a data structure to be passed to the callback method when the
event occurs.
Return Value
The registration ID.
Kommentare zu diesen Handbüchern