VTOOL

Overview

VTool is a program code component according to the Component Object Model standard (COM). More specifically, VTool is a COM server, which is a runtime module that can provide objects and related functionality to another COM-supporting application (client).

VTool was developed primarily for use with Windows Script Host and Visual Basic Script (WSH/VBS). The reason is simply that this scripting environment is versatile, powerful and available on all Windows systems. Furthermore extensibility is constituted by COM modules.

Scripts often use COM modules, such as the FileSystemObject (scrrun.dll) or the shell component (shell32.dll), which make additional functions available to the script. The script (or generally the COM client) uses these components by creating an instance of one of the objects (classes) defined there:

Set obj = CreateObject("Scripting.FileSystemObject")
Set obj = obj.CreateTextFile("test.txt", True)
obj.Close

In the same way, the objects of VTool can be used, e.g.:

Set obj = CreateObject("VTool.Window")
obj.Create "Textinfo window"
obj.WriteLine "sample text"
obj.Remove

To make this so easy, VTool —like all COM servers— must be registered once during installation (see below).

Objects

VTool wasn't originally intended as a general toolbox or library. Many objects and functions just resulted from practical needs. For instance, once I wanted to read a registry value (it was probably about the standard browser) which proved to be dependent on the Windows version. As a result, version information is now available as an object. In this way, the module has slightly grown over time.

One main thing is to have some elements for user interaction, which otherwise would not be available in a script. For instance:

Set obj = CreateObject("VTool.DriveList")
drv = obj.Selection("e:", "Drive Selection")

WSH/VBS unfortunately also lacks the ability to call Windows API functions. (This limitation has been overcome with DynaLib.) Therefore, some object methods of VTool provide such calls, for example to support the processing of INI files:

Set obj = CreateObject("VTool.Profile")
obj.File = "test.ini"
var = obj.GetValue("Area51", "Roswell")

to obtain certain system data:

Set obj = CreateObject("VTool.System")
MsgBox obj.VolumeGetGUID("C:\"), , "GUID for drive C:"

or, as mentioned, to identify the Windows version:

Set obj = CreateObject("VTool.OsVersion")
var = "Windows version: " & obj.Major & "." & obj.Minor & "." & obj.Build
WScript.Echo var

The following table lists all objects of the current version of VTool in alphabetical order.

Generally, dialogs are displayed as modal windows. The windows provided by ProgressDialog, ProgressWindow, Window, and Window2 are modeless and can serve to show information during longer processes.

The help file VTOOL.CHM contains detailed descriptions.

Usage

The objects of VTool are uncomplicated and designed for easy use. Their application follows the usual pattern:

' object is created
Set obj = CreateObject("VTool.Noise")
' object (obj) is used
obj.PlayFile "tada.wav"
' object is released (deleted)
Set obj = Nothing

Of course, some parts are more sophisticated and will require a good knowledge of technical essentials and the operating system.

License, Notes

VTool is provided as freeware and "as is" without any warranty or liability. Of course, suggestions for improvements are welcome.
Please note that any usage of VTool and the supplied samples is at your own risk!

Download, Installation

The file   vtool.zip contains VTOOL.EXE and VTOOLC.EXE along with description (VTOOL.CHM and its German version VTOOL_DE.CHM).
Version status: 3.5.1, Feb. 2024 (vtool.exe), 2.8.0, Jan. 2020 (vtoolc.exe).

For installation it suffices to extract this content to a folder of your choice. As a COM module, VTool has to be registered once. This is a quite simple procedure, described in the help file. Please also give attention to the entire program documentation.

The file  samples.zip (Oct. 2020) contains a few VBS scripts regarding the utilization of certain Windows version data, the application of the Shell's folder selection dialog, file comparison, and the setting of file times.

VTool requires the VB6 runtime files which are normally included with Windows (but are also available as download).