A generic Tree Property Sheet control

CTreePropertySheet


This class implements a generic tree property control (see picture above).





Its features are:

– Supports variable width tree control

– Autosizing depending on the size of the dialogs contained

– As this version is now based upon the CPropertySheet/ CPropertyPage model, all
features of these are available.

– Various styles(for example, like Netscape Communicator’s property sheet)

– Extensibility: Allows to integrate user defined controls (like buttons or static
text boxes) and easily position them.
– Now supports modeless property sheets as well.





How to implement a CTreePropertySheet in your application:


Step 1.

    Insert “TreePropertySheet.cpp” to your application.


Step 2.

    Insert an



    #include “TreePropertySheet.h”



    in the class implementation
    file in which you want to use the CTreePropertySheet.

Step 3.

    Define a function which invokes the property sheet, for example:



    void CMyView::OnPropertySheet()
    {
    // TODO: …
    }


Step 4.

    Create a CTreePropertySheet object in the handler and the property pages you
    want to use with CTreePropertySheet:


    CTreePropertySheet tpsSheet;
    CGeneralPrefsPage cGeneralPrefs;
    COtherPrefsPage cOtherPrefs;
    // All dialogs contained in the property sheet must (now) be allocated from the stack.

    Caution: To make it work, the dialogs you want to include must have the following
    style:

    Style: ‘Child’

    Border: None
    Caption: Yes
    – Set the caption to the text you wish to appear when the page is selected.

    – All other options must be unchecked.


Step 5.

    Add the dialogs to the tree property sheet:


    tpsSheet.AddPage(tps_item_node,&cGeneralPrefs);
    tpsSheet.AddPage(tps_item_node,&cOtherPrefs);

    You have to specify the resource ID when adding the dialog. The text argument
    is the title shown up in the tree control, ‘tps_item_node’ tells that this is
    a simple node in the tree.

    (See below for more information)

Step 6.


    Start the property sheet:


    int nRetCode=tpsSheet.DoModal();

    Optionally, you can set a special pre-defined style before
    DoModal():



    tpsSheet.SetLikeNetscape();
    int nRetCode=tpsSheet.DoModal();







Remarks

To set up the tree structure, there are three different attributes for ‘AddPage()’:

tps_item_branch This item has sub-items. All following items are one level
below this item, until a ‘tps_item_endbranch’ is found.
tps_item_node This item is a simple node in the tree.
tps_item_endbranch This item is the last item of the current sub-branch(which was
initiated with an tps_item_branch). All following items are on the
same level as the corresponding ‘tps_item_branch’ entry.

To make it clearer, please take a look at the table below:

(tree control contents) (code)
+ Main preferences AddPage(tps_item_branch, &cMainPrefsPage);
&nbsp&nbsp&nbsp&nbsp- Directories AddPage(tps_item_node, &cDirectoriesPage);
&nbsp&nbsp&nbsp&nbsp- User information AddPage(tps_item_node, &cUserPage);
&nbsp&nbsp&nbsp&nbsp- Plugins AddPage(tps_item_endbranch, &cPluginPage);
– Security AddPage(tps_item_node, &cSecurityPage);



If you want to enhance the CTreePropertySheet by own controls or buttons,
this can be done using InsertExtraControl() / InsertExtraSpace().

For more information about these functions, please take a look into the HTML help file(see below) and into
the example project.


Downloads

Download help file – 29 KB

Download demo project – 52 KB

Download source – 14 KB




These files can also be downloaded at
http://members.xoom.com/softserv/tps_index.html

More by Author

Must Read