Komodo User Guide

Using the Toolbox

Use the Toolbox to store a variety of items for easy access. You can export the contents of the Toolbox as a Komodo Project file and import previously-exported Toolbox items. To open the Toolbox, from the View menu, select Projects/Toolbox Pane, and click the Toolbox tab.

Toolbox commands are available through the Toolbox menu. Alternatively, you can access the Toolbox context menu by right-clicking the Toolbox tab. Additional context menus can be displayed by right-clicking folders and items within the Toolbox.

The Komodo Toolbox is used to store the following items:

Items remain in the Toolbox from session to session, regardless of the project.

Shortcuts

You can create shortcut links in the Toolbox to directories on disk. To add a shortcut to the Toolbox, select Toolbox|Add|"Open..." Shortcut. Then select the directory that you want using the Browse for Folder dialog box and click OK. The shortcut will be added to the Toolbox.

The following items are available on the context menu:

  • Open: to open the directory specified in the shortcut, select this option.
  • Export as Project File: use this option to export shortcuts as Komodo project files.
  • Rename: to change the name of a folder, select this option and enter a new name.
  • Delete: to remove the file from the Toolbox, select this option.
  • Properties: to view the properties of a shortcut or to assign a new name to a shortcut, select this option.
Top

Folders

As you can in the Project Manager, you can create virtual folders to organize items within the Toolbox. Folders are metaphorical; that is, they do not correspond to a directory on disk.

Adding Folders

To add a folder to the Toolbox, select Toolbox|Add|New Folder. If a folder is selected in the Toolbox when this command is executed, the new folder will be added beneath the selected folder.

Using Folders in the Toolbox

Folders are used to organize objects in the Toolbox. To add a new item, right-click the folder name and select the type of item you wish to add. To add an existing item, copy or cut the item from either the Toolbox or the Project Manager and paste it into the desired folder.

Right-click a folder to access a context menu with the following options:

  • Import from File System: see adding multiple files to a project for a description of the import options.
  • Add|New Folder: to add a sub-folder to the selected folder, select this option. You will be prompted to specify a name for the new folder.
  • Add|Existing File(s): to add a file to the selected folder, select this option.
  • Add|Existing Remote File: to add files stored on an FTP server to a folder, select this option. In order to access remote servers, you must configure access to the server. See Opening Remote Files for information on accessing files stored on remote FTP servers.
  • Add|New Snippet: to add a code snippet to the current folder, select this option. See Snippets for more information.
  • Add|New Command: using Komodo's Run Command function, you can create and save command-line interactions. These commands can be stored in folders using the Add Command menu option. This menu option will display the Command Properties dialog, which is described in the Running Commands section of the User Guide.
  • Add|New Template: to add a template to the current folder, select this option.
  • Add|New URL: to add a URL link to the current folder, select this option.
  • Add|New Dialog: to add a GUI Dialog to the current folder, select this option. See Using the GUI Builder for information about building dialogs.
  • Add|New Web Service: to add a Web service reference to the current folder, select this menu option. See Web Services for more information.
  • Add|New Macro: to add a macro to the current folder, select this option. See Macros for more information.
  • Add|New Open... Shortcut: to add a shortcut link to a directory on disk to the Toolbox, select this option and then use the Browse for Folder dialog box to choose a directory.
  • Export as Project File: to export folders from the Toolbox as Komodo Project files, select this option.
  • Rename: to change the name of a folder, select this option and enter a new name.
  • Source Control on Contents: a sub-set of Komodo's Source Code Control functions can be performed on the files stored within the selected folder. See Source Code Control for a description of these options.
  • Delete: to remove a folder from a project, select this option.
  • Properties: view and change the name of a virtual folder.
Top

Files

Adding Files

Files can be added to the Toolbox by any of the following methods:

  • From Windows Explorer: Drag and drop from Windows Explorer to the Toolbox.
  • From the Komodo Editor Pane: With the Toolbox tab selected, drag and drop from the file tab at the top of the Komodo Editor Pane to the pane area of the Toolbox tab.
  • From the Komodo Projects Tab: Copy and paste files from the Projects tab to the Toolbox tab.
  • Toolbox Menu: Select Toolbox|Add|Existing File(s) or Toolbox|Add|Existing Remote File. See Opening Remote Files for more information.

Using Files in the Toolbox

Double-click a file to open it in the Editor Pane.

