Prototype and description of the function setiventloop()

(This function needs no unlocking)


Switching the event loop while time-intensive calculations.

Prototype of the DLL function in C++ syntax (attend lower case!):
extern "C" __declspec(dllimport) unsigned long __stdcall seteventloop(
     unsigned long lSwitch);

Prototype of the DLL function in Visual Objects syntax:
_DLL function seteventloop(;
     lSwitch as logic);                    // 4 Byte
as logic pascal:geodll32.seteventloop      // 4 Byte

While time-intensive calculations within processing loops normaly no events
generated by the operating system are processed. For example, no keyboard
input or mouse movement can be processed and no overlayed windows are
updated during a processing loop. With the function seteventloop() a
processing loop can be interrupted to execute all generated events. The
function switches the event processing for some functions of the here listed
function groups during their time-consuming execution on or off:
      Function group "Elevation calculations"
      Function group "NTv2 Transformations"
      Function group "Transformation Parameter"

If the value TRUE is passed in lSwitch, events during time-consuming
calculations are allowed in the listed functions.

If the value FALSE is passed in lSwitch, events during time-consuming
calculations are not possible in the listed functions.

After the program start and the loading of GeoDLL the processing of events
during time-intensive calculations is off by default. All events are
processed after leaving the processing loop.

There are further switches, which prepare GeoDLL for the operating in
different environments. These are the functions

The parameters are passed and/or returned as follows:
lSwitch       Switch for the event loop while time intensive calculations.
TRUE          Event loop on.
FALSE         Event loop off.

returnVal   In case of an error the function returns FALSE, otherwise TRUE.

This function needs no unlocking.