PlayerPlayer.setForcedYield
Syntax
Player.setForcedYield(desiredState)
Parameters
desiredState is true or false.
Action
Sets whether or not to force an application to periodically yield control
Returns
True.
Examples
with Player
« assume the main dialog is already up
setForcedYield(true) « call before the offending dialog
clickButton("Options")
toggleCheckbox("High speed")
clickButton("OK") « dismiss the sub-dialog
clickButton("OK") « dismiss the main dialog
setForcedYield(false) « set to false when done
Notes
- This verb is often required when a dialog calls up a sub-dialog (and doesn't allow Player to get control to handle the sub-dialog). It should be used only where required, since it slows down the Macintosh.
- How will you know if you need this verb? See the separate Tech Support FAQ document and the new "my script stops" example scripts.
- In many ways, this verb is the opposite of Player 1.1's new yieldTime(...); this forces another app to yield the processor to Frontier and Player, yieldTime(...) gives time from Frontier to other apps.
See Also
Player.yieldTime
Player.clickButton
Player.clickDefaultButton
Player.acceptDialog
Player.cancelDialog
Player.setCompleteMatch
Player.setCaseSensitive
Keywords
settings[5] dialogs
setMenuSelectionLocation