• A5_ASCII_TABLE Function
• A5_AXCONTROL_AVAILABLE Function
• A5_Compile_Scripts Function
• A5_CREATE_SHORTCUT Function
• A5_GET_LOCAL_INFO Function
• A5_GetAppVersionNumber Function
• A5_InstallAmyuni Function
• A5_IS_DeskTopEdition Function
• A5_IS_RUNTIME Function
• A5_IS_RUNTIMEPLUS Function
• A5_IsHomeEdition Function
• A5_MDAC_VERSION Function
• A5_REGISTRATION_LICENSE_INUSE Function
• A5_Run_VBScript Function
• A5_SetAppVersionNumber Function
• A5_SHOW_VARIABLE Function
• A5_SYSTEM_ADDIN_VERSION Function
• A5_TempFileListFileName Function
• COMPILE_LIBRARY Function
• COMPILE_TEMPLATE Function
• FUNCTION_DESCRIPTION_GET Function
• FUNCTION_LIMITATIONS_GET Function
• FUNCTION_PROTOTYPE_GET Function
• FUNCTIONS_GET Function
• HOURGLASS_CURSOR Function
• ON_XBASIC_IDLE Function
• PLAY_SOUND Function
• USER_VARIABLES_ENUM Function
• VARIABLE_CONTEXT_NAME Function
• VERSION Function
• Xbasic_Stack_Dump Function
• XBASIC_TRACE_END Function
• XBASIC_TRACE_START Function

ON_XBASIC_IDLE Function

Syntax

Arguments

code

The Xbasic code to be run placed into a character string.

flags

"R" = If you register duplicate code, Alpha Anywhere only executes the code once. "N" = Use this flag when issuing the command from a modal dialog box.

Description

The ON_XBASIC_IDLE() function register Xbasic code that will be run the next time Alpha Anywhere is idle. (i.e. after any scripts that are running asynchronously have finished). You would typically use this command if you have script that is running into timing problems. To run code when Xbasic is not busy executing use flags R-epeat suppress, N-ested idles. The suppress repeats flag doesn't add the code if the exact same code is already scheduled.

Discussion

Example

This example calls on_Xbasic_idle() twice with the same code, but the code block executes only once (assuming that there was no idle after the first on_Xbasic_idle() was called, which there wouldn't have been).

codeTxt = 
 file.remove(tempfilename) 
 %code% 


 on_Xbasic_idle(codeTxt,"R") 
 on_Xbasic_idle(codeTxt,"R")

Limitations

Desktop applications only.

See Also

• Developer Functions