|
MultiEd 2.21 betaCustomizing MultiEd Tool Buttons
|
Several tools and macros are included with the 2.21 package. You can run the ToolSetup program to
select the ones you want to use. Additional tools may be listed below. You are encouraged to submit
your own suggestions so that others may take advantage of them. Send suggestions to
brinkje@plu.edu.
Several templates for Java and HTML are include in the install package. More may be listed below. In
many cases you will customize the template for your use. For example, you may want to insert your
name or make sure the template fits your desired style. Again you are encourage to send your suggestions.
Some tools and require support files. Normally they are included in the install package. It is
possible that updates or new ones will be available eventually.
Tools and Macros
General instructions:
- Select the menu item "Options" | "Global and Tool Button Setup".
- Pick an unused or unwanted tool tab or in some cases pick the tab you want to modify.
- Fill in or modify the form.
- Click the "Save" button.
- Click the "Close" button.
- Test. If necessary, repeat these instructions to make corrections or modifications
MultiEd's home page
Hint: Debugging tools that open DOS windows
Sometimes clicking a tool opens a DOS window, and an error occurs, and the window closes immediately.
This is not very helpful. Suggestion: Check the MS-DOS remain open box in the tools setup. In many
cases, the window will stay open after the error and you may be able to determine what went wrong. If the
tool uses a .bat file, adding a PAUSE and ECHO ON commands to the .bat file may be helpful while
debugging.
Return to beginning of file
Using Internet Explorer, Netscape, Mozilla browsers
MultiEd traditionally has used a technology called DDE to control browsers. However Netscape (6.0 and newer)
and Mozilla do not support it. The macro facility in 2.21 will send keys strokes to these browsers (and other
programs) to have them load files. Tools are included in the install package for Internet Explorer, Netscape,
and Netscape. A special tool for Netscape 4.8 and below is provided because the file name is different than for
newer versions.
Return to beginning of file
Java: Compile and Run
Java: Run
These tools allow you to compile and run Java files or just run an already compiled program. They are
included in the install package. They use a bat
file called runjava.bat that can determine if the file needs to be run as an application or an applet that needs
to be run in the applet viewer. It will skip the run step if the class cannot be run. In the
case of an applet, it creates a simple default html file if one does not already exist. The bat file is included
in the install package or is available below is the support files section.
Return to beginning of file
Display Java API help documentation
Java programmers frequently need to refer to Java documentation. You can program a tool button to give
one click access to it. You will have customize it to specify the location of the documentation. You can use
the URL for the Sun's on-line documentation or a file on your computer. This tool is included in the install
package but will need to be customized for your browser and the location of the Java documentation.
Filling in the "Options | Global and Tool Button Setup" form
| Field | Contents |
|---|
| Tool name: | Java: API help documentation |
| Required file type(s): | (blank) |
| Save current file: | probably checked but optional |
| Match: | End |
| Window name: | Microsoft Internet Explorer
or Netscape or Mozilla
|
| Keys sent to window | <o>path to files or URL
Examples:
<o>C:/j2sdk1.4.0/docs/api/index.html
<o>http://java.sun.com/j2se/1.4/docs/api/index.html |
| Program name: | iexplore.exe or
Netscp.exe (version 6.0 and above) or Netscape (version 4.8 and below) or Mozilla |
| Parameters: | path to files or URL
See above for examples but omit the"<o>" |
| MS-DOS: | NOT checked |
| Windows: | checked |
Return to beginning of file
Java: Create Javadoc documentation for your program
This tool will allow you to create javadoc documentation for your program. The tool is included in
the install package. You will need a bat file called
runjavadoc.bat. It is included in the install package or is available below in the support files section.
Return to beginning of file
Assemble and link Masm programs
These tools can be used to assemble and link Masm programs. Different versions are required for 16 and 32-bit
programs. They are included in the install package. They require supporting files: MLBAT615.bat for 16-bit
programs or MAKE32.bat for 32-bit programs. They included in the install package or are available below.
They also assume you have MASM 6.15 installed on your computer.
Return to beginning of file
DOS Prompt (activate)
This tool saves the current file and either opens a new DOS window or activates an existing one. The Tool Setup
program automatically customizes this tool for NT and non-NT systems.
Return to beginning of file
Template: Provide standard text for files
After opening a new file and saving it, clicking this tool can provide broiler plate text for the file. The
boiler plate text is taken from template files. In most cases, there are several possible types of boiler plate
for a given file type so the tool opens an open file dialog box to allow the user to
pick the file containing the desired text. See the Templates section for more
information about template files.
The tool included in the install package is setup for Java, HTML, and asm
files. A little customization is needed for other file types. If you add a template for a different file type,
use the "Options | Global and Tool Button Setup" menu item. On the appropriate tab, add the file type to
the "Required file type(s)" field. Separate the file types by blanks (not commas).
Return to beginning of file
Setting and finding Bookmark #1
The Bookmark #1 set and Bookmark #1 find tools work the same way as the permanent bookmark #0
buttons. By adding these bookmarks, you can quickly move back and forth between two different locations in a file. These
macros are included in the install package.
Return to beginning of file
TEMPLATES
MultiEd comes with several template files for Java, HTML and Assembly (asm) files. They are
designed to illustrate possibilities rather than being a comprehensive and unified set of templates.
Generally there is no way to supply exactly the boiler plate text that you want. You are strongly encouraged
to customize the templates or to add your own.
A few hints:
- You will see macro instructions like {autoindent off}, {autoindent reset}{literal on) (or just {literal}),
{literal off} in many template files. The autoindent instructions control the MultiEd's automatic indent
feature. The {literal on} instruction tells MultiEd to type the text exactly as it appears. This is often
necessary
because MultiEd uses some meta keys for controlling some special keys on keyboard. "<" and ">"
specify
control down and control up. Thus, means control-o. "[" and "]" are used for the alt key, "(" and ")" are used to press and
release the shift key but are only used for unprintable key instructions. "{" and "}" are
used to denote special keys like {F1} or {left} (left arrow key) and macro instructions like {literal}.
Finally ~ is equivalent to {enter} which means press the "enter" key. Thus <({F1})a> would represent
control shift F1 and then control-a.
- The Macro Control dialog box ("Tools | Macro") is sometimes helpful in writing and debugging macros
and templates. The Macro
Control has a window that displays all the key strokes processed by the most recently used macro.
- If you create a macro for a file type other than Java, HTML, or asm, you will need to add the file
extension to the
"Required file type(s)" field in the appropriate page of the dialog box displayed for the "Options |
Global and Tool Button Setup" menu item. Separate the extensions with blanks NOT commas.
Remember to save the changes to they will be available in future editing sessions.
- Template files can use other template files. See template.AppletWithHTML.java for an example.
- See "Help" concerning macros and templates for more information.
You are encouraged to submit your original template files so they can be displayed on this page.
SUPPORT FILES
| File |
Purpose |
Used by tool |
Date |
| runjava.bat |
Compiling and/or running Java files |
Java: Compile and Run
Java: Run |
included |
| runjavadoc.bat |
Using javadoc to document Java programs |
Java: API help documents |
included |
| MLBAT615.BAT |
Assembling and linking 16-bit MASM programs |
MASM: assemble 16-bit program |
included |
| MAKE32.BAT |
Assembling and linking 32-bit MASM programs |
MASM: assemble 32-bit program |
included |
Return to beginning of file
MultiEd's home page
Revised: July 13, 2004