Contents

  Welcome Dialog Box

  Installation Options Dialog Box

  Custom Installation Dialog Box

  Directory Options Dialog Box

  Microsoft Foundation Class Library Options Dialog Box

  Sample Source Options Dialog Box

  Tool Options Dialog Box

  Help File Options Dialog Box

  Registration Dialog Box

  Changes to Your Configuration Files


Welcome Dialog Box

This Setup program helps you to install Microsoft Visual C++ for Windows NT on your computer. You can use Setup to install either a default or a custom version of the product. After Microsoft Visual C++ for Windows NT has been installed, you can run Setup again at any time to install additional libraries, sample programs, help files, or other components.

Product Information

The "Installing Microsoft Visual C++" chapter of the Getting Started book contains information on:

System requirements

Product components

Presenting Visual C++ contains information on:

Product components

Location of topics in the documentation

Getting Help

For more information on any screen that contains a Help button, either:

Press F1

-or-

Choose the Help button.

Continue

If you choose Continue, Setup:

Prompts you for information

Confirms your Setup choices

Copies files to your hard disk

Exit

If you do not want to install Microsoft Visual C++ now:

Press F3

-or-

Choose the Exit button


Installation Options Dialog Box

Use this dialog box to install Microsoft Visual C++ in one of four ways:

Complete Installation

This button installs all tools and libraries for targeting Windows NT applications. It also installs all Microsoft Foundation Class Library files, as well as all sample files and Help files.

Custom Installation

This button opens the Custom Installation dialog box, from which you can select the components to initially install, or the components to add to your current installation.

Minimum Installation

This button installs Visual Workbench, App Studio, Microsoft Foundation Class Library files, tools, and libraries for targeting Windows NT applications.

CD-ROM Installation

This button installs the Visual Workbench, App Studio, and Wizards. After installation, all of the other components are run from the CD-ROM. Note that you cannot build or change a project that resides on the CD-ROM or in any read-only directory (such as a Write Once Read Many Times disk). When you open a sample project on the CD-ROM, a message box will inform you that the project is read-only, and a workspace cannot be saved. Any attempt to save sample source code or project data generates an error message. You can use the Custom Installation dialog box to install the sample files to your hard disk. Setup copies all of the samples to your hard disk. You can use the File Manager to copy individual samples.

Determining Installation Location and Disk-Space Requirements

The two fields at the bottom of the dialog box (Installation root drive/directory and Space available on installation root drive) show the currently selected drive and root directory for installing Visual C++ and the amount of disk space required for the installation as it is currently specified.

Back

If you choose Back, Setup returns to the Welcome dialog box.

Directory

If you choose Directory, Setup presents a dialog box that allows you to view or change the default directory structure used by Setup.

Exit

If you choose Exit, Setup presents a Setup Abort message box that allows stopping the Setup program; no files are copied to your hard disk.


Changes to Your Configuration Files

This topic documents the changes that Setup makes to your system's configuration files.

CONFIG.SYS

There is no CONFIG.SYS file under Windows NT. Setup makes no corresponding changes to the Windows NT registry.

AUTOEXEC.BAT

Setup makes no changes to the AUTOEXEC.BAT file. It does, however, create a file named VCVARS32.BAT to contain environment variable settings that may be necessary to operate the Microsoft Visual C++ tools from a command line. Setup, by default, makes changes to the Windows NT configuration registry that allow you to run the command-line tools. If you uncheck the Register Environment Variables checkbox in the Setup Complete dialog box and later want to run tools from the command line, either rerun Setup or run VCVARS32.BAT. VCVARS32.BAT changes the PATH, INCLUDE and LIB environment variables in your AUTOEXEC.BAT file.

SYSTEM.INI

There is no SYSTEM.INI file under Windows NT.

WIN.INI

There is no WIN.INI file under Windows NT.

TOOLS.INI

