How to provide your own Window class name for an MFC dialog box

Article translations Article translations
Article ID: 251059 - View products that this article applies to.
This article was previously published under Q251059
Note Microsoft Visual C++ .NET 2002 and Microsoft Visual C++ .NET 2003 support both the managed code model that is provided by the Microsoft .NET Framework and the unmanaged native Microsoft Windows code model. The information in this article applies only to unmanaged Visual C++ code. Microsoft Visual C++ 2005 supports both the managed code model that is provided by the Microsoft .NET Framework and the unmanaged native Microsoft Windows code model.
Expand all | Collapse all

SUMMARY

This article shows you how to provide your own Window Class Name for a dialog box that is created in an MFC-based application.

You may encounter this need when you try to limit your dialog-based MFC application to a single instance.

MORE INFORMATION

To provide your own Window Class Name, follow these steps:
  1. Open your project work space that contains the dialog box, and then click ResourceView.
  2. Open the dialog box in Resource Editor. Right-click the dialog box, and then select Properties. Notice an entry for Class Name at the bottom right. This edit box appears disabled if you are using a resource file with Microsoft Foundation Class Library support. To enable this option, switch to the top-level node on the resource view, and then right-click and select Properties. Clear the Enable MFC Features check box. Or for Visual C++ .NET, clear the MFC Mode property to FALSE. Now display the properties for your dialog box. The Class Name edit box should be enabled. Type the class name; for instance MyPrivateClassName.
  3. Alternatively, open the .rc file as a text file. Go to the desired DIALOG resource and add the CLASS option.

    IDD_LIMITDLGINSTANCE_DIALOG DIALOGEX 0, 0, 195, 44
    STYLE DS_MODALFRAME | WS_POPUP | WS_VISIBLE | WS_CAPTION | WS_SYSMENU
    EXSTYLE WS_EX_APPWINDOW
    CAPTION "LimitDlgInstance"
    CLASS "MyPrivateClassName" // Add your class name here!
    FONT 8, "MS Sans Serif"
    BEGIN
        DEFPUSHBUTTON   "OK",IDOK,138,7,50,14
        PUSHBUTTON      "Cancel",IDCANCEL,138,23,50,14
        PUSHBUTTON      "&Test!",IDC_BUTTON1,48,14,49,15
    END
    						
  4. Add the following code in the InitInstance() function of the CWinApp-derived class.

    BOOL CLimitDlgInstanceApp::InitInstance()
    {
    	///////////////////////////////////////////////////////////////////////// 
    	///////////////////////////////////////////////////////////////////////// 
    	WNDCLASS wc;
    
    	// Get the info for this class.
             // #32770 is the default class name for dialogs boxes.
    	::GetClassInfo(AfxGetInstanceHandle(), "#32770", &wc);
    
    	// Change the name of the class.
    	wc.lpszClassName = "MyPrivateClassName";
    
    	// Register this class so that MFC can use it.
    	AfxRegisterClass(&wc);	
    	///////////////////////////////////////////////////////////////////////// 
    	///////////////////////////////////////////////////////////////////////// 
    
    // ...
    }
    						
  5. In the step above, in the call to ::GetClassInfo(), make sure to use the correct HINSTANCE call if your dialog resource is located in a separate DLL.
  6. Build and run your application. Use the Spy++ tool to verify that the dialog now uses the new class name.

REFERENCES

238100 Limiting 32-bit MFC SDI applications to a single instance in WinCE

Properties

Article ID: 251059 - Last Review: November 21, 2006 - Revision: 5.1
APPLIES TO
  • Microsoft Foundation Class Library 4.2, when used with:
    • Microsoft Visual C++ 5.0 Enterprise Edition
    • Microsoft Visual C++ 6.0 Enterprise Edition
    • Microsoft Visual C++ 5.0 Professional Edition
    • Microsoft Visual C++ 6.0 Professional Edition
    • Microsoft Visual C++, 32-bit Learning Edition 6.0
    • Microsoft Visual C++ .NET 2003 Standard Edition
    • Microsoft Visual C++ .NET 2002 Standard Edition
    • Microsoft Visual C++ 2005 Express Edition
Keywords: 
kbhowto kbwndwclass kbarchitecture kbresource kbdlg kbfaq KB251059

Give Feedback

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com