Advanced MFC Programming

Chapter 6. Dialog Box
}
Function CPropertySheet::AddPage(…) has only one parameter, it is a pointer to CPropertyPage type
object.
These are the necessary steps for implementing property sheet. For each property page, we can also
add message handlers for the controls, the procedure of which is the same with that of a standalone dialog
box.
By default, the property sheet will be implemented in “tab” mode: there will be a tab control in the
property sheet, which can be used to select property pages. The property sheet can also be implemented in
“wizard” mode, in which case tab control will be replaced by two buttons (labeled with “Previous” and
“Next”). In this mode, the pages can only be selected sequentially through button clickings.
To enable wizard mode, all we need to do is calling function CPropertySheet::
SetWizardMode()after all the pages have been added. For example, if we want to enable wizard mode in
the sample, we should implement the constructor of CDBDlg as follows:
CDBDlg::CDBDlg(CWnd* pParent /*=NULL*/) : CPropertySheet()
{
//{{AFX_DATA_INIT(CDBDlg)
//}}AFX_DATA_INIT
m_hIcon = AfxGetApp()->LoadIcon(IDR_MAINFRAME);
AddPage(&m_page1);
AddPage(&m_page2);
AddPage(&m_page3);
SetWizardMode();
}
Sample 6.2-2\DB is the same with sample 6.2-1\DB, except that the property sheet is implemented in
wizard mode.
If we need to implement a property sheet dialog box in an SDI or MDI application, most of the steps
are still the same. We can start by creating a new CPropertySheet based class, then adding dialog
templates and CPropertyPage based classes, using them to declare new variables in CPropertySheet
derived class, calling function CPropertySheet::AddPage(…) in its constructor. We can call function
CPropertySheet::DoModal() at anytime to invoke the property sheet.
6.3 Modeless Property Sheet
Because property sheet is very similar to dialog box, implementation of modeless property sheet is also
similar to that of modeless dialog box: when invoking the property sheet dialog box, instead of calling
function CPropertySheet::DoModal(), we need to call CPropertySheet::Create(…) and CWnd::
ShwoWindow(…). We can use exactly the same method discussed in section 6.1 to implement modeless
property sheet.
Sample 6.3\DB demonstrates how to implement modeless property sheet. It is a standard SDI
application generated by Application Wizard. A command Property Sheet | Modeless is added to
mainframe menu IDR_MAINFRAME, whose ID is ID_PROPERTYSHEET_MODELESS. A WM_COMMAND message
handler is also added for this command, and the corresponding function is
CDBDoc::OnPropertysheetModeless().
A new class CMLPropertySheet is defined to implement modeless property sheet, whose base class is
CPropertySheet. Like what we did in sample 6.1\DB, function DoModeless() is declared in class
CMLPropertySheet, which can be used to invoke the property sheet.
Three dialog box templates IDD_DIALOG_PAGE1, IDD_DIALOG_PAGE2 and IDD_DIALOG_PAGE3 are created
to implement property pages. Also three new classes CPage1, CPage2 and CPage3 are derived from
CPropertyPage. A CWnd type pointer m_pParentWnd and three other member variables declared by CPage1,
CPage2 and CPage3 are added to class CMLPropertySheet. The following is the modified class:
class CMLPropertySheet : public CPropertySheet
{
DECLARE_DYNAMIC(CMLPropertySheet)
145