Click here to Skip to main content
15,867,594 members
Articles / Desktop Programming / MFC
Article

Rollup Control

Rate me:
Please Sign up or sign in to vote.
4.94/5 (54 votes)
16 Dec 20032 min read 376.6K   6.5K   118   86
A 3DSMax like Rollup control

Introduction

I wanted the same graphic control that 3DSMax use in the pages 'create' and 'modify'. It is called a 'Rollup Window Control', which allows one to roll and unroll dialog boxes and to scroll them in the control's client area. The CRollupCtrl MFC class is the result. The class definition and implementation are in the files RollupCtrl.h and RollupCtrl.cpp, which are included in the demo project.

Features

  • The control is derived from the CWnd class and can be created in any window.
  • Pages are composed of a title, visualized by a button and a template (the dialog box).
  • Pages can have several states. They can be rolled/unrolled but can also be active and inactive. To roll-unroll a page allows you to hide or show dialog box, respectively. To deactivate a page, lock the dialog box in the rolled state.
  • The control is resizable and can also scroll pages. To scroll pages you can use the scrollbar or click inside an open dialog box and drag outside it to scroll the control.

Using the Control

To use this control in your application, add the RollupCtrl.h and RollupCtrl.cpp files to your project. The creation of the control is made by calling the CRollupCtrl::Create(...) method. There are two ways to insert a page.

  1. RUNTIME_CLASS method

    Create a dialog box in the resource editor 'ex. IDD_PAGE1' with the WS_CHILD style. Generate the declaration and implementation files class (ex. CPage1Dlg) of your dialog box with the assistance of the MFC Classwizard. Then add DECLARE_DYNCREATE(CPage1Dlg) in the declaration of the class and IMPLEMENT_DYNCREATE(CPage1Dlg, CDialog) in the implementation.

    Then insert the page in this way pwndRollupCtrl->InsertPage("Caption", IDD_PAGE1, RUNTIME_CLASS(CPage1Dlg) );

  2. CDialog::Create method

    As RUNTIME_CLASS method, create a dialog box in the resource editor. Generate the declaration and implementation files class of your dialog box. Then create the dialog box like this

    CPage1Dlg* pwndPage1 = new CPage1Dlg;<BR>pwndPage1->Create(MAKEINTRESOURCE(IDD_PAGE1), pwndRollupCtrl);

    and insert the page as follows

    pwndRollupCtrl->InsertPage("Caption", pwndPage1 );

This code has been tested only on W2K. If you have any other suggested improvements, please let me know for the next release.

User Methods

V1.00

BOOL     Create(DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID);
int      InsertPage(const char* caption, CDialog* pwndTemplate,
                   BOOL bAutoDestroyTpl=TRUE, int idx=-1);
int      InsertPage(const char* caption, UINT nIDTemplate, int idx=-1);
int      InsertPage(const char* caption, UINT nIDTemplate, 
                   CRuntimeClass* rtc, int idx=-1);
void     RemovePage(int idx);
void     RemoveAllPages();
void     ExpandPage(int idx, BOOL bExpand=TRUE);    
void     ExpandAllPages(BOOL bExpand=TRUE);
void     EnablePage(int idx, BOOL bEnable=TRUE);
void     EnableAllPages(BOOL bEnable=TRUE);
RC_PAGEINFO* CRollupCtrl::GetPageInfo(int idx); 

V1.01

void     ScrollToPage(int idx, BOOL bAtTheTop=TRUE);
int     MovePageAt(int idx, int newidx);
BOOL     IsPageExpanded(int idx);
BOOL     IsPageEnabled(int idx);
int     GetPagesCount();

V1.02

BOOL     IsAutoColumnsEnabled();
void     EnableAutoColumns(BOOL bEnable=TRUE);
BOOL     SetColumnWidth(int nWidth);
BOOL     SetPageCaption(int idx, LPCSTR caption); 

History

  • v1.0
    31/03/01: Created
  • v1.01
    13/04/01: Added ScrollToPage method
    Added automatic page visibility to ExpandPage method
    Added Mousewheel support
    15/04/01: Added mouse capture checking on WM_MOUSEMOVE dialog msg
    Added SetCursor on Dialog WM_SETCURSOR
    Added MovePageAt method
    17/04/01: Fixed Group Boxes displayed over Buttons
    20/04/01: Added IsPageExpanded and IsPageExpanded methods
    Added PopupMenu
    Added Button subclassing (now button's focus not drawn)
  • v1.02
    10/06/02: Added pages dividing up into columns
    17/06/02: Added SetPageCaption method
    19/11/02: Fixed _RemovePage method
    29/10/03: Background color for AfxRegisterWndClass

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
France France
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralBugfix in RemovePage 2 Pin
5-Jun-02 7:20
suss5-Jun-02 7:20 
GeneralExcellent, but the background is white Pin
28-May-02 7:33
suss28-May-02 7:33 
GeneralRe: Excellent, but the background is white Pin
Gero Gerber30-Jul-02 4:30
Gero Gerber30-Jul-02 4:30 
GeneralRe: Excellent, but the background is white Pin
Kevin Weil23-Jul-03 22:51
Kevin Weil23-Jul-03 22:51 
GeneralVariable Pin
ADi.200020-Apr-02 22:45
ADi.200020-Apr-02 22:45 
GeneralCrash !!!!! Please, help! Pin
3-Apr-02 7:05
suss3-Apr-02 7:05 
GeneralResize To Fit Window Pin
Matt Newman29-Mar-02 13:08
Matt Newman29-Mar-02 13:08 
GeneralRe: Resize To Fit Window Pin
Anonymous17-Jul-02 10:18
Anonymous17-Jul-02 10:18 
GeneralRe: Resize To Fit Window Pin
Matt Newman18-Jul-02 9:10
Matt Newman18-Jul-02 9:10 
QuestionHow can I change the direction to horizental not to vertical... Pin
28-Jan-02 4:35
suss28-Jan-02 4:35 
Generalc# Pin
Pashabhai24-Jan-02 23:30
Pashabhai24-Jan-02 23:30 
GeneralBug fix in RemovePage Pin
James French26-Nov-01 5:55
James French26-Nov-01 5:55 
GeneralQuestion Pin
6-Sep-01 18:16
suss6-Sep-01 18:16 
GeneralRe: Question Pin
James French11-Sep-01 1:47
James French11-Sep-01 1:47 
GeneralExcellent, with one issue Pin
James French5-Sep-01 1:49
James French5-Sep-01 1:49 
GeneralRe: Excellent, with one issue Pin
2-Apr-02 9:18
suss2-Apr-02 9:18 
GeneralRe: Excellent, with one issue Pin
CelticEye13-Jul-03 22:32
CelticEye13-Jul-03 22:32 
Generaltest message Pin
James French5-Sep-01 1:46
James French5-Sep-01 1:46 
GeneralExcellent work! Pin
Bil Simser17-Aug-01 9:47
Bil Simser17-Aug-01 9:47 
GeneralDisapearing Page Pin
10-Jul-01 9:56
suss10-Jul-01 9:56 
GeneralRe: Disapearing Page Pin
rekeu16-Jul-01 4:09
rekeu16-Jul-01 4:09 
GeneralRe: Disapearing Page Pin
19-Jul-01 14:23
suss19-Jul-01 14:23 
GeneralRe: Disapearing Page Pin
rekeu23-Jul-01 3:46
rekeu23-Jul-01 3:46 
GeneralRe: Disapearing Page Pin
25-May-02 7:52
suss25-May-02 7:52 
GeneralInteresting but... Pin
7-May-01 3:12
suss7-May-01 3:12 

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

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