Click here to Skip to main content
15,869,940 members
Articles / Programming Languages / C++/CLI
Article

Using WinForms controls in an MFC dialog

Rate me:
Please Sign up or sign in to vote.
4.88/5 (31 votes)
20 Dec 2005CPOL2 min read 293.6K   4.3K   77   62
This article is a simple introduction to using the CWinFormsControl MFC class to put a Windows Forms control on an MFC dialog.

Image 1

Introduction

A few days ago, someone asked on the Code Project VC++ forum whether he can use the Dundas WinForms controls on his MFC dialogs. The answer is - yes, that's entirely possible, and pretty easy to do with VC++ 2005.

This article is a simple introduction to using the CWinFormsControl MFC class to put a Windows Forms control on an MFC dialog. The article demonstrates this using a small dialog based application that has a .NET MaskedTextBox control placed on it. The MaskInputRejected event is handled through a function declared in the MFC dialog class.

Steps to put the .NET control in the MFC dialog

  1. Create a fresh MFC dialog based application using VC++ 2005. And turn on /clr compilation.

  2. Add the following header file include to your stdafx.h

    MC++
    #include <afxwinforms.h>
  3. Modify your dialog resource so it has the controls shown in the screenshot above, with one change. Where you see the MaskedTextBox control in the screenshot, put a static control. You should end up with the following controls.

    IDC_MASKED_EDIT1We'll map this to the MaskedTextBox control
    IDC_EDITMASKCEdit m_Mask
    IDC_BUTTONMASKON_BN_CLICKED -> OnBnSetMask
    IDC_EDIT_STATUSCEdit m_StatusEdit (DDX)
    IDC_STATIC"Set Mask"
    IDC_STATIC"Enter Text"
    Table 1 : The controls that you need to add to the dialog resource
  4. Add the CWinFormsControl variable to your dialog header file :

    MC++
    CWinFormsControl<System::Windows::Forms::MaskedTextBox> m_MaskedEdit;

    The CWinFormsControl class provides the functionality to host a .NET control in an MFC application.

  5. In your dialog class's DoDataExchange, add a call to DDX_ManagedControl :

    MC++
    void CDialogFormsDlg::DoDataExchange(CDataExchange* pDX)
    {
        CDialog::DoDataExchange(pDX);
        DDX_ManagedControl(pDX, IDC_MASKED_EDIT1, m_MaskedEdit);
    . . .
    }

    This creates the .NET control and associates it with that resource ID.

  6. Add the event handler declaration your header file.

    MC++
    void OnMaskInputRejected(System::Object^, 
        System::Windows::Forms::MaskInputRejectedEventArgs^);
  7. Setup the delegate map in a public section of your dialog class declaration.

    MC++
    BEGIN_DELEGATE_MAP( CDialogFormsDlg )
        EVENT_DELEGATE_ENTRY( OnMaskInputRejected, System::Object^, 
            System::Windows::Forms::MaskInputRejectedEventArgs^ )
    END_DELEGATE_MAP()

    The delegate map allows us to use an MFC class function as a delegate by calling MAKE_DELEGATE on it.

  8. Setup the OnBnSetMask function.

    MC++
    void CDialogFormsDlg::OnBnSetMask()
    {
       CString strMask; 
       m_Mask.GetWindowText(strMask);
       m_MaskedEdit->Clear();
       m_MaskedEdit->Mask = gcnew System::String(strMask);
    }
  9. Setup the MaskedTextBox control in OnInitDialog.

    MC++
    m_MaskedEdit->PromptChar = L' ';
    m_Mask.SetWindowText(L"00/00/0000");
    OnBnSetMask();
    m_MaskedEdit->MaskInputRejected +=
        MAKE_DELEGATE( System::Windows::Forms::MaskInputRejectedEventHandler, 
        OnMaskInputRejected);
  10. Add the OnMaskInputRejected function to the dialog class.

    MC++
    void CDialogFormsDlg::OnMaskInputRejected(System::Object^, 
        System::Windows::Forms::MaskInputRejectedEventArgs^ args)
    {
      if(m_MaskedEdit->MaskFull)
      {
        m_StatusEdit.SetWindowText(L"You've hit the max length of the mask.");
      }
      else if(args->Position == m_MaskedEdit->Mask->Length)
      {
        m_StatusEdit.SetWindowText(L"You are at the end of the mask.");
      }
      else
      {
        m_StatusEdit.SetWindowText(L"Bad entry. Check your input!");
      }  
    }
  11. That's it. We are all done. Build and run the application. What you see is an MFC dialog that contains a WinForms control.

Conclusion

This should help you reuse your existing MFC applications and at the same time use new hyper looking .NET UI controls that are released in the market. Please use the article forum to provide feedback about the article or to post any questions you may have.

History

  • Dec 20, 2005 - First published.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
United States United States
Nish Nishant is a technology enthusiast from Columbus, Ohio. He has over 20 years of software industry experience in various roles including Chief Technology Officer, Senior Solution Architect, Lead Software Architect, Principal Software Engineer, and Engineering/Architecture Team Leader. Nish is a 14-time recipient of the Microsoft Visual C++ MVP Award.

Nish authored C++/CLI in Action for Manning Publications in 2005, and co-authored Extending MFC Applications with the .NET Framework for Addison Wesley in 2003. In addition, he has over 140 published technology articles on CodeProject.com and another 250+ blog articles on his WordPress blog. Nish is experienced in technology leadership, solution architecture, software architecture, cloud development (AWS and Azure), REST services, software engineering best practices, CI/CD, mentoring, and directing all stages of software development.

Nish's Technology Blog : voidnish.wordpress.com

Comments and Discussions

 
Generalcool ... Pin
Maximilien20-Dec-05 8:20
Maximilien20-Dec-05 8:20 
GeneralRe: cool ... Pin
Nish Nishant20-Dec-05 8:33
sitebuilderNish Nishant20-Dec-05 8:33 
Questionwhy ? Pin
toxcct20-Dec-05 7:19
toxcct20-Dec-05 7:19 
AnswerRe: why ? Pin
Nish Nishant20-Dec-05 7:25
sitebuilderNish Nishant20-Dec-05 7:25 
GeneralRe: why ? Pin
toxcct20-Dec-05 7:36
toxcct20-Dec-05 7:36 
GeneralRe: why ? Pin
Nish Nishant20-Dec-05 7:44
sitebuilderNish Nishant20-Dec-05 7:44 
GeneralRe: why ? Pin
Aamir Butt22-Dec-05 23:40
Aamir Butt22-Dec-05 23:40 
GeneralRe: why ? Pin
Nish Nishant23-Dec-05 1:11
sitebuilderNish Nishant23-Dec-05 1:11 
AnswerRe: why ? Pin
Steve Maier20-Dec-05 7:45
professionalSteve Maier20-Dec-05 7:45 
GeneralRe: why ? Pin
Nish Nishant21-Dec-05 0:56
sitebuilderNish Nishant21-Dec-05 0:56 

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.