PreFab...Player...Documentation...

Release Notes 1.5

April 1999

Version 1.5 is a "features" release, with a new price and an upgrade charge. (Version 1.2, shipping at about the same time, is a free maintenance release -- primarily for MacOS versions up thru 8.1.) Pricing details are on the order form.


What's New

  1. Compatible with OS versions up to and including 8.5.1. (May work as far back as System 7.0; only tested with 7.5.3 and later. Tested on 68K & PPC, including recent G3s.)
  2. Something we've wanted for a long time: a verb to disable user input so that people can't accidently interfere with the script using the mouse or keyboard!!! (An icon will flash in the upper left so that users know the computer is still working. Command-period will stop the script.) Note: may have no effect on iMac (or other models with USB keyboard & mouse).
  3. Misc. requested enhancements: a verb to move the mouse & leave it there, a way to change the location from which Player chooses menu items (for compatibility with other software that uses a specific location on the menubar), a new parameter to optionally disable the extra click required for certain pop-up menus.


What's Fixed: the same things as in the free Player 1.2 release


Caveats


What's New -- AppleScript Dictionary

disable user input: disable mouse and/or keyboard input ... may have no effect on iMac (or other models with USB keyboard & mouse)
disable user input
[from mouse/keyboard] -- which input to disable; defaults to both (can explicitly specify both by concatenating with "&")
[flashing icon boolean] -- 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
[command period to abort boolean] -- 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

enable user input: allow mouse and keyboard input ... may have no effect on iMac (or other models with USB keyboard & mouse)
enable user input

move to: move the mouse to a specified location and leave it there
move to anything -- location, in the form {x, y} or {x, y, screen coordinates}

set menu selection location to: advanced feature: specifies mouse location for 'do menu'
set menu selection location to point -- {x,y} location in screen coordinates ... the default value is {5, 5}

do menu popup item: choose from a pop-up menu -- new in 1.5: optional "extra click" parameter ...
[extra click boolean] -- set to 'false' to disable the extra click (for a slight increase in speed but at the risk of the app not noticing the changed popup value)


What's New -- Frontier summary

Player.disableUserInput()
disable mouse and/or keyboard input ... may have no effect on iMac (or other models with USB keyboard & mouse)

Player.enableUserInput()
allow mouse and keyboard input ... may have no effect on iMac (or other models with USB keyboard & mouse)

Player.moveMouse(location)
move the mouse to a specified location and leave it there

Player.setMenuSelectionLocation(location)
advanced feature: specifies mouse location for chooseMenu

Player.choosePopup(menu, item) « new in 1.5: optional "extraClick" parameter
Chooses a pop-up menu command.

new constants: MouseOnly, KeyboardOnly

| Top |


| Prev | Home | Next |Unlocking the Trial Version

Updated on 4/18/99 by Scott S. Lawton (ssl@prefab.com)

Copyright 1993-99, PreFab Software, Inc. All Rights Reserved.

This site built and maintained using Stage Three, a set of custom Frontier scripts.