The following items are available on the context menu:

  • Open File: to open the file in the Editor Pane, select this option.
  • Make "Open..." Shortcut: to create a shortcut in the Toolbox to the directory containing this file, select this option.
  • Refresh Status: use this option to refresh the status of the file. See Current File Settings in Komodo Preferences for more information.
  • Compare File With: use this option to select a file to compare with the current file. The file will open in a separate window, where you can press F8 to jump to the next change, F7 to jump to the previous change, and ESC to close the window.
  • Export as Project File: to export files from the Toolbox as a Komodo Project files, select this option.
  • Source Control: access source code control commands from this submenu. See SCC Commands for a description of each command.
  • Delete: use this option to remove the file from the Toolbox.
  • Properties: use this option to view the file's properties and source code control status.
Top

Snippets

Adding Snippets

Code Snippets can be added to the Toolbox by any of the following methods:

  • From the Komodo Projects Tab: Copy and paste a snippet from the Projects tab to the Toolbox tab.
  • Toolbox Menu: Select Toolbox|Add|New Snippet.

See Code Snippets for more information about creating snippets.

Using Snippets in the Toolbox

To insert a snippet in the Editor Pane, double-click the snippet.

The following options are available on the context menu:

  • Insert Snippet: To insert the snippet at the cursor position in the current document, select this option.
  • Export as Project File: to export snippets from the Toolbox as Komodo Project files, select this option.
  • Rename: is used to change the name of the command.
  • Delete: is used to remove the command from the Toolbox.
  • Properties: displays the name and contents of the snippet, and has preferences for snippet insertion. See Code Snippets for more information.
Top

Commands

Adding Commands

Commands can be added to the Toolbox by any of the following methods:

  • From the Komodo Project Manager: Copy and paste a command from the Projects tab to the Toolbox tab.
  • Toolbox Menu: Select Toolbox|Add|New Command.

See Running Commands for more information about creating commands.

Using Commands in the Toolbox

To run a command, double-click it on the Toolbox tab.

The following options are available on the context menu:

  • Run: is used to run the selected command.
  • Export as Project File: to export commands from the Toolbox as Komodo Project files, select this option.
  • Rename: is used to change the name of the command.
  • Delete: is used to remove the command from the Toolbox.
  • Properties: displays the name and contents of the command, and has a variety of run options. See Running Commands for more information.
Top

Templates

Adding Templates

Templates can be added to the Toolbox by either of the following methods:

  • File Menu:
    1. Select File|New|New File.
    2. From the Categories list box, select a folder.
    3. From the Templates list box, select a template.
    4. Select the Add to Toolbox check box.
    5. Click Open.
  • Toolbox Menu: Select Toolbox|Add|New Template.
  • From the Komodo Projects Tab: Copy and paste files from the Projects tab to the Toolbox tab.

Using Templates

Double-click a template to open it in the Editor Pane.

The following options are available on the context menu:

  • Open Template: to open the template in the Editor Pane, select this option.
  • Export as Project File: to export templates from the Toolbox as Komodo Project files, select this option.
  • Rename: is used to change the name of the command.
  • Delete: is used to remove a command from the Toolbox.
Top

URLs

Adding URLs

You can add a URL link to the Toolbox by using the Toolbox context menu, or by dragging and dropping.

To add a URL link to the Toolbox using the context menu:

  1. Select Toolbox|Add|New URL. The Create New URL dialog box will open.
  2. In the "link" field, enter the name that you want to appear next to the URL link in the Toolbox.
  3. In the Value field, enter the URL.
  4. Click OK.

To add a URL link to the Toolbox by dragging and dropping:

From a browser address bar or from the Editor Pane, select a URL and drag it with the mouse into the Toolbox. When using this method, ensure that URLs have the prefix "http://".

Using URLs

Double-click a link to open your system's default browser and load the URL.

The following options are available on the context menu:

  • Open URL in Browser: to open the linked URL in the default browser, select this option.
  • Open URL in Tab: to open the linked URL in a separate tab in the Editor Pane, select this option.
  • Export as Project File: to export URLs as Komodo Project files, select this option.
  • Rename: change the name of the URL.
  • Delete: remove the URL from the Toolbox.
  • Properties: to view the properties of a URL link or to assign a new name to a URL link, select this option.
Top

Dialogs

Adding Dialogs

Dialogs can be added to the Toolbox by any of the following methods:

  • From the Komodo Projects Tab: Copy and paste a dialog project from the Projects tab to the Toolbox tab.
  • Toolbox Menu: Select Toolbox|Add|New Dialog.

See Using the GUI Builder for more information about creating dialogs.

