PlayerPlayer.disableUserInput -- new in 1.5
Syntax
Player.disableUserInput()
Player.disableUserInput(from: mouseOrKeyboard, flashingIcon: desiredState, commandPeriodToAbort: desiredState)
Parameters
from: mouseOrKeyboard mouseOnly or keyboardOnly; defaults to both
flashingIcon: desiredState set to false to disable the image that flashes in the upper left corner ... WARNING: if mouse input is disabled, users may think the computer is frozen
commandPeriodToAbort: desiredState -- set to false to prevent command-period from enabling user input and aborting the script ... WARNING: if you don't allow command-period, it may be quite difficult to abort a runaway script
Action
Disable mouse and/or keyboard input.
Returns
True.
Examples
Player.disableUserInput()
Player.disableUserInput(Player.mouseOnly) « allow only keyboard input
Player.disableUserInput(Player.keyboardOnly) « allow only mouse input
Notes
- This verb doesn't work with USB keyboard & mouse. (Actually, it might disable USB keyboard input but no guarantees.)
- Even when keyboard input is disabled, pressing command-. (period) will abort unless you have explicitly disabled that using the optional parameter. (Depending on what the script is doing, you may have to press and hold it for a few seconds.)
See Also
Player.enableUserInput
Keywords
special
doubleClickInsideItem