SAMPLE: How to Use Three Different Styles of Property Sheets (132919)


The information in this article applies to:

  • Microsoft Win32 Software Development Kit (SDK) 3.51
  • Microsoft Win32 Software Development Kit (SDK) 4.0
This article was previously published under Q132919

SUMMARY

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

MORE INFORMATION

The following file is available for download from the Microsoft Download Center:

Property.exe

For additional information about how to download Microsoft Support files, click the following article number to view the article in the Microsoft Knowledge Base:

119591 How to Obtain Microsoft Support Files from Online Services

Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help to prevent any unauthorized changes to the file.

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.
Modification Type:MinorLast Reviewed:3/7/2005
Keywords:kbdownload KB132919 kbAudDeveloper
©2004 Microsoft Corporation. All rights reserved.