SAMPLE: How to Use Three Different Styles of Property Sheets

• Microsoft Win32 Software Development Kit (SDK) versions 3.51, 4.0
• Microsoft Win32s version 1.30

SUMMARY

The PROPERTY sample code demonstrates how to use three different styles of property sheets: modal, modeless, and wizard.

Download PROPERTY.EXE, a self-extracting file, from the Microsoft Software Library (MSL) on the following services:

• Microsoft Download Service (MSDL)

        Dial (206) 936-6735 to connect to MSDL
        Download PROPERTY.EXE (size: 22948 bytes) 
  

• Internet (anonymous FTP)

        ftp ftp.microsoft.com
        Change to the SOFTLIB\MSLFILES directory
        Get PROPERTY.EXE (size: 22948 bytes) 
  

MORE INFORMATION

The main problem in dealing with a modeless property sheet is knowing when to destroy the property sheet. This is handled in the application's main message loop using the PSM_GETCURRENTPAGEHWND message (PropSheet_GetCurrentPageHwnd macro). PSM_GETCURRENTPAGEHWND returns NULL after the OK or Cancel buttons have been clicked (or the dialog box has been closed) and all of the pages have been notified. The application can then call DestroyWindow on the window handle that was returned from the PropertySheet call.

The sample also demonstrates how to use the PropSheetCallback function to modify the property sheet dialog box before or after it is created. The Wizard property sheet is modified to contain a system menu.