PlayerPlayer.setTargetWindow
Syntax
Player.setTargetWindow(theWindow)
Parameters
theWindow is either a name or number (by stacking order).
Action
Specifies the target window for subsequent commands.
Returns
True
Examples
Player.setTargetWindow("Tools") « Photoshop palette
Player.setTargetWindow("Untitled") « the image
Player.setTargetWindow(1) « set back to the default
Errors
The window does not exist.
Notes
- By default, the origin for all coordinates is the upper left corner of the frontmost dialog or window. This verb sets the origin to the upper left corner of a specific window, palette or dialog.
- If Player's balloons show values that don't makes sense, either negative or larger than the "frontmost" window, perhaps a palette is actually frontmost. Either close the pallete or set the target to the document.
- This setting remains in effect until changed, or until a reboot. If you set it, be sure to set back to 1 when you are finished. If the target points to a non-existent window, Player may not be able to locate any dialog items.
- If another window, palette or modeless dialog covers the target window, mouse actions will go in the frontmost window rather than the target -- exactly the same behavior that a user would encounter.
- By default, Player matches only the number of characters specified in the verb parameter. This feature has the benefit of ignoring trailing punctuation, but will occasionally find a false match.
- By default, name matching is not case sensitive.
See Also
Player.screenCoordinates
Player.clickMouse
Player.dragMouse
Player.setCompleteMatch
Keywords
windows[1] mouse dialogs
setTypingDelay