3.62 DM_SendMethod

Mit dieser Funktion wird ein Methodenaufruf in die Ereignis-Warteschlange gestellt und asynchron aus der Ereignisschleife (DM_EventLoop) heraus ausgeführt. Die Funktion ist damit eine einfachere Alternative zum Verschicken eines externen Ereignisses mit DM_SendEvent() und Aufrufen der Methode in der Ereignisregel für dieses externe Ereignis.

DM_SendMethod() unterstützt maximal 14 Argumente für den Methodenaufruf und kann nicht für Methoden mit output-Parametern verwendet werden.

Rückgabewerte von Methoden können nicht verarbeitet werden.

Definition

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

Parameter

-> DM_ID object

Objekt dessen Methode asynchron aufgerufen werden soll.

-> DM_Method Method

Identifikator der aufzurufenden Methode.

-> DM_Int argc

In diesem Parameter wird die Anzahl der Argumente für den Methodenaufruf (bis zu 14) übergeben.

-> DM_Value *argv

Mit Hilfe dieses Parameters werden die Argumente (bis zu 14) angegeben, die beim Methodenaufruf vom IDM mit übergeben werden sollen. Dieser Vektor muss dabei die in dem Parameter argc angegebene Länge haben.

-> DM_Options options

Dieser Parameter ist für zukünftige Versionen reserviert. Derzeit bitte nur 0 angeben.

Rückgabewert

Verfügbarkeit

Ab IDM-Version A.06.02.g

Siehe auch

C-Funktion DM_SendEvent

Eingebaute Funktion sendmethod()