Quick View Plus


A: Appendix


A.1 Running qvp32.exe and qvpcomp.exe from a Command Line

Quick View Plus is normally run from the right-click menu of files listed in the Windows Explorer, or from within mail and Web browsing applications known to Quick View Plus. However, some users may want to run Quick View Plus directly from a command line - either within an MS-DOS window or as a helper application for another program, such as a Web browser. This can be accomplished by running the Quick View Plus executable program with command line parameters.

The executable program for Quick View Plus is QVP32.EXE, located in the Program subdirectory of your Quick View Plus installation. In the default installation, the path to this executable is C:\Program Files\Quick View Plus\Program\QVP32.EXE

You can display files in Quick View Plus by specifying the file name as a command line parameter to QVP32.EXE. Additional options can be specified that control the appearance and behavior of the Quick View Plus window.

Similarly, you can also run Quick Compress, Quick View Plus’ archiving and compression tool, from a command line.

The executable program for Quick Compress is QVPCOMP.EXE, located in the Program subdirectory of your Quick View Plus installation. In the default installation, the path to this executable is C:\Program Files\Quick View Plus\Program\QVPCOMP.EXE

A.1.1 Command Line Options for qvp32.exe

If you are running qvp32.EXE from the Start menu Run... command, you do not need to specify a path to qvp32.EXE, nor do you need the path if you are running it from another Windows program; e.g. as a Netscape Navigator helper application. The path only needs to be specified when qvp32.EXE is run from the MS-DOS prompt.

Note icon If you are running QVP32.EXE from the MS-DOS command line and the path to the filename contains spaces, you must enclose the path in quotation marks. For example, qvp32"C:\Program Files\Quick View Plus\readme.doc". Additionally, since MS-DOS only recognizes directory names that contain no more than eight characters, remember to abbreviate long directory folder names by typing the first six letters, then the tilde (~), then the number 1. For example, C:\Progra~1\Quickv~1\Program\QVP32.EXE.

Here is the general form for running QVP32.EXE with command line parameters:

qvp32.exe filename [options]

where filename represents the full path name of file to view, and options represents any combination of the options listed below, separated by spaces:

 
Option
Syntax
Explanation
-p
(position)
-p x, y, width, height
Position top/left of view window at x, y and size view window to width, height. Values are in screen coordinates. For example:
-p100,100,400,200
Note: Do not use spaces between values.
-m
(maximize)
-m
The view window starts maximized (-p option still valid)
-i
(Iconize)
-i
The view window starts minimized (-p option still valid)
-d
(display name)
-d text
Uses text in place of the file name in the Quick View Plus title bar and message boxes.
Note: If this text contains spaces, you must enclose it in quotation marks. For example: -d "The Viewed File"
-dt
(disable toolbar)
-dt
The toolbar is not displayed
-dl
(disable launch)
-dl
The toolbar button and menu item for launching the displayed file in it's original application are disabled
-dp
(disable print)
-dp
The toolbar button and menu item for printing and Quick Print are disabled, however Quick Print is still available from the context menu in the File Navigation pane.
-dc
(disable copy)
-dc
The toolbar button and menu item for copying to clipboard are disabled
-ds
(disable search)
-ds
The toolbar button and menu item for searching within the displayed file are disabled
-dz
(disable Quick Compress)
-dz
The menu item for Quick Compress is disabled, however Quick Compress is still available from the context menu in the File Navigation pane.
-db
(disable status bar)
-db
The status bar is not displayed
-da
(disable split pane Archive view)
-da
A split pane viewing window is not displayed when viewing an Archive file.
-dn
(disable File Navigator)
-dn
The File Navigation pane is disabled, however this does not disable the ability to browse through the history of files being viewed.
-x
(use existing window)
-x
The specified file will be displayed in a 'pinned' window, replacing any file in an existing pinned window if one is already displayed. See “Pinning the View Window to Another Window” in Chapter 3.
Note: If a previous window exists, all other options on a command line, except -d (display name) will be ignored.
-prn
(print only)
-prn
The specified file will be printed without being displayed. A status dialog with a Cancel button will be presented to the user to confirm the user desires to Quick Print the file.
-sprn*
-sprn
The specified file will be printed without a dialog being invoked. The file will not be displayed.
-bprn*
-bprn
The specified file will be printed and a progress dialog displayed. The file will not be displayed.

* Of these parameters, only one at a time is valid on the command line.

A.1.2 Command Line Options for qvpcomp.exe

