|SAS Companion for UNIX Environments|
You can customize toolboxes
The Tool Editor also allows you to create custom toolsets for your SAS applications. A toolset is a set of predefined tools that is associated with an application. Toolsets make it easier for individual users to customize their application toolboxes. If you create a toolset for an application, users can press the [Actions] button in the Tool Editor and choose the tools that they want to appear in their toolboxes. Users do not have to define the icons, commands, tip text, and IDs for those tools. For example, you can define a default toolbox for your application that includes tools for opening files, cutting, copying, and pasting text, and saving files. You can define a toolset that includes those tools and tools for opening the Preferences dialog, opening the Replace dialog, and entering the RECALL command. These additional tools will not appear in the users' toolbox unless a user adds them to their toolbox with the Tool Editor. See Changing an Existing Tool and Creating or Customizing an Application- or Window-Specific Toolset for more information.
|Specifying Toolbox Resources|
You can control the behavior of toolboxes with the following SAS resources:
SAS.autoComplete: True | False
SAS.commandsSaved: close up | n
commands.histin your SASUSER directory. If you specify 1 or more for this resource and
SAS.autoCompleteis True, then SAS will be able to automatically fill in commands that were entered in previous sessions. The default value is 25.
SAS.defaultToolBox: True | False
SAS.isToolBoxPersistent: True | False
SAS.toolBoxAlwaysOnTop: True | False
SAS.useCommandToolBoxCombo: True | False
SAS.defaultCommandWindowresources control whether the toolbox and command window are displayed. If both are displayed, this resource controls whether they are joined or separated. The default value is True.
SAS.useShowHideDecorations: True | False
SAS.useToolBoxTips: True | False
|Using the Tool Editor|
You can change the appearance and contents of a toolbox using the Tool Editor. To invoke the Tool Editor, (shown in Tool Editor Dialog Box) select
Tool Editor Dialog Box
By default, the Tool Editor edits the current toolbox. To edit a different toolbox, select [Open...] and specify the libref, catalog, and entry name for the toolbox you want to edit.
Once you invoke the Tool Editor, the toolbox goes into
preview mode. In preview mode, clicking on a tool icon makes that icon the
current icon and displays its associated commands in the
Command field. The current icon always appears pressed.
The items in the area of the Tool Editor labeled "ToolBox" affect the entire toolbox:
Max tools per row:
When you open the Tool Editor, the first icon is the current icon, and information about the current icon appears in the Button area of the dialog box. To change an existing tool, you can select a tool from the toolset displayed by the [Actions] button or you can modify the fields individually.
Note: The [Actions] button will display
a toolset only if a toolset is associated with (has the same entry name as)
the toolbox that you are editing. See Saving Changes to the Toolbox or Toolset for more information.
To use [Actions], select the tool that you want to change, and then select [Actions]. The Tool Editor displays the toolset associated with toolbox. If you select a tool from this toolset, the Tool Editor enters the appropriate information into the button fields for you.
To modify the fields individually:
Icon Categoryfield and select a new category.
To add a tool to the toolbox:
To change the
position of a tool in the toolbox, select the
tool icon, and then click on the left or right arrows to move the tool.
To delete a tool from the toolbox:
To return all tools in the
current Toolbox to their default
settings, select [Defaults...]. The Tool Editor asks you to
verify your request. Select [Yes], [No], or [Cancel].
You can save the changes
to the catalog entry shown in the
Name field or create a new toolbox with a different name.
If you are customizing a window- or application-specific toolbox or toolset for your own personal use, you should save the customized toolbox or toolset in your SASUSER.PROFILE catalog using the same entry name as the PMENU entry for the window or application. The SAS System searches for toolboxes and toolsets first in SASUSER.PROFILE, and then in the application catalog.
If you are a SAS/AF application developer or site administrator and you are editing a window- or application-specific toolbox that you want to be accessible to all users, you must save the TOOLBOX entry with the same library, catalog, and entry name as the PMENU entry for the window or application. To associate a toolset with a specific toolbox, save to TOOLSET entry with the same library, catalog, and entry name as the TOOLBOX entry. You will need write permissions to the appropriate location. For example, to store a customized toolbox for the graphics editor, the site administrator needs to store the toolbox in SASHELP.GI.GEDIT.TOOLBOX.
[Save] saves the toolbox information
to the catalog entry shown in the
Name field. [Save
As...] prompts you to enter a different libref, catalog, and entry
name. You can also choose to save the toolbox as a toolset. If you save the
toolbox as a toolset, the entry type will be TOOLSET; otherwise, the entry
type is always TOOLBOX. (Saving a set of tools as a TOOLSET does not change
your TOOLBOX entry. See Customizing Toolboxes and Toolsets
and Creating or Customizing an Application- or Window-Specific Toolset
for information about toolsets.)
If you select [Close] or [Open...] without first saving your changes, the Tool Editor prompts to save the changes to the current toolbox or toolset before continuing.
After you save the toolbox or toolset, the Tool Editor
remains open for additional editing, and the
Name field changes to the
name of the new entry (if you entered a new name).
|Creating a New Toolbox|
To create an entirely new toolbox, you can:
|Creating or Customizing an Application- or Window-Specific Toolbox|
If you are an application developer and want to create or edit an existing application toolbox, you must:
The TOOLLOAD and TOOLCLOSE commands are most useful when you are developing SAS/AF applications. You can use the EXECMDI routine with these commands to enable your application to open and close the toolbox and to give users of your applications access to several toolboxes during the course of their work. See SAS Component Language: Reference for a description of the EXECMDI routine.
|Creating or Customizing an Application- or Window-Specific Toolset|
You define application- or window-specific toolsets in the same way that you create an application- or window-specific toolbox. There are only two differences:
Note: If you are an application developer, make sure
that you delete any existing TOOLSET entry for your application as described
in Creating or Customizing an Application- or Window-Specific Toolbox
before you modify your application's toolset.
Top of Page
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.