Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

...

LoadRuntime Statement Summary

LoadRuntime is a terminal, command statement that can occur only in command scripts. It loads a runtime Dll into the current execution space of gmBasic. This Dll may well be intermingled with Dlls loaded via the Select RuntimeDll attribute and Dlls loaded via refactoring commands. There is a maximum of 64 Dlls that may be loaded. Each DLL exports certain methods, event handlers, that are then looked for by the execution logic of gmBasic when certain things happen or when certain points in the processing are reached.

The attributes of the LoadRuntime statement are as follows:

Attribute Description
DllName This attribute specifies a simple local file name of the runtime Dll to be loaded. It is looked for using the standard search order. That order is target location, local location, system location, and language location.
Filename This attribute specifies the full pathname of the runtime Dll to be loaded. It is used only if the DllName attribute is omitted.
Event If the DLL being loaded implements a CodeEvent event handler then this attribute specifies the identifier of this event. This event is triggered by references in the code to subcomponents that have a migUserCode value attributed to them. This is normally done with the Migrate command within a Refactor specification. Note that the event code compares only the first token of the code event string against the event identifiers of the currently active migration handlers.

The script errors associated with the LoadRuntime statement are as follows:

Error Description
1153 The RuntimeDll [%1d] could not be loaded


Panel
bgColorCCFFFF
titleTable of Contents

Table of Contents