HOWTO: Create a Modeless CPropertySheet With Standard Buttons

• The Microsoft Foundation Classes (MFC) included with: Microsoft Visual C++, 32-bit Editions, versions 4.0, 4.1, 4.2, 5.0

SUMMARY

By default, a modeless CPropertySheet does not have any of the standard buttons that are in a modal CPropertySheet. These are the OK, Cancel, and Apply buttons. For a modeless CPropertySheet, MFC resizes the sheet and hides these buttons in CPropertySheet::OnInitDialog(). To prevent MFC from doing this, derive a class from CPropertySheet, override OnInitDialog(), and set "m_bModeless" to FALSE before CPropertySheet::OnInitDialog(). You should set "m_bModeless" back to TRUE after CPropertySheet::OnInitDialog().

MORE INFORMATION

Note that the standard buttons do not work the same way in a modeless CPropertySheet as they do in a modal one. Namely, the OK and Cancel buttons do not close the CPropertySheet when you click them. They will still send a WM_COMMAND message with IDOK or IDCANCEL to the sheet, and OnOK() or OnCancel() will still be called for the page. You can set up ON_COMMAND() handlers for IDOK and IDCANCEL in the CPropertySheet and call EndDialog() to close the sheet.

Sample Code

// CMySheet is derived from CPropertySheet

   m_bModeless = FALSE;
   BOOL bResult = CPropertySheet::OnInitDialog();
   m_bModeless = TRUE;
   return bResult;

/* Compile options needed: default
*/