Click here to Skip to main content
15,867,756 members
Articles / Desktop Programming / WTL
Article

Resizable Property Sheet/Wizard using CDialogResize

Rate me:
Please Sign up or sign in to vote.
4.27/5 (9 votes)
12 Mar 20072 min read 87.4K   1.9K   30   15
Make Property Sheet/Wizards resizable without much modification.

Screenshot

Introduction

Since I once created an re-sizable property sheet implementation in plain C, I decided also to do so in WTL. My goal during implementation was to stay as close as possible on WTL original source. This leads to an implementation which could 1 by 1 replaced by conventional source.

Features

  1. Resizable Property Sheet window class
  2. Resizable Property Sheet Page class (see CDialogResize for more information about usage)
  3. Double buffered redraw is possible using WS_EX_COMPOSITED (Sheet window only)
  4. CDialogResize extension called CDialogResizeDynamic to support runtime resize map manipulation

Background

Since the property sheet class implements Wizard (97) style dialogs and default property sheets, and since I want to derive my new class from CDialogResize, I was forced to create a WTL modifications.

Instead of using static GetDlgResizeMap() I decided to use a dynamic Implementation to support runtime resize manipulation. I derived a new class from CDialogResize and added methods for adding and removing resize map entries.

C++
BEGIN_DLGRESIZE_MAP_EX(CResizablePropertySheetImpl)
    DLGRESIZE_CONTROL_EX(ID_PSHEET_OK, DLSZ_MOVE_X | DLSZ_MOVE_Y)
    DLGRESIZE_CONTROL_EX(ID_PSHEET_APPLY, DLSZ_MOVE_X | DLSZ_MOVE_Y)
    DLGRESIZE_CONTROL_EX(ID_PSHEET_CANCEL, DLSZ_MOVE_X | DLSZ_MOVE_Y)
    DLGRESIZE_CONTROL_EX(ID_PSHEET_HELP, DLSZ_MOVE_X | DLSZ_MOVE_Y)
    DLGRESIZE_CONTROL_EX(ID_PSHEET_TAB, DLSZ_SIZE_X | DLSZ_SIZE_Y)
END_DLGRESIZE_MAP_EX()

Above declaration will be evaluated as

C++
void StaticResizeMap() {
    InitialMap.Add(ID_PSHEET_OK, DLSZ_MOVE_X | DLSZ_MOVE_Y);
    ...
    InitialMap.Add(ID_PSHEET_TAB, DLSZ_SIZE_X | DLSZ_SIZE_Y);
    InitialMap.Add(-1, 0);
}

Please note, the use of the old BEGIN_DLGRESIZE_MAP has no effect and will be ignored. StaticResizeMap method will be called within CDialogResizeDynamic constructor.

Using the code

There is not much need of code modification on your existing source code. You have to replace CPropertySheetImpl with CResizablePropertySheetImpl

C++
class CMyPropertySheet :
    public CResizablePropertySheetImpl<CMyPropertySheet> {
public:
    CMyPropertySheet(ATL::_U_STRINGorID title = (LPCTSTR) NULL, 
     UINT uStartPage = 0, HWND hWndParent = NULL,
    bool EnableDoubleBuffering = false, bool IsWizard = false)
    : CResizablePropertySheetImpl<CMyPropertySheet>(title, 
     uStartPage, hWndParent, EnableDoubleBuffering, IsWizard) {
    }
    ...

As you may note constructor is extended by two additional parameters. EnableDoubleBuffering will enable double buffering (no flickering) as the name implies. IsWizard will create an wizard style property sheet. However, you should use double buffering with care because it may slow down rendering and may cause unpredictable behaviour in some circumstances.

C++
class CMyResizablePropertyPage :
    public CResizablePropertyPageImpl<CMyResizablePropertyPage> {
public:
    enum { IDD = IDD_0 };
    CMyResizablePropertyPage(ATL::_U_STRINGorID title = (LPCTSTR) NULL, 
     bool IsExterior = false) :
    CResizablePropertyPageImpl<CMyResizablePropertyPage>(title, 
     IsExterior) {
    }
    ...

As you may note, I extended property page constructor. If IsExterior is true, an exterior page will be created i.e. that page that usually is used for welcome and completion page.

To add, remove or change resize map items at runtime you may use one of the new CDialogResizeDynamic methods:

C++
void AddToResizeMap(int ControlId, DWORD ResizeFlags);
void RemoveFromResizeMap(int ControlId);
void ChangeResizeMapEntry(int ControlId, DWORD ResizeFlags);

Adding new resize map groups after DlgResize_Init is called is currently not possible.

History

  • 2007/03/07: Added some extensions, resize map is dynamic now.
  • 2004/02/24: Initial release

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
Germany Germany
Hobby: system programing (operating system and hardware)
Prefered languages are x86 assembler, c and c++.
Currently student of applied computer science at university of applied sciences Bingen (Germany)

Comments and Discussions

 
GeneralExcellent But MFC!!!! Pin
john563213-Apr-09 22:41
john563213-Apr-09 22:41 
GeneralRe: Excellent But MFC!!!! Pin
bkausbk4-Dec-09 1:05
bkausbk4-Dec-09 1:05 
GeneralExcellent Pin
Yogesh Dhakad1-May-07 13:40
Yogesh Dhakad1-May-07 13:40 
GeneralNice, but... Pin
free2000fly3-Aug-06 20:44
free2000fly3-Aug-06 20:44 
GeneralRe: Nice, but... [modified] Pin
free2000fly4-Aug-06 15:41
free2000fly4-Aug-06 15:41 
GeneralRe: Nice, but... Pin
free2000fly4-Aug-06 16:02
free2000fly4-Aug-06 16:02 
GeneralRe: Nice, but... Pin
bkausbk6-Mar-07 16:20
bkausbk6-Mar-07 16:20 
GeneralList Control on a page with double buffering causes problems Pin
michael_ro200022-Dec-05 23:27
michael_ro200022-Dec-05 23:27 
GeneralRe: List Control on a page with double buffering causes problems Pin
michael_ro200023-Dec-05 1:27
michael_ro200023-Dec-05 1:27 
GeneralRe: List Control on a page with double buffering causes problems Pin
bkausbk5-Feb-06 23:41
bkausbk5-Feb-06 23:41 
Generalcould you provide a full sample Pin
liuliu3-Nov-05 22:52
liuliu3-Nov-05 22:52 
GeneralRe: could you provide a full sample Pin
bkausbk22-Nov-05 3:38
bkausbk22-Nov-05 3:38 
GeneralASSERTS at start and finish Pin
Alexander D. Alexeev25-Feb-05 4:06
Alexander D. Alexeev25-Feb-05 4:06 
GeneralRe: ASSERTS at start and finish Pin
bkausbk25-Feb-05 4:49
bkausbk25-Feb-05 4:49 
GeneralRe: ASSERTS at start and finish Pin
bkausbk25-Feb-05 12:52
bkausbk25-Feb-05 12:52 

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.