Spork Software
Better than a
poke in the eye
with a sharp stick.









Download
Usage
Documentation
Frequently Asked Questions
Release History
Donate


Download

ProgBar_0.2.zip (0.2)
ProgBar_0.1.zip (0.1)




ProgBar is a freeware background application for AppleScripters. It allows a scripter to display a progress bar for user feedback while a script is running. Very useful for displaying file and/or folders names when recursing through scripted file processes, that sort of thing. This little goody was inspired by my buddy Ray Robertson at Scripting Matters.
Documentation

Object Names
  • aqua_prog_window
    • field_one - Top text field; good for describing your script's current process.
    • prog_one - The progress bar, of course.
    • field_two - Bottom text field; good for things like the name of the current file being processed by your script.
  • alum_prog_window
    • field_one - Top text field; good for describing your script's current process.
    • prog_one - The progress bar, of course.
    • field_two - Bottom text field; good for things like the name of the current file being processed by your script.
  • alum_prog_window2
    • field_one - Top text field; good for describing your script's current process.
    • prog_one - The progress bar, of course.
    • field_two - Bottom text field; good for things like the name of the current file being processed by your script.
  • mini_prog_window
    • field_one - Top text field; good for describing your script's current process.
    • prog_one - The progress bar, of course.
    • field_two - Bottom text field; good for things like the name of the current file being processed by your script.
Other Alterable Properties
  • Visibility / hide or show
  • Hides on deactivate
  • Window titlebar text
ProgBar has two optional progress bar windows. You can even use them both at the same time if you like. Both windows contain the same 3 primary objects, each with the same object name in either window. It is simply a matter of which window you target in your AppleScript statement.

The ProgBar download package includes an example script containing 3 subroutines which can be pasted into your own scripts for easy manipulation of ProgBar. These subroutines are:
  • prepProgress(someMaxCount, windowName) - This subroutine takes two parameters: a) The full count of the items to be processed, b) the name of the ProgBar window you wish to use - either 'aqua_prog_window' or 'alum_prog_window'.
  • incrementProgBar(itemNumber, windowName) - This subroutine simply increments the progress bar. Takes one parameter: The current item number being incremented.
  • endProgress(windowName) - This subroutine takes only one parameter: The name of the ProgBar window you're using.
Additional subroutines (or 'pseudo-commands') include:
  • fadeIn(windowName) - Takes window name parameter. Cool fade-in effect, handles window opening command as well.
  • fadeOut(windowName) - Takes window name parameter. Cool fade-out effect, handles window closing command as well.
  • barberPole(windowName) - Takes window name parameter. Changes progress bar behavior to the indeterminate 'barber pole' effect.
  • killBarberPole(windowName) - Takes window name parameter. Sets progress bar behavior back to active, turns off 'barber pole' effect.
  • startProgBar() - Simply launches ProgBar for the first time. Takes no parameters.

Screenshots

alum_prog_window


aqua_prog_window


mini_prog_window


alum_prog_window2


Frequently Asked Questions
  • Q: "How can I make ProgBar's dock icon go away? I want it to behave like a background application."
    A: Download Dockless.
  • Q: "I'd like ProgBar to do other things like move and click the mouse, activate a font and type text."
    A: Try Kanzu's Extra Suites. It does lots of other cool stuff.
  • Q: "This was written in AppleScript Studio. Can't anyone just make their own?"
    A: Sure you can. Feel free. It's easy. But if you want to save a step, ProgBar is here for you. ProgBar wants to help. ProgBar is all about *your* needs.
  • Q: "ProgBar's syntax is awfully wordy."
    A: Sure it is. But remember, it's free.

Release History
  • 0.2 - [9.9.2004]
  • 0.1 - Initial Release [8.19.2004]

ProgBar is free. You are under no obligation to pay anything to use it. However, if you find ProgBar useful and feel compelled, you can send a few bucks to say, "Thanks!".





2007 Spork Software | Made on a Mac | Hosted by fluid:dt