Configure User Defined

The Configure User Defined dialog is used to set the executable program association that FS/2 will use for various functions.

Configure User Defined Dialog

Executable program entry field - Enter the executable program to be used when a file matching an associated extension is 'run' (double clicked or keyboard Enter). The entry must include the full path/filename. You may enter this path/filename manually or you may simply switch to the directory containing the executable file and click on the file to auto enter the path/filename.

The entry field may have program parameters added after the executable path/filename.

You may add switches directly as program parameters instead of using the Switches field or you may refer to switches in the Switches entry field with a %S in the parameters. However, switches in the Switches entry field are passed as the first parameters unless you use the %S to place these elsewhere in the parameters string.

You may also add the following symbols to reference path strings as program parameters. If the program just needs the selected file passed, these parameters are not required. If additional parameters are passed, they may be required:

• f - pass the selected filename without a path.
  
• F - pass the selected filename with a path.
  
• d - pass the selected directory name.
  
• D - pass the full selected directory path.
  
• V - pass the drive letter with colon.

File filters entry field - For those programs required for functional operation on the External Programs page, enter an '*' for the file filter. Except for the program viewer, these programs are run without regard to file filtering when selected as a program function. E.g., the program editor will always be started regardless for the file type if the Edit function is used.

On the User Defined Associations pages 3_2 and 3_3, use the File filters entry field to enter filters to associate files matching these filters to the executable program, e.g. '*.BMP;*.png;*.TIF;*.TGA;*.JPG;'. You must use the ';' as a delimiter with multiple filters.

The entry field is limited to 128 characters.

Switches entry field - Use this entry field to indicate the program switches (parameters) to to concatenated to the command line. Such switches are normally program specific. It is not necessary to add any parameters to the executable entry field. However, you may add any switches directly in the executable entry field in lieu of using the Switches field.

The entry field is limited to 32 characters.

Label entry field - Use this entry field to customize the label on the pushbutton used to enter this configuration dialog. E.g. 'UniMaint INI Editor' could be the label on the program association to an INI editor. The entry field is limited to 20 characters.

Accepts multiple files - This checkbox is used to indicate whether the executable program can handle more than one file. Some editor programs support multiple loading of files. If this option is checked and the program supports it, you may select several files and they will all load in the same program instance.

Enable ASCII filter - If this option is checked, the file(s) matching the associated extensions are checked for pure ASCII content before being accepted.

Type program - There is no user input required for the Type Program except you may select windowed or full screen sessions for non-PM programs. You should make sure that the program properly detects the configured program.

Clear pushbutton - The Clear pushbutton clears all entry fields. Pressing Clear and then Save will delete any previously defined association.

Save pushbutton - The Save pushbutton must be used to save the user defined association. If the user exits the dialog without a save step, no changes are made to any previously defined association.

Examples

Example to configure loaddskf.exe to make disk images;

• Set the file filters as '*.dsk;*.?dk'.

• Enter the path/filename to the program in the executable entry field, e.g. 'J:\Loaddskf\loaddskf.exe'. Add the parameters '%F A:'

• If the selected file passed the filter test, 'J:\Loaddskf\loaddskf.exe %F A:' would run the loaddskf.exe program located in drive/directory 'J:\Loaddskf' on the selected file (%F) and pass as the second parameter 'A:'. The '%F' would be required since a second parameter follows.

Example to use configure an image program to view image files;

• Set the file filters to '*.BMP;*.png;*.TIF;*.TGA;*.JPG;*.EPS;*.PIC;'.

• Enter the path/filename to the program in the executable entry field, e.g. 'I:\viewer\myview.exe'. No parameters are required.

• A double click on any file with an extension matching one of the filters would be viewed if the program, myview.exe, supported it.