Using Dialogs in the Toolbox

Dialog Project Files

Double-click a dialog project file to load it in the GUI Builder.

The following options are also available on the context menu:

  • Edit Dialog: to open a dialog in the GUI Builder for editing, select this option.
  • Test Dialog: will generate a graphical model of the dialog.
  • Refresh Status: use this option to refresh the status of the file. See Current File Settings in the Komodo Preferences for more information.
  • Export as Project File: to export dialogs as Komodo Project files, select this option.
  • Source Control: access source code control commands for the dialog project file from this submenu. See SCC Commands for a description of each command.
  • Source Control on Contents: access source code control commands for the files contained in the dialog project file. See SCC Commands for a description of each command.
  • Delete: is used to remove the dialog from the Toolbox.
  • Properties: displays the name and contents of the project file and a summary of its source control status.

Dialog Files

Double-click a dialog file in the Toolbox to open it in the Editor Pane. Note that you should not edit the dialog file with the "_ui.lang" name, as your changes will be overwritten if you edit the dialog.

  • Open File: To open a dialog file in the Editor Pane, select this option.
  • Make "Open..." Shortcut: to create a shortcut in the Toolbox to the directory containing this file, select this option.
  • Refresh Status: use this option to refresh the status of the file. See Current File Settings in the Komodo Preferences for more information.
  • Save As Macro in Toolbox: use this option to save a dialog file as a macro.
  • Compare File With: to compare a file with another file in the "diff" window, select this option.
  • Export as Project File: to export dialog files as Komodo Project files, select this option.
  • Source Control: access source code control commands from this submenu. See SCC Commands for a description of each command.
  • Delete: use this option to remove the file from the Toolbox.
  • Properties: use this option to view the file's properties and source code control status.
Top

Web Services

Adding Web Services

Web Services can be added to the Toolbox by any of the following methods:

  • Drag and Drop: drag and drop a WSDL URL from a browser address bar or editor into the Toolbox or onto a folder or project in the Toolbox.
  • From the Komodo Projects Tab: Copy and paste a Web service from the Projects tab to the Toolbox tab.
  • Toolbox Menu: Select Toolbox|Add|New Web Service tab in the Projects/Toolbox Pane, and select the option Add|New Web Service.

See Web Services for more information.

Using Web Services in the Toolbox

To insert a Web service into the current document, double-click it in the Toolbox.

The following options are available on the context menu:

  • View WSDL: use this option to load the WSDL XML file in the Komodo Editor Pane.
  • Generate Proxy: use this option to generate a Perl module from the WSDL. This is only an option when using Web services within Perl programs.
  • Service Help: use this option to display the relevant Web Services Library page in the Komodo User Guide.
  • Delete: select this item to remove the Web service bookmark from the Project Manager or the Toolbox.
  • Properties: use this option to edit and view the Web service's properties.
Top

Macros

Adding Macros

Macros can be added to the Toolbox by any of the following methods:

  • From the Komodo Projects tab: Copy and paste a macro from the Projects tab to the Toolbox tab.
  • Toolbox Menu: Select Toolbox|Add|New Macro. You will be prompted to enter the location of an existing macro file.
  • Macro Drop-Down Menu: After recording a macro, use the Tools|Macros|Save to Toolbox command to save the macro to the Toolbox.

See Macros for more information.

Using Macros in the Toolbox

Double-click a macro in the Toolbox to execute it. Alternatively, right-click the macro and select Execute Macro from the context menu.

The following options are also available on the context menu:

  • Edit Macro: will open the macro in the Editor Pane. Note that this version of Komodo does not include an API for macro programming.
  • Export as Project File: to export macros as Komodo Project files, select this option.
  • Rename: use this option to change the name of the macro.
  • Delete: use this option to remove the macro from the Toolbox. Note that the macro file will not be deleted.
  • Properties: is used to view the name and file name of the macro, and to configure key bindings.
Top

Exporting and Importing

Exporting the Toolbox

Use the Toolbox menu to export the Toolbox as a Komodo Project file and to import previously-exported Toolbox items.

To export the Toolbox as a project (.kpf) file:

  1. From the Toolbox menu, select Export.
  2. In the Export To dialog box, choose the destination directory and enter a filename.
  3. Click Save.

Importing to the Toolbox

To import a previously-exported Toolbox item:

  1. From the Toolbox menu, select Import.
  2. In the Open File dialog box, select the project file containing the item(s) that you want to import.
  3. Click Open.
Top