Using Bound Scripts in PSP



Created May 8, 2003 © Copyright SuzShook
Made "Version-Independent" March 2009
Property of SuzShook

This tutorial is my own creation;
however, most of the techniques used in this tutorial, I have learned from others!
Therefore, if you recognize any contribution you have made, I thank you!
And I thank you as well for respecting this as my work by not posting it,
in whole or in part,
in any other location without written permission from me!

Individuals and PSP graphics groups are invited to share my tutorials with others with TEXT LINKS ONLY.
You can e-mail me to let me know you are adding one or more of my tutorials to your list if you like -
it's always fun to know who is doing them!

This tutorial will teach you how to bind scripts to icons that can be added to toolbars and menus so they can be executed at the touch of a button - or the click of a mouse. Hope this tutorial helps you make your workspace work for you.



I make my tutorials as brief as possible, without the customary paths, details, and how-to's. For those veterans among you, this will be welcome! But for those less familiar with PSP, I included a "Glossary" that contains all the details omitted in the tutorial. If you need a little extra help, check the Glossary section. Just click on the button below - the Glossary will open in a new window.

PSP glossary button


This tutorial assumes you have a working knowledge of Paint Shop Pro at the intermediate level (or advanced beginner level with the Glossary). It was originally written in and for PSP Version 8, and now made "version-independent". Screen shots for this tutorial can come from any version of PSP - where there are significant differences from version to version, a green "Version Note" will be included, along with multiple screen shots if necessary.

Where a note/tip refers to a version of PSP and all higher versions, a + sign will be used to indicate this. For example, if a note/tip applies to PSP X and higher versions, I will use the convention "PSP X+".

If you try this tutorial, and find something is inaccurate for your version of PSP, please EMAIL ME to let me know so I can fix it!

Screen shots in this tutorial are resized - your work will be larger than this!



Supplies - For this tutorial, you will need the following:

~     ~     ~     ~     ~     ~     ~     ~     ~     ~

OK, now we're ready to begin. Grab your mouse and let's get started.

Remember to save often.

~     ~     ~     ~     ~     ~     ~     ~     ~     ~


In PSP 8, Jasc introduced scripting, which allowed users to record repetitive procedures and make them instantly available. In that same release of PSP, Jasc provided us with nine special scripts called Boundscript1 - Boundscript9 which functioned essentially as commands. Each of these nine Boundscripts were internally connected to one of the nine Boundscript icons, also provided in that release. You could replace one of the nine Boundscripts with your own script, or call your script from within one of the Boundscripts, and then place the Boundscript icons on menus or toolbars for quick and easy access. Of course, it was not always easy to remember which BoundScript and icon represented which script, but it did help simplify your work.

Starting in PSP 9, Jasc took the concept of bound scripts to a whole new level. In this and subsequent releases, 50 icons were provided to which users could bind or connect scripts, and each of those icons could be bound to any number of scripts. The script name/bound script icon combination is treated as an entity, giving a virtually limitless supply of bound scripts.

Version Note: Because the bound script facility introduced in PSP 8 is no longer supported, it will not be treated in this tutorial. What is included works for versions 9 and above.

Let's see how this works. Choose View...Customize to enter Customize mode and view the Customize dialog. Click on the Scripts tab:

scripts tab in Customize

The Scripts tab presents the Bind Scripts interface, which consists of 3 main areas:

scripts tab in Customize
  1. The scripts drop-list (#1 in above image) - this list contains all the scripts found in the paths you have defined for Trusted and Restricted scripts in the File Locations dialog. These scripts are listed in alphabetical order, with the Trusted and Restricted scripts mixed together.

  2. The 50 icons (#2 above) - there are 10 rows of 5 icons - use the scroll bar on the right (#5 above) to view more icons.

  3. The Bound Scripts list (#3 above).

Now that we've taken a look at the Bind Scripts interface, let's look at some of the things we can do with this facility. All the actions listed below are done while in Customize mode:

  1. To assign a script to an icon:

    • Select the script in the drop-list (#1).

    • Click the desired icon (#2).

    • Click the Bind button (#4).

    The script and its icon appear in the Bound Scripts list in the bottom window (#3).

  2. To place the icon on a menu or toolbar:

    • Select the script or its icon in the Bound Scripts list window (#3).

    • Drag it to the menu or toolbar where you want to place it.

  3. To remove a bound script and/or its icon from a menu or toolbar:

    • Find the bound script icon on the menu or toolbar.

    • Drag it into an empty place in the workspace.
      Note: When you remove a bound script from a menu or toolbar, that does not remove the association between the script and the icon. All the above action does is remove the bound script from the particular menu or toolbar. It is still available in the bound script list to be placed elsewhere.

  4. To remove the association between a script and an icon, or to "unbind" a script:

    • Click the icon or script name in the Bound Scripts list.

    • Click the Remove button (#6) located below the Bound Scripts list.

  5. To change the name assigned to a bound script on a menu:

    The following image shows a customized menu called Bound Scripts which I created on my system. This menu contains 8 bound scripts. When scipts are associated or bound to script icons, the script name is used on the menu by default. To read more on how to create your own menus, try my Customizing Menus in PSP tutorial.

    renaming menu items

    • Find the menu on which you placed the bound script - click on the menu name to display the menu (blue arrow above).

    • Right-click on the script name you wish to change (yellow arrow above).

    • Choose Menu Text in the context menu (red arrow above).

    • A Rename Menu Item text entry box appears - type the new name in the box, and click OK to change the text:

      rename menu item text entry box

  6. To assign shortcut keys to bound scripts:

    keyboard tab in Customize

    • In the Customize dialog, click the Keyboard tab (see A in above image).
      Version Note: This screen shot is from PSP 9 - in PSP XI and higher, there will be no Set Accelerator for drop-list. For more information about this drop-list, see either my Customizing Toolbars in PSP tutorial or my Customizing Menus in PSP tutorial.

    • In the Category drop-list, choose Bound Scripts (B).

    • In the Commands window (C), find the bound script to which you want to assign a shortcut. If the script already has a keyboard shortcut, it will be listed in the Current Keys window (D).

    • In the Press New Shortcut Key box (E), press the key or key sequence you wish to assign to the bound script - this will activate the "Assign" button below the Press New Shortcut Key box (G).

      • If the key is already assigned to another command, that command's name will appear in the Assigned to area (F).

      • If the key is not currently assigned, the Assigned to area will remain blank.

    • Click the "Assign" button (G) to complete the assignment. The assigned key will appear in the Current Keys box on the left (D).
    Note #1: While your cursor is in the Press New Shortcut Key box, any keys you press will appear in this box. You cannot use the Backspace key or the Delete key to remove an unwanted entry from this box. Pressing either of those keys will just enter that key name in the box! Therefore, to remove a keystroke or keystroke sequence from the Press New Shortcut Key box, just type in another key or keystroke sequence. Anything that appears in that box does not become effective until the Assign button is clicked.

    Note #2: You can assign shortcut keys to any of the scripts you have bound to icons on the Scripts tab, whether or not you choose to place those bound scripts on menus or toolbars. In other words, you do not have to place those bound scripts and icons on ANY menu or toolbar in order to make them available using shortcut keys. All you have to do is assign the scripts to one of the icons, and then use the Keyboard tab to assign shortcut keys to them, as described above.

Finally, one last item concerning bound scripts that may come in handy - this tip is applicable only outside customize mode. You might have a bound script icon on a toolbar or menu, and you'd like to find and edit that script, but you don't remember where it is. To locate a bound script on your system:

  1. If the bound script's icon is located on a toolbar, hover your cursor over the icon - the complete path will appear in a "tooltip".
  2. If the bound script is located on a menu, place your cursor on the bound script name or icon - the complete path will appear in the status bar at the bottom of the screen.

If you'd like to learn how to create your own toolbars, or make changes to the PSP toolbars, try my Customizing Toolbars in PSP tutorial.

If you want to tailor the PSP menus, or build your own menus, try my Customizing Menus in PSP tutorial.

Hope this tutorial helps you to get the most out of bound scripts, and further simplifies your work in PSP.


If you have any problems, comments, or questions, please do not hesitate to Email me.


Email


Version Independent Tutorials ~ About Me ~ Home ~ Email

All graphics and content 2002-present by SuzShook