Click here to Skip to main content
Click here to Skip to main content

SAPrefs - Netscape-like Preferences Dialog

, 20 Apr 2002 CPOL
Rate this:
Please Sign up or sign in to vote.
A base class for a prefereneces dialog, similar to that used in Netscape

Sample Image

CSAPrefsDialog is a base for a preferences dialog, similar to the one used in Netscape. Page selection is handled with a CTreeCtrl - pages can be "sub-pages" of other pages!

Use is very similar to CPropertySheet / CPropertyPage : create a CSAPrefsDialog object. This implements the container for your property pages. The pages are objects of type CPrefsSubDlg (a subclass of CDialog). Using these classes is as easy as this :

   // our preferences dialog
   CSAPrefsDialog dlg;

   // the "pages" (all derived from CSAPrefsSubDlg)
   CPage1 page1;
   CPage2 page2;
   CPage3 page3;
   CPage4 page4;
   
   // add 3 pages
   dlg.AddPage(page1, "Page 1");
   dlg.AddPage(page2, "Page 2");
   dlg.AddPage(page3, "Page 3");

   // this one will be a child node on the tree 
   // (&page3 specifies the parent)
   dlg.AddPage(dlg4, "Page 4", &page3);

   // the prefs dialog title
   dlg.SetTitle("This is pretty");

   // text drawn on the right side of the shaded
   // page label. this does not change when the
   // pages change, hence "constant".
   dlg.SetConstantText("SAPrefs");

   // launch it like any other dialog...
   dlg1.m_csText = m_csStupidCString;
   if (dlg.DoModal()==IDOK)
   {
     m_csStupidCString = dlg1.m_csText;
   }

To use this in your own application, you need to follow these steps :

  1. Add the following files to your project :
    • CSAPrefsDialog.cpp,.h
    • CSAPrefsSubDlg.cpp,.h
    • CSAPrefsStatic.cpp,.h
  2. Copy the IDD_SAPREFS dialog resource from the sample project to your project.
  3. Create your preference "pages" in the resource editor with the following settings :
    • Style - Child
    • Border - None
    • No OK or Cancel buttons! (pretend these are CPropertyPages!)
  4. Use Class Wizard to create the dialog classes for the pages.
  5. In the .cpp and .h files for your new dialog classes, replace all occurances of CDialog with CSAPrefsSubDlg. (you will need to #include "SAPrefsSubDlg.h")
  6. Follow the steps shown in the sample code (above) to create the main dialog and add your pages.

Notes

  • The parent/child relationships that you specify with AddPage(page, text, &parent) are strictly cosmetic. Only the tree control knows about them! As far as the CSAPrefsDialog is concerned, all pages are equal and independent of each other.
  • OnOK and OnCancel are virtual functions of CSAPrefsSubDlg. You can override them in your own derived dialogs. But, you will have to do this by-hand (implement them like any other function). Class Wizard will not be able to do this for you. These functions are called, for every page that has been viewed, when CSAPrefsSubDlg is closed by OK or Cancel.
  • You should handle "Help" as with CPropertyPage : with a WM_NOTIFY message handler :
    BOOL CMyPage::OnNotify(WPARAM wParam, LPARAM lParam, LRESULT* pResult) 
    {
    	NMHDR* pnmh = (LPNMHDR) lParam;
    	if (pnmh->code == PSN_HELP) {
    		AfxGetApp()->WinHelp(some help ID);
    	}
    
    	return CSAPrefsSubDlg::OnNotify(wParam, lParam, pResult);
    }
    
    
  • Your pages should fit inside the IDC_DLG_FRAME rectangle on the IDD_SAPREFS dialog. CSAPrefsSubDlg does not resize to fit your pages, like CPropertySheet does. This keeps things nice and simple. Auto-resizing would be a nice addition, but I don't need it for my purposes, so I didn't add it.

History

  • Jan 27 2002 - updated source files.
  • 21 April 2002 - updated source files.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Chris Losinger
Software Developer
United States United States
Chris Losinger is the president of Smaller Animals Software, Inc..

Comments and Discussions

 
QuestionThanks ! Good code, one question though PinmemberVijayDighe26-Apr-12 11:49 
AnswerRe: Thanks ! Good code, one question though PinmemberChris Losinger26-Apr-12 16:25 
QuestionBug? PinmemberManfred Drasch1-Oct-06 23:29 
AnswerRe: Bug? PinmemberChris Losinger2-Oct-06 1:54 
QuestionHow to use SAPrefs as a tab control item? Pinmembersamluo357-Aug-06 18:57 
AnswerRe: How to use SAPrefs as a tab control item? PinmemberChris Losinger8-Aug-06 1:04 
QuestionPossible to dynamically add and delete pages? Pinmemberhelsten226-Mar-06 3:44 
QuestionHow 2 use button for change the pages !!! Pinmemberc++ noob22-Dec-05 6:35 
GeneralAdded some functionality PinmemberJohn Simmons / outlaw programmer5-Apr-05 6:31 
QuestionHow do you copy a dialog resource? Pinmemberjhorstkamp27-Oct-03 9:36 
AnswerRe: How do you copy a dialog resource? PinmemberChris Losinger27-Oct-03 9:41 
QuestionSet selected page on left? PinmemberThe Lady of Shallots16-Oct-03 10:20 
GeneralSAPrefs a the basis for an app... PinmemberDocta G15-Sep-03 18:02 
GeneralRe: SAPrefs a the basis for an app... PinmemberChris Losinger16-Sep-03 1:23 
GeneralRe: SAPrefs a the basis for an app... PinmemberDocta G16-Sep-03 18:53 
GeneralRe: SAPrefs a the basis for an app... PinmemberChris Losinger17-Sep-03 1:31 
QuestionHow can I make the subpages appear extended? PinmemberDanYELL1-May-03 17:32 
AnswerRe: How can I make the subpages appear extended? PinmemberChris Losinger2-May-03 1:32 
GeneralAnother Idea for Netscape-like Preferences Dialog PinmemberKoundinya2-Mar-03 22:53 
GeneralRe: Another Idea for Netscape-like Preferences Dialog PinmemberChris Losinger3-Mar-03 3:35 
GeneralDestroyWindow PinsussAnonymous13-Jan-03 9:39 
GeneralRe: DestroyWindow PinmemberChris Losinger13-Jan-03 9:50 
GeneralProblem selecting controls on the pages PinsussGNW6-Dec-02 10:56 
GeneralRe: Problem selecting controls on the pages PinmemberChris Losinger6-Dec-02 11:00 
GeneralRe: Problem selecting controls on the pages PinsussAnonymous13-Dec-02 10:42 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web04 | 2.8.141015.1 | Last Updated 21 Apr 2002
Article Copyright 1999 by Chris Losinger
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid