One aspect of the Chameleon generated example projects which can be confusing, is how the pre-compiled headers are set up. Most Visual C++ programmers are used to seeing the use of a standard stdafx.h header file for setting up precompiled headers. The example C++ project produced by Chameleon uses a different approach.

Basically, one file in your project is responsible for creating the pre-compiled header file. This is set up in the Visual C++ project settings dialog:

One File Creates the Precompiled Header

Every other file in the project is configured to use this precompiled header. This is also viewable in the project settings dialog:

Standard Precompiled Header Settings

As a result of these settings, it's important that every cpp file in the project has the following included and pragma at the start:

#include <CHM/CHMpreCompHead.h>
#pragma hdrstop

More information about this pragma can be obtained by reading about it in the Microsoft Developers Network (MSDN).

	The CHM_NO_PRECOMPILED_HEADERS macro can be switched on for compilers which do not support precompiled headers.