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

CGroupCheck - Checkbox associated with a groupbox

, 16 Aug 2002
Rate this:
Please Sign up or sign in to vote.
CButton-derived control associated with a groupbox to enable/disable controls inside

Sample Image - GroupCheck.gif

Introduction

I've seen and tried several similar controls available in CodeProject and CodeGuru site. None of them meets my requirement. Some of them are too complicated and some others miss functions I need.

CGroupCheck is a simple class derived from CButton. A groupbox can be associated with this button (actually a checkbox). It has the following features:

  1. The checkbox is moved to the top left corner of the groupbox and resized properly.
  2. All controls within the groupbox are enabled when checkbox is checked, and disabled when checkbox is unchecked.
  3. You can optionally hide the controls inside the groupbox when unchecked.

How to use it

Using the CGroupCheck class is quite straightforward, as illustrated in the demo project.

  • Create your controls on the dialog template as usual. For this control to work, you need a checkbox, and a groupbox. Inside the groupbox you can put any control. It doesn't matter where the checkbox is. Also the tab order of the checkbox is unimportant. The groupbox can have a caption, but it will be removed at run-time.
  • Create a data member of CGroupCheck in your dialog class. You can map this member to the checkbox control using DDX, or subclass the checkbox in OnInitDialog messege handler.
  • Associate the groupbox with the checkbox by calling its SetGroupbox function.

How does it work

CGroupCheck captures checkbox's click event and SetCheck function to enable or disable controls inside the associated groupbox. At its core is the function CheckGroupboxControls.

// Enable or disable controls inside the groupbox based 
// on the checkbox state. If checkbox is unchecked and 
// m_bHideDisabled is set TRUE, the groupbox and all
// controls inside are hidden. For a tri-state checkbox in 
// immediate state, all controls inside are just disabled.
void CGroupCheck::CheckGroupboxControls()
{
    ASSERT(m_pGroupbox);

    int nCheck = GetCheck();
    CRect rcGroupbox;
    m_pGroupbox->GetWindowRect(rcGroupbox);

    // Get first child control
    CWnd* pWnd = GetParent()->GetWindow(GW_CHILD);

    CRect rcWnd, rcTest;

    while (pWnd)
    {
        pWnd->GetWindowRect(rcWnd);

        if (rcTest.IntersectRect(rcGroupbox, rcWnd) && 
            pWnd != this && pWnd != m_pGroupbox)
        {
            pWnd->EnableWindow(nCheck == 1);
            if (m_bHideDisabled)
                pWnd->ShowWindow(nCheck ? SW_SHOW : SW_HIDE);
        }
        pWnd = pWnd->GetWindow(GW_HWNDNEXT);
    }
    if (m_bHideDisabled)
        m_pGroupbox->ShowWindow(nCheck ? SW_SHOW : SW_HIDE);
}

When the checkbox is moved to the top of the groupbox, one problem is that the checkbox window is normally longer than the caption. That would make the underneath groupbox border invisible. Adjusting the checkbox's size to fit the caption length is tedious. Also, sometimes, when checkbox is moved on top of the groupbox, it's actually hiding behind the groupbox (it looks once I got this problem, changing the tab order doesn't help). All these problems are now taken care for you, when you associate the groupbox by calling SetGroupbox:

// Sets groupbox by Resource ID
void CGroupCheck::SetGroupbox(
    UINT nGroupboxID, BOOL bHideDisabled /*= FALSE*/)
{
    SetGroupbox((CButton*)GetParent()->GetDlgItem(
        nGroupboxID), bHideDisabled);
}

// Sets groupbox by a pointer to that
void CGroupCheck::SetGroupbox(
    CButton* pGroupbox, BOOL bHideDisabled /*= FALSE*/)
{
    m_bHideDisabled = bHideDisabled;
    m_pGroupbox = pGroupbox;

    // Clear the groupbox text
    pGroupbox->SetWindowText(_T(""));    

    // Sometimes the window size of the checkbox is much 
    // bigger than the text, let's trim it.
    CString strText;
    GetWindowText(strText);
    // Figure out how long the text really is
    CClientDC dc(this);
    CFont* pOldFont = dc.SelectObject(GetFont());
    CSize czText = dc.GetTextExtent(strText);
    dc.SelectObject(pOldFont);
    // Add some space for the checkbox and at the end
    czText.cx += 25;

    // Move the checkbox on top of the groupbox
    CRect rc;
    pGroupbox->GetWindowRect(rc);    
    GetParent()->ScreenToClient(rc);
    SetWindowPos(pGroupbox, rc.left+10, 
        rc.top, czText.cx, czText.cy, 0);

    // Check controls within the groupbox based 
    // on the check state
    CheckGroupboxControls();
}

Postlude

How to associate one checkbox with multiple groupboxes?

You can create an invisible groupbox which includes these multiple groupboxes and associate the invisible groupbox with the checkbox. In this case, my code doesn't work well if the flag m_bHideDisabled is set to true - it will make the invisible groupbox visible when checked. I didn't fix it because it would require another data member to remember its original state, and in particular, I don't need it at all. Of course, another limitation is that these groupboxes must be located together to fit within that big groupbox. If you really look for such features, you may try Pavel Sokolov's Enable/Disable a group of controls with one click, or Paul S. Vickery's GroupControl.

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

Share

About the Author

Ming Liu
Web Developer
Germany Germany
to be created...

Comments and Discussions

 
QuestionThanks PinmemberMember 81095601-Dec-11 22:25 
Generalcheckbox hiding behind the groupbox PinmemberAbdul Rauf Abbasi26-Feb-09 4:34 
QuestionHow can i do same thing in c# or VB .Net PinmemberMichaelNu3-Jun-07 1:00 
GeneralVery good PinmemberNorbertbetko26-Jul-06 23:49 
GeneralA small problem PinmemberHuang, Xiong14-May-05 6:52 
GeneralVery handy. Thank you! Pinmembernedelman16-Jul-03 11:56 
QuestionHow to create a check box of bigger size? PinmemberDhirendra1-May-03 3:52 
AnswerRe: How to create a check box of bigger size? PinmemberMing Liu13-Aug-04 8:30 
GeneralRe: How to create a check box of bigger size? Pinmemberystein17-Jan-07 6:31 
Generalrepainting PinsussAnonymous17-Sep-02 19:45 
GeneralRe: repainting PinmemberMing Liu19-Sep-02 14:30 
GeneralNice PinsussJohnston28-Aug-02 9:46 
Generaldestructor! Pinmembera97alika18-Aug-02 10:20 
GeneralRe: destructor! PinmemberMing Liu19-Aug-02 3:50 

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
Web02 | 2.8.141022.2 | Last Updated 17 Aug 2002
Article Copyright 2002 by Ming Liu
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid