Visual C++ 6 Unleashed

Visual C++ 6 Unleashed

By MICKEY WILLIAMS and David Bennett

Understanding Property Sheets

From a coding perspective, you should think of a property sheet as a collection of individual modeless dialog boxes (representing each page) held inside a larger modal dialog box.

The property sheet itself is implemented down at Win32 level as a dialog box that contains a tab control (one of the common controls) and a set of controlling buttons, such as OK, Cancel, Apply, and Help. The tab control handles the individual dialog boxes that make up the property sheet pages.

Fortunately the MFC wrapper classes CPropertySheet and CPropertyPage greatly simplify the creation and operation of a property sheet and its property pages. Visual C++ 6 introduces support for the new Wizard97 style (only supported on NT 5 and Windows 98), which extends standard property sheet classes with the new CPropertySheetEx and CPropertyPageEx classes. The Wizard97 style specifies new design elements for wizard pages, such as areas for header sections. Information on the Wizard97 specification can be found in the MSDN online help, in the section titled, "Wizard 97". Note that there is a space in the title between Wizard and 97. The documentation from Microsoft is inconsistent in some places, but the true name of the specification appears to be Wizard97 (no spaces), most of the time.

There are two main modes of operation for property sheets. The usual mode lets users select between the various pages via the familiar tab control at the top of the property sheet. Users can implement the changes while keeping the sheet open by clicking the Apply button; or they can click OK or Cancel to end the property sheet in the same way as a modeless dialog box.

Another mode is the Wizard style, where users navigate from the start of a sequence of pages to the end using Next and Back buttons. When they reach the end of the sequence, they can implement the changes they've specified by clicking Finish or cancel them by clicking Cancel at any point in the sequence.

The rest of this chapter discusses how you can implement property sheets for both these modes via the MFC wrapper classes.

Share ThisShare This

Informit Network