If you installed the Profiler, Setup adds several EXCLUDE statements to the [profiler] section. These statements prevent the Profiler from profiling routines in the named libraries.

Select option for initialization file handling

This control group provides you with the following two ways to make the necessary changes to your current TOOLS.INI file:

Make changes now and back up current version

When you select this option, Setup saves the content of your current TOOLS.INI file to a new file and then writes necessary changes to your TOOLS.INI file. Setup generates the names of the new file by using the base name of the original file (TOOLS) and adding a numeric file extension. The numeric extension is .001 the first time you run Setup and select this option; the extension is incremented by .001 each subsequent time that you run Setup and select this option. Setup tells you where it writes these two backup files.

Write modified version to other location

When you select this option, Setup writes the content of your current TOOLS.INI file to a new file, TOOLS.MSV, and then adds the required changes. It places this new file in the root directory of the installation (C:\MSVCNT by default). You may examine this file at your leisure before adding its content to your TOOLS.INI file.


Custom Installation Dialog Box

Use this dialog box to select the components that you want in your initial installation of Visual C++. You can also use this dialog box to upgrade an existing installation.

Microsoft Visual Workbench

Select this check box to install the Visual Workbench integrated development environment. By default, this is installed in the \MSVCNT\BIN directory.

Microsoft App Studio: Resource Editor

Select this check box to install the App Studio resource editor. This is installed in \MSVCNT\BIN by default.

Microsoft C/C++ Compiler

Select this check box to install the Microsoft C/C++ 32-bit compiler and all 32-bit build utilities and libraries. The build utilities are installed by default in the \MSVCNT\BIN directory. Libraries are installed by default in the \MSVCNT\LIB directory.

Classes

Use this button to open the Microsoft Foundation Class Library Options dialog box and select the types of libraries that you want installed. These include release and debug versions of libraries that allow you to target Windows NT and console executable files and Windows NT dynamic-link libraries. These are installed by default in \MSVCNT\MFC directory and subdirectories.

Directories

Use this button to open the Directory Options dialog box and select both the drive(s) and the directories where Setup installs the product components.

Tools

Use this button to open the Tool Options dialog box and select the types of tools that you want installed. These include Spy++, the Help Compiler, and the following Win32 SDK tools for creating programs for Windows NT: DDESpy, ZoomIn, PortTool, WinDiff, PStat, PView, and UniPad.

Help Files

Use this button to open the Help File Options dialog box and select the help files that you want installed. These include C/C++ Language help, Win32 API help, and Microsoft Foundation Classes help.

Samples

Use this button to open the Sample Source Options dialog box and select the sample files that you want installed. These sample programs are excellent examples of Windows applications written using both the Microsoft Foundation Classes and the Win32 API.

Determining Disk-Space Requirements

Installation root drive/directory

This field displays the "root drive," the drive that is currently selected to contain the Microsoft Visual C++ root directory. It also displays the current name of the root directory. These are either C:\MSVCNT\ or a drive and directory that you have specified in the Directory Options dialog box.

Space available on installation root drive

This field displays the amount of space available on the currently-selected root drive.

The Space required on installation root drive

This field displays the amount of space required for the files selected on the installation root drive. The disk space for files selected on other drives is not displayed here.

Continue

If you choose Continue, Setup presents the Registration dialog box, allowing you to associate a user's name and organization with this copy of Visual C++.

Back

If you choose Back, Setup returns to the Installation Options dialog box.

Exit

If you choose Exit, Setup presents a Setup Abort message box that allows stopping the Setup program; no files are copied to your hard disk.


Directories Options Dialog Box
Directory Options Dialog Box

Use this dialog box to specify both the drive(s) and the directories where Setup installs the product components. Any change to the Install Directory text box is propagated to the other text boxes whenever the focus changes. A change to any text box other than Install Directory is not propagated to other text boxes.

Disk Browser

The Disk Browser group of controls displays disk space information on the drive displayed in the Drive box. This feature allows you to quickly scan all available drives for disk space.  It does not change your installation drive.  This can only be done by changing the Install Directory edit box.

