CheckFrame Control


Sometimes it can be handy to exclude a set of options based on the users choice. For instance if the user do not want to save a log file, then it should be signalled, to the user, which options are relevant.

fig.1 The checkframe control are disabled, and so is its the contained controls.

fig. 2 The check frame is enabled and the controls can be used.


The header file: CheckFrm.h

BOOL IsRectContainedInRect(CRect &rcChild, CRect &rcMother);

class CCheckFrame : public CObject
	virtual void Enable(BOOL bEnable);
	void Set(CWnd *pParentWnd,UINT nFrmCtl);
	CWnd* m_pFrame; 
	CWnd* m_pDialog;
	CRect m_rFrm;
	CDWordArray m_adwWndHandles;

The impementation file: CheckFrm.cpp
The code are futher commented in the source files.

#include "stdafx.h"
#include "Checkfrm.h"

// EnumChildWnds Callback
BOOL CALLBACK EnumChildWnds(HWND hwnd, CCheckFrame *pObj)
	CRect R;
	GetWindowRect(hwnd, &R);
	if (hwnd != pObj->m_pFrame->m_hWnd)
		if (IsRectContainedInRect(R, pObj->m_rFrm))
	return TRUE;

// Function name	: Set
void CCheckFrame::Set(CWnd *pParentWnd, UINT nFrmCtl)
	m_pDialog = pParentWnd;
	// Calculate the size of the rect that should contain the controls
	m_pFrame = m_pDialog->GetDlgItem(nFrmCtl);
	if (!m_pFrame)
		AfxMessageBox("Unable to find frame control");
	// Make sure the array is empty
	// The (control) windows contained within the boundaries of the frame control
	// are enumerated and their associated window-handles collected in an array.
	EnumChildWindows(m_pDialog->m_hWnd, (WNDENUMPROC)EnumChildWnds, (LONG)(CCheckFrame *)this);

// Function name	: CCheckFrame::Enable
void CCheckFrame::Enable(BOOL bEnable)
	for (int i=0 ; i<m_adwWndHandles.GetSize() ; i++)
		EnableWindow((HWND)m_adwWndHandles[i], bEnable);

// Function name	: IsRectContainedInRect
BOOL IsRectContainedInRect(CRect &rcChild, CRect &rcMother)
	if (rcMother.PtInRect(CPoint(rcChild.left, &&
	rcMother.PtInRect(CPoint(rcChild.left, rcChild.bottom)) &&
	rcMother.PtInRect(CPoint(rcChild.right, &&
	rcMother.PtInRect(CPoint(rcChild.right, rcChild.bottom)))
		return TRUE;
	return FALSE;

Known problems:
If the checkbox control it self is disabled when the progrma exits, try to move it some pixels away from the border of the frame control.

Download the sample project (31 kb)

Posted : March 12, 98


  • Very useful some suggestions

    Posted by Legacy on 06/23/2003 12:00am

    Originally posted by: Colin Undery

    Thanks for a useful piece of code, I've just put it in my project.
    The rectangle for the frame includes the original frame caption text, so I modified
    to avoid the check box disabling itself (depending how high up you put it).
    VC7 compiler generates warnings about truncating HWNDs into DWORDS, so I replaced
    CDWordArray m_adwWndHandles;
    and the (DWORD) typecasting can be removed.

    finally EnumChildWindows(...) seems happier with
    for the third parameter.

    Thanks again for a useful piece of code

  • A much easier way

    Posted by Legacy on 10/16/2002 12:00am

    Originally posted by: Yair Konfino

    1. using the resource editor , position your check box over
    the frame.
    2. set an id for the frame . something other then
    3. inside OnInitDialog() do the follwing :

    thats it ...


  • Excellent Piece of work

    Posted by Legacy on 05/27/2002 12:00am

    Originally posted by: Joe Sonderegger

    This is excellent piece of work.
    I have used it also for disabling a complete dialog (by making the frame invisible.

    Joe Sonderegger

Leave a Comment
  • Your email address will not be published. All fields are required.

Top White Papers and Webcasts

  • Power and Automation Equipment makers face constrained CAPEX, equipment interoperability issues, and process inefficiencies. However, they can take advantage of secure Internet of Things (IoT) intelligent devices and systems to make better business decisions around asset utilization and performance, while simultaneously optimizing equipment interoperability and services efficiency. Watch this brief video to see how you can unlock the full potential of your assets and value chain.

  • As the mobile enterprise marketplace expands and customer needs grow more diverse, Samsung recognizes that solution partners and developers play an essential role by continually innovating to meet their customers' needs. Samsung works to provide these developers and partners with the latest tools and resources needed to create these solutions. Read this program guide to learn how the Samsung Enterprise Alliance Program provides partners and developers with Samsung enterprise software development kits (SDKs) …

Most Popular Programming Stories

More for Developers

RSS Feeds

Thanks for your registration, follow us on our social networks to keep up-to-date