EmEditor Home - EmEditor Help - Dialog Boxes - External Tools dialog box

External Tool Properties dialog box

This dialog box appears when the Properties button on the External Tools dialog box is selected.

Title text box

The name of the tool or command that will appear on the External Tools submenu of the Tools menu.

Command text box

Specifies the path to the .exe, .com, .bat, .cmd, or other files that you intend to launch.

Arguments text box

Specifies the arguments that are passed to the tool when the tool is launched. Use the Arrow (>) button to select from a list of predefined arguments. You can also specify environment variables, such as %WinDir%.

Initial Directory text box

Specifies the working directory of the tool. Use the Arrow (>) button to select a directory. You can also specify environment variables, such as %WinDir%.

Icon Path text box

Enter the file name you sampled the icon from.

Current Icon list box

List of icons you can use and the current icon selected.

Save File check box

If this is checked, EmEditor will save the current open document before launching the tool.

Use Output Bar check box

If this is checked, EmEditor will redirect the standard output and standard error output to the Output Bar.

Close on Exit check box

If this is checked, the Output Bar will be closed after the tool process is terminated.

Input drop-down list box

Select the standard input for the external tool.

None No standard input is used.
Selection The selected text is used as the standard input.
Document The entire document is used as the standard input.
Custom Specifies the standard input in customized format. If this is selected, the Custom text box and the Add EOF check box must also be specified.

Custom text box

Specifies the customized standard input. This text box is enabled only if Custom is selected in the Input drop-down list box.

Add EOF check box

If this is checked, the End of File character will be added to the end of the customized standard input. This check box is enabled only if Custom is selected in the Input drop-down list box.

Output drop-down list box

Select the standard output for the external tool.

Discard The standard output will be discarded.
Replace Selection The standard output will replace the selected text.
Replace Document The standard output will replace the entire document.
Insert before Selection The standard output will be inserted before the selected text.
Insert after Selection The standard output will be inserted after the selected text.
Show as Tool Tip The standard output will be displayed as a tool tip.
Create New Document The standard output will be contents of a new document.

Encoding drop-down list box

Select the encoding for the Output Bar.

Standard Error drop-down list box

Select how you want to display the standard error for the external tool.

Discard The standard error will be discarded.
Replace Selection The standard error will replace the selected text.
Replace Document The standard error will replace the entire document.
Insert before Selection The standard error will be inserted before the selected text.
Insert after Selection The standard error will be inserted after the selected text.
Show as Tool Tip The standard error will be displayed as a tool tip.
Create New Document The standard error will be contents of a new document.
Display as Output Bar The standard error will be displayed in the Output Bar.

... button

Click this button to find the specified file.

> button

Use this button to select from a list of predefined arguments.


See also

Q. Examples of external tool definitions?

Copyright 2003-2014 by Emurasoft, Inc.