OK

If you choose OK, Setup saves any change to the default installation and returns to the previous dialog box.

Cancel

If you choose Cancel, Setup discards any changes to the installation configuration and returns to the previous dialog box.

Exit

If you choose Exit, Setup presents a Setup Abort message box that allows stopping the Setup program; no files are copied to your hard disk.

Note  Setup will create a directory if it does not already exist. It will not create a directory that will not contain files.


Microsoft Foundation Class Library Options Dialog Box

Use this dialog box to select the types of class libraries that you want installed. These include release and debug versions of libraries that allow you to target Windows NT and console executable files and Windows NT dynamic-link libraries.

Each different selection represents a separate library. If you are concerned about disk space, select only the libraries you need. You can run Setup at any time to install additional ones.

Library Targets

The check boxes in this control group allow you to select libraries that target Windows NT executables, Windows NT DLLs and console executables.

Library Types

The check boxes in this control group allow you to specify whether the libraries specified in the Library Targets control group contain debugging code. You can install either or both types of libraries.

Determining Disk-Space Requirements

Space Available

This field displays the amount of disk space available on the drive that will contain the libraries specified in this dialog box.

Space Required

This field displays the amount of disk space required on the drive that will contain the specified libraries.

MFC Libraries Size

This field displays the space that is required by the files specified in this dialog box.

MFC Directory

This field displays the currently-selected drive and directory for installing the libraries.

OK

If you choose OK, Setup saves any change to the default installation and returns to the Custom Installation dialog box.

Cancel

If you choose Cancel, Setup discards any change made to the default installation and returns to the Custom Installation dialog box.

Exit

If you choose Exit, Setup presents a Setup Abort message box that allows stopping the Setup program; no files are copied to your hard disk.


Tool Options Dialog Box

Use this dialog box to select the types of tools that you want installed. These include Spy++ and the Help Compiler. Also, if you select the Win32 SDK Tools check box, the following tools from the Win32 SDK for Windows NT will be added to your installation: DDESpy, ZoomIn, PortTool, WinDiff, PStat, PView, and UniPad. All of these tools are designed to simplify some portion of building applications; none of them are required.

Use this dialog box to select the types of tools that you want installed. All of these tools are designed to simplify some portion of building applications; none of them are required.

Spy++

Microsoft Spy++ is a utility that you use to examine Windows NT processes, threads, windows, window classes, and messages.  It features easy-to-navigate outline views with hot links to detail screens, and it offers flexible message filtering options.

Help Compiler

The Microsoft Help Compiler is a utility that you use to build a help file from topic and graphics files and a Help project file.

Win32 SDK Tools

When you select this check box, Setup adds the following tools from the Win32 SDK for Windows NT to your installation:

DDESpy

Microsoft Windows DDESpy is a utility you use to monitor dynamic data exchange (DDE) activity in your Microsoft Windows NT operating system.

ZoomIn

Microsoft ZoomIn is a utility you use to view areas of the Windows Desktop. You can copy an area under examination to the Clipboard and subsequently paste it to a paint program.

PortTool

Microsoft PortTool is a utility you use to search C files for code that is not portable from 16-bit targets to 32-bit targets. It analyzes files either interactively or in the background and allows you to immediately edit any non-portable code that it finds.

WinDiff

Microsoft WinDiff is an application you use to check for differences between two files or between the files in two directories.

PStat

Microsoft PStat is a command-line tool you use to view the processes and threads on your system.

PView

Microsoft PView is a utility you use to view and modify the processes and threads on your system.

UniPad

Microsoft UniPad is a text editor that represents characters with Unicode.

Determining Disk-Space Requirements

Space Available

This field displays the amount of space available on the drive that will contain the tools that are specified in this dialog box.

Space Required

This field displays the amount of space required on the drive that will contain the specified tools.

Tools Size

This field displays the space that is required by the files specified in this dialog box.

Tools Directory

This field displays the currently-selected drive and directory for installing the libraries.

OK

If you choose OK, Setup saves any change to the default installation and returns to the Custom Installation dialog box. If there are no selections, Setup clears the Tools check box in the Custom Installation dialog box.

Cancel

If you choose Cancel, Setup discards any change made to the default installation and returns to the Custom Installation dialog box.

Exit

If you choose Exit, Setup presents a Setup Abort message box that allows stopping the Setup program; no files are copied to your hard disk.


Sample Source Options Dialog Box

Use this dialog box to install the Win32 sample source code. Each sample comprises a complete body of code and provides you with practical techniques for developing with the Win32 API or the Microsoft Foundation Class Library.

Select Win32 Samples to install sample code for Win32. If selected, Setup installs them in subdirectories of \MSVCNT\SAMPLES.

Select the Microsoft Foundation Class Samples to install the C++ samples illustrating use of the Microsoft Foundation Class Library. If you select these, Setup installs them in subdirectories of \MSVCNT\MFC\SAMPLES.

For both file groups, use the Directory Options dialog box to change the destination directory.

Determining Disk-Space Requirements

Space Available

This field displays the amount of space available on the drive that will contain the samples that are specified in this dialog box.

Space Required

This field displays the amount of space required on the drive that will contain the specified samples.

Samples Size

This field displays the space that is required by the files specified in this dialog box.

Samples Directory

This field displays the currently-selected drive and directory for installing the samples.

OK

If there are selections in the Sample Sources group, Setup saves any change to the default installation and returns to the Custom Installation dialog box. If there are no selections, Setup clears the Samples check box in the Custom Installation dialog box.

Cancel

If you choose Cancel, Setup discards any change made to the default installation and returns to the Custom Installation dialog box.

Exit

If you choose Exit, Setup presents a Setup Abort message box that allows stopping the Setup program; no files are copied to your hard disk.


Help File Options Dialog Box

Use this dialog box to selectively install help files:

C/C++ Language Help

This file provides help on the C and C++ languages and the preprocessor. It also provides help on the run-time library and the iostream class library.

Win32 API Help

This file provides help on the functions that compose the Microsoft Win32 SDK.

MFC Help

This file provides help on the more than 60 reusable C++ classes that compose the Microsoft Foundation Class Library. This library supplies an application framework that includes all the Windows Graphical User Interface (GUI) features as well as general-purpose classes that support the nongraphical portion of an application.

Determining Disk-Space Requirements

Space Available

This field displays the amount of space available on the drive that will contain the help files that are specified in this dialog box.

Space Required

This field displays the amount of space required on the drive that will contain the specified help files.

Samples Size

This field displays the space that is required by the files specified in this dialog box.

Help Directory

This field displays the currently-selected drive and directory for installing the help files.

OK

If there are selections under Online Help Files, Setup saves any change to the default installation and returns to the Custom Installation dialog box. If there are no selections, Setup clears the Online Help Files check box in the Custom Installation dialog box.

Cancel

If you choose Cancel, Setup discards any change made to the default installation and returns to the Custom Installation dialog box.

Exit

If you choose Exit, Setup presents a Setup Abort message box that allows stopping the Setup program; no files are copied to your hard disk.


Registration Dialog Box

Use this dialog box to associate a user name and, optionally, an organization with this copy of Microsoft Visual C++.

Continue

If you choose Continue, Setup presents the Registration Confirmation message box, allowing you to review what you've entered in the User Name and Organization boxes. The Registration Confirmation message box contains both a Yes and a No button.

If you select Yes, Setup copies files from the installation disk to your computer.

If you select No, Setup returns you to this Registration dialog box.

Back

If you choose Back, Setup returns to the previous dialog box.

Exit

If you choose Exit, Setup presents a Setup Abort message box that allows stopping the Setup program; no files are copied to your hard disk.