DOCUMENT:Q262024  03-MAY-2001  [visualc]
TITLE   :HOWTO: Use CPropertySheet as a Child of CSplitterWnd
PRODUCT :Microsoft C Compiler
PROD/VER:winnt:5.0,6.0
OPER/SYS:
KEYWORDS:kbDlg kbDocView kbMFC kbPropSheet kbDSupport kbGrpDSMFCATL

======================================================================
-------------------------------------------------------------------------------
The information in this article applies to:

 - The Microsoft Foundation Classes (MFC), included with:
    - Microsoft Visual C++, 32-bit Enterprise Edition, version 5.0 
    - Microsoft Visual C++, 32-bit Professional Edition, version 5.0 
    - Microsoft Visual C++, 32-bit Enterprise Edition, version 6.0 
    - Microsoft Visual C++, 32-bit Professional Edition, version 6.0 
    - Microsoft Visual C++, 32-bit Learning Edition, version 6.0 
-------------------------------------------------------------------------------

SUMMARY
=======

This article describes how to create a property sheet or tabbed view on the left
or right pane of a splitter window (CSplitterWnd), similar to the MSDN library
property sheet.

MORE INFORMATION
================

Steps to Create a Sample Project:
---------------------------------

1. Create a Microsoft Foundation Class Library (MFC) AppWizard (.exe) based
   project named Sample.

2. In step 1 of the MFC AppWizard, select the Single Document check box.

3. For steps 2 through 4 of the MFC AppWizard, select the default settings.

4. In step 5 of the MFC AppWizard, select the Windows Explorer check box as the
   project style.

5. For step 6 of the MFC AppWizard, select the default setting.

6. Form the Project menu, point to Add to Project, and then select Components
   and Controls.... Under Visual C++ Components, select Property Sheet, and then
   click Insert and OK.

7. In the Property Sheet wizard, select Property Sheet, select Yes for Modeless,
   and then give CSampleView access to this property sheet. Select the default
   for the remaining items on the wizard. Close the Components and Controls
   dialog box. The property sheet is displayed in the right pane.

8. Add a protected member variable to CSampleView, as demonstrated in the
   following example:

   protected:
            CMyPropertySheet* m_pSheet;

9. Add the following line to the CSampleView Constructor:

   m_pSheet = new CMyPropertySheet();

10. Add a WM_CREATE message to CSampleView with Windows Message and Event
   Handler, and then add the following code to the handler:

   m_pSheet->Create(this,WS_CHILD | WS_VISIBLE | WS_THICKFRAME);

The code for the handler looks like the following:

   int CSampleView::OnCreate(LPCREATESTRUCT lpCreateStruct) 
   {
   	if (CListView::OnCreate(lpCreateStruct) == -1)
   		return -1;
   	
   	m_pSheet->Create(this,WS_CHILD | WS_VISIBLE | WS_THICKFRAME);
   	return 0;
   }

11. Use Windows Message and Event Handler to add a WM_SIZE message to
   CSampleView, and then add the following code to the handler:

   void CSampleView::OnSize(UINT nType, int cx, int cy) 
   {
   	CListView::OnSize(nType, cx, cy);
   	
   	// TODO: Add your message handler code here
   	m_pSheet->MoveWindow(CRect(0,0,cx,cy));
   	m_pSheet->GetTabControl()->MoveWindow(0,0,cx,cy);
   }

12. Use the Windows Message and Event Handler to add a WM_DESTROY message to
   CSampleView, and then add the following code to the handler:

   void CSampleView::OnDestroy() 
   {
       CListView::OnDestroy();
       m_pSheet->DestroyWindow();
   }

13. Select Build, and then select Rebuild All. Correct any errors, and then
   execute the sample.

(c) Microsoft Corporation 2000, All Rights Reserved.
Contributions by Vidyanand Rajpathak, Microsoft Corporation


Additional query words:

======================================================================
Keywords          : kbDlg kbDocView kbMFC kbPropSheet kbDSupport kbGrpDSMFCATL 
Technology        : kbAudDeveloper kbMFC
Version           : winnt:5.0,6.0
Issue type        : kbhowto

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 2001.