|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer|
Permitting User Breaks in Lengthy Operations
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Even though Windows uses preemptive multitasking, where your functions or commands can take a long time to execute, it is good practice to yield some time to the operating system now and again to help it schedule concurrent tasks. Using native Windows calls, you can do this by using the sleep function. Using the C API, you can do it by using the xlAbort function, which not only yields the processor for an instant, but also checks to see if the user has pressed the cancel key, ESC.
The xlAbort function therefore enables your code to check whether the user wants to end the process, do the necessary cleanup, and then return control to Excel. The function also enables you to clear the break condition. This enables your commands to display a dialog box to verify whether the user wants to end the command. If the user does not want to end the command, calling the xlAbort function with the argument FALSE clears the break. (The default argument is TRUE, which simply checks the condition but does not clear it.)
You can call the xlAbort function from a user-defined function (UDF) or from an XLL command. In a UDF, when the xlAbort function returns TRUE, having detected a user break, you would typically cut short the function calculation and return some value to indicate that the calculation was not completed, perhaps an error or zero. You would not clear the break condition so that other instances of lengthy functions that also check this condition also break. Excel implicitly clears this condition when a recalculation ends.
When you detect a break condition in a command, you typically clear the condition by calling the xlAbort function again with the argument FALSE, although Excel implicitly clears this condition when a command ends.