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

Rollup Control

, 16 Dec 2003
Rate this:
Please Sign up or sign in to vote.
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. <!--
  • The insertion of a dialog box in the control is made by the intermediate of pages.
  • -->
  • 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;
    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

About the Author

No Biography provided

Comments and Discussions

 
GeneralRe: Patented PinmemberSven Axelsson17-Dec-03 2:42 
GeneralRe: Patented PinmemberTriac8-Jan-04 21:26 
GeneralRe: Patented Pinmembersteblublu17-Feb-06 4:02 
Generaldrag page to reposition Pinmembersovann20-Nov-03 23:43 
Hi!
 
First of all, this control is coolSmile | :) I think it is nice if the control can do this: user can drag and drop a page to any position they want while an alpha preview of the where the page will land in goes along the mouse.
 
Good Luck!
GeneralWerks great. I love it. PinmemberKeith Ackermann17-Nov-03 10:20 
Generalnice Pinmemberl a u r e n12-Nov-03 5:52 
GeneralFantastic control PinmemberBadJerry11-Nov-03 23:21 
GeneralFlickering problem Pinmemberdmsika19-Aug-03 7:01 
GeneralRe: Flickering problem Pinmemberdmsika19-Aug-03 7:38 
GeneralStrange Problem PinmemberLivid11-Jul-03 7:31 

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
Web01 | 2.8.140709.1 | Last Updated 17 Dec 2003
Article Copyright 2001 by Johann Nadalutti
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid