num-var = SPF_Loop_Check(num-var)


Operands:

option-num

A numeric value that sets the state of the loop-checking option. This should be TRUE or FALSE depending on setting desired. You may also specify ON or OFF, or 1 or 0.


Returns:


The function will return the previous setting for Loop Check prior to establishing the new value.


RC is set to 0 and Msg$ = is set to "" (null)

Special Notes:


If your macro is going to perform some long running function, such as interfacing with the user by prompting, or any other long-running function, you should call this function to disable the normal SPFLite monitoring of macro execution. 


This will prevent SPFLite from popping up and informing you that the macro might possibly have gone into a loop. 


Disabling the loop check should not normally be done during macro development and testing, but only after you are confident your macro is running properly. If a macro does go into a loop after loop-checking is disabled, the only recourse is to cancel the entire SPFLite session.


When you issue any thinBasic function that causes a wait condition, such as the MsgBox function, SPFLite will detect a loop condition in progress, when in reality nothing is wrong. To avoid such problems, you would disable loop checking before issuing a function call like MsgBox, and re-enable loop checking once MsgBox has completed.


Created with the Personal Edition of HelpNDoc: Maximize Your Productivity with HelpNDoc's CHM Help File Creation Features