If you are running QVPCOMP.EXE from the Start menu Run... command, you do not need to specify a path to QVPCOMP.EXE, nor do you need the path if you are running it from another windows program. The path only needs to be specified when QVPCOMP.EXE is run from the MS-DOS prompt.

Note icon If you are running QVPCOMP.EXE from the MS-DOS command line and the path to the zip filename contains spaces, you must enclose the path in quotation marks. For example, qvpcomp u "C:\Program Files\Quick View Plus\readme.zip”. Additionally, since MS-DOS only recognizes directory names that contain no more than eight characters, remember to abbreviate long directory folder names by typing the first six letters, then the tilde (~), then the number 1. For example, C:\Progra~1\Quickv~1\Program\QVP32.EXE.

Here is the general form for running QVPCOMP.EXE with command line parameters:

qvpcomp.exe command [options] target_zip [files ||target_dir]

where command is the zip action to be performed, options is any number of options which modify how the command executes, and target_zip is the name of the target archive. files is a list of the files you wish to archive, or you can enter a target_dir, which would be the path to an entire directory you wish to archive:

 
Commands
Command
Syntax
Explanation
a
(add files command)
a
Add files to a new or existing zip archive. If a target archive is not specified, QVPCOMP.EXE will use the target filename with “.zip” appended to it as the name of the target archive.
u
(unzip command)
u
Extract a zip archive into the target directory. If a target directory is not specified, QVPCOMP.EXE extracts the zip archive into the current directory. For example, the command
qvpcomp u test.zip c:\temp
will extract the files in test.zip and place them in the directory c:\temp.
h
(help command)
h
Display a quick help screen. For example:
qvpcomp h
Options
Option
Syntax
Explanation
-f1
(full path info option)
-f
When adding files to a zip archive, this option tells QVPCOMP.EXE to store the full path information for all target files in the zip file.
For example, if you wanted to add the file example.txt to the archive test.zip and the full path to example.txt is c:\temp\example.txt, then the command
qvpcomp a -f test.zip example.txt
will store the file as
temp\example.txt
When extracting a zip file, this option tells QVPCOMP.EXE to extract all files into subdirectories in the current directory corresponding to the path information stored in the zip archive.
For example, if the archive test.zip contains a file called temp\example.txt, then the command
qvpcomp u -f test.zip
will create the subdirectory temp in the current directory and place the file example.txt in that path.
-q
(quiet mode option)
-q
Suppresses status messages. Normally, QVPCOMP.EXE will display information about the files it is compressing/extracting while it is running. This option tells QVPCOMP.EXE to forego outputting this information. Error messages are not suppressed by this option.
For example
qvpcomp u -q test.zip
-pa
(relative path info option)
-p
When adding files to a zip archive, this option tells QVPCOMP.EXE to store the path information of all target files relative to the current directory.
For example, if a directory contains the files example.txt and temp\example2.txt, the command
qvpcomp a -p -s test.zip *.*
will store the files as example.txt and temp\example2.txt, respectively.
When extracting a zip archive, this option tells QVPCOMP.EXE to extract all files into subdirectories in the current directory corresponding to the path information stored in the zip archive.
For example, if the archive test.zip contains a file called temp\example.txt, then the command
qvpcomp u -p test.zip
will create the subdirectory temp in the current directory and place the file example.txt in that path.
Note: This option cannot be used together with the -f option described above.
-r
(replace option)
-r
When adding files to a zip archive, this option causes QVPCOMP.EXE to replace any files in the zip archive with new files being added that have the same filename.
For example, if you create an archive called test.zip that contains the file example.txt, then the command
qvpcomp a -r test.zip example.txt
will replace the example.txt in the archive with the new example.txt specified in the command line.
When extracting a zip archive, this option tells QVPCOMP.EXE to replace any files in the target directory that have filenames which match files being extracted.
For example, if you create an archive called test.zip that contains the file example.txt, and there is already a file called example.txt in the current directory, then the command
qvpcomp u -r test.zip
will replace the example.txt in the current directory with the example.txt in the archive.
By default, QVPCOMP.EXE never replaces files when adding to or extracting from zip archives.
-s
(subdirectories option)
-s
When adding files to a zip archive, this option tells QVPCOMP.EXE to traverse subdirectories when looking for files to add. Note: It will not include any path information for the files! Use the -p or -f options to include path information.
For example, the command
qvpcomp a -s test.zip \example
will add all files in the \example directory and its subdirectories to the archive test.zip.
This option has no effect when extracting zip archives.
1Of these two parameters, only one at a time is valid on the command line.