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

Delphi/VB/VS.NET-style ObjectInspector Control

Rate me:
Please Sign up or sign in to vote.
4.44/5 (8 votes)
4 Aug 20011 min read 93.8K   2.2K   38   16
A Delphi-Style Object Inspector

Sample Image #1 Sample Image #2

Introduction

This control is an implementation of a Delphi/VB/VS.NET - Style Object-Inspector. I use this control in many of my applications' property pages to let the user quickly change application settings. I've tried to keep things as simple as possible, although usage of this control may look a bit strange at first sight - the interfaces of the control doesn't resemble the interfaces of other MFC controls, since it's intended to be special purpose control for changing properties only.

The documentation is sparse, because I do not have much time to write documentation. However, the included demo is hopefully a help in understanding how to use the features of the control.

Features

The control supports many build-in property types (although adding your own propery-types should be no problem) :

  • bool
  • short
  • int
  • float
  • double
  • CString
  • CStringList
  • COLORREF
  • COleDateTime

Usage

To use this control in your own application, add CObjectInspector.cpp, CColorButton.cpp and CColourPopup.cpp to your project file. Open the resource editor and place a custom control on your dialog. In the control's properties enter "ObjectInspectorCtrl" as window-classname. Add a CObjectInspector variable to your dialog class :

CObjectInspector m_OI;

Add a DDX_Control handler to your DoDataExchange function :

void CMyDlg::DoDataExchange(CDataExchange* pDX)
{
	CDialog::DoDataExchange(pDX);
	//{{AFX_DATA_MAP(CMyDlg)
	DDX_Control(pDX, IDC_OI, m_OI);
	//}}AFX_DATA_MAP
}

Override OnInitDialog to customize the Object-Inspector and to add groups and properties :

BOOL CMyDialog::OnInitDialog()
{
	CDialog::OnInitDialog();

	CObjectInspector::CProperty *pGroup;
	
	// Create new property group
	m_OI.AddProperty (pProp = new CObjectInspector::CProperty("Group"));

	// Add properties to the group
	pProp->AddProperty (new CObjectInspector::CProperty("Integer-Value", &m_nIntValue));
	pProp->AddProperty (new CObjectInspector::CProperty("Bool Value", &m_bBoolVal));
}

Override OnNotify to receive notification messages from the control :

BOOL CMyDialog::OnNotify(WPARAM wParam, LPARAM lParam, LRESULT* pResult) 
{
    if (wParam == IDC_OI)
    {

       CObjectInspector::NM_OIVIEW *nmHdr = (CObjectInspector::NM_OIVIEW*) lParam;

       // OIVN_ITEMCHANGED is sent after the user has changed a property
       if (nmHdr->hdr.code == OIVN_ITEMCHANGED)
       {
           // Do some stuff (use nmHdr->pProperty to access the altered property)
       }

       // OIVN_ITEMCHANGING is sent when the user is currently editing a property
       if (nmHdr->hdr.code == OIVN_ITEMCHANGING)
       {
           // Do some stuff (use nmHdr->pProperty to access the currently edited property)
       }
    }
	
    return CDialog::OnNotify(wParam, lParam, pResult);
}

Known issues

Navigation with the cursor keys is quite unsatisfactorily.

Acknowledgments

  • Chris Maunder for his color picker
  • Keith Rule for his Memory DC class

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
Web Developer
Germany Germany
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralChange This to Fix Check Button Pin
Christopher Stratmann19-Apr-06 3:39
Christopher Stratmann19-Apr-06 3:39 

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.