3.61 DM_SendMethod

This function puts a method call into the event queue to be executed asynchronously from the event loop (DM_EventLoop). It is therefore a convenience function for sending an external event with DM_SendEvent() and calling the method in the event rule for that external event.

DM_SendMethod() supports a maximum of 14 arguments for the method call and cannot be used for methods with output parameters.

Return values from methods cannot be processed.

Definition

DM_Boolean DML_default DM_EXPORT DM_SendMethod
(
  DM_ID      object,
  DM_Method  method,
  DM_UInt    argc,
  DM_Value  *argv,
  DM_Options options
)

Parameters

-> DM_ID object

Object whose method shall be invoked asynchronously.

-> DM_Method Method

Identifier of the method to invoke.

-> DM_Int argc

This parameter transfers the number of arguments for the method call (up to 14).

-> DM_Value *argv

This parameter indicates the arguments (up to 14) which the IDM passes to the method on invocation. This vector must have the length that is specified in the argc parameter.

-> DM_Options options

This parameter is reserved for future versions. At present pass only 0.

Return value

Availability

Since IDM version A.06.02.g

See also

C function DM_SendEvent

Built-in function sendmethod()