CONFIRM.INF

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.

CONFIRM.INF contains a human-readable description of each project component (such as the project name and the names of its primary classes). It also contains a description of each feature that a custom AppWizard user can select from each step. The following code shows how macros and flow-of-control directives are used to generalize the content of a CONFIRM.INF:

$$// confirm.inf = the text sent to the New Project
$$// Information dialog box
Application type of $$ROOT$$:
    Dialog-Based Application targeting:
        Win32

Classes to be created:
    Application: $$APP_CLASS$$ in $$ROOT$$.h and $$ROOT$$.cpp
    Dialog: $$DLG_CLASS$$ in $$DLG_HFILE$$.h and $$DLG_IFILE$$.cpp

Features:
   + About box on system menu
$$IF(INDENTED_BRACES)
   + Curly braces indented from previous level
$$ELSE // !INDENTED_BRACES
   + Curly braces flush with previous level
$$ENDIF // NOT_INDENTED_BRACES
$$IF(COMPANY_LOGO)
   + A company logo
$$ENDIF //COMPANY_LOGO
$$IF(3-D)
   + 3D Controls
$$ENDIF //3-D

This example of CONFIRM.INF contains lines of text (such as Classes to be created:), macros (such as $$APP_CLASS$$ and $$ROOT$$), and flow-of-control directives (such as $$IF and $$ENDIF). Once a user clicks Finish in a custom AppWizard, MFCAPWZ.DLL parses CONFIRM.INF as follows:

• Each line of text is gathered into a CString object, and each encountered macro is expanded.
  
  
• Any line beginning with $$// is a comment and is ignored.
  
  
• Any line of text between an $$IF and an $$ENDIF is converted to a CString if the associated macro, such as INDENTED_BRACES and COMPANY_LOGO, exists and thus evaluates to true.
  
  
• The resulting CStrings reflect the custom AppWizard user’s choices and are written to the New Project Information dialog box. Thus, they can view the features of their proposed project.

What do you want to know more about?

• Text template parsing
  
  
• An overview of creating a custom AppWizard
  
  
• How to create a custom AppWizard project
  
  
• The files that AppWizard creates
  
  
• Adding functionality to a custom AppWizard
  
  
• CONFIRM.INF and NEWPROJ.INF
  
  
• NEWPROJ.INF
  
  
• Text templates
  
  
• How macros get their values
  
  
• How to specify macros in directives or text
  
  
• Creating a ClassWizard information file template
  
  
• Providing context-sensitive help
  
  
• The AppWizard Programming Reference