SetNumberOfSteps

Home | Overviews | How Do I | Details | Sample

Feature Only in Professional and Enterprise Editions Creating a Custom AppWizard is supported only in Visual C++ Professional and Enterprise Editions. For more information, see Visual C++ Editions.

void SetNumberOfSteps( int nSteps );

Parameters

nSteps

The total number of steps that your custom AppWizard presents to its users. Set nSteps to -1 to communicate to MFCAPWZ.DLL that you want your custom AppWizard’s title bar to display only the current step number (for example, “Step 1” rather than “Step 1 of 6”). Set nSteps to 0 to communicate to MFCAPWZ.DLL that your custom AppWizard has no steps and only wants to use the New Project Workspace or the Insert Project dialog boxes (for example, when your custom AppWizard is based on an existing project, and there are no options for the custom AppWizard user to select.)

Remarks

Your custom AppWizard calls SetNumberOfSteps in CCustomAppWiz::InitCustomAppWiz to communicate the total number of steps to MFCAPWZ.DLL. The resulting information allows MFCAPWZ.DLL to accurately number the steps in your custom AppWizard’s title bar and to correctly activate or gray the Next button.

Although the initial call to SetNumberOfSteps in InitCustomAppWiz is generated for you, you should also call it when an end user’s choice will change the number of steps the user will see.