allowInterrupts | |||||||
Type | property | ||||||
Dictionary | LCS | ||||||
Library | LiveCode Script | ||||||
Syntax |
| ||||||
Summary | Specifies whether the user can halt a handler with a key combination. | ||||||
Introduced | 1.0 | ||||||
OS | mac, windows, linux, ios, android | ||||||
Platforms | desktop, server, mobile | ||||||
Example |
| ||||||
Values |
| ||||||
Related | Property: cantAbort Glossary: property, return, key combination, handler, Windows, exit, Mac OS, Unix Command: unlock error dialogs Object: stack Function: interrupt Control Structure: exit | ||||||
Description | Use the allowInterrrupts property to prevent users from interrupting handlers that must run to completion. For example, some handlers that change data cannot be interrupted safely, because they will leave data in an inconsistent state if interrupted. If the allowInterrupts property is set to true, the user can halt handlers by typing Control-period or Control-break (on Windows or Unix) or Command-period (on Mac OS). Setting this property to false disables this capability and ensures that the user cannot interrupt a handler. If the allowInterrupts property is set to false and the user attempts to interrupt the handler, the interrupt function returns true. To provide a clean exit, check this function and do any needed cleanup tasks before exiting the handler. Setting the allowInterrupts property to false is functionally equivalent to setting the cantAbort property to true for each open stack.
| ||||||
Tags | ui |