Dialog Editor Improvements in Visual Studio 2010

Hello, my name is Daofa Li, and I am on the Visual C++ QA team. In this post I will be sharing with you the improvements in Dialog Editor for Visual Studio 2010.

In Visual Studio 2010, we have improved Dialog Editor in the following features:

·         Add mockup image support to help layout controls in dialogs

·         Add support to use the new MFC controls in design time

·         Enhance the ActiveX control security in Dialog Editor

Using mockup image in Dialog Editor

A mockup image is an image that specifies the exact layout of a dialog – including the information of the exact size and position of controls in the dialog. A mockup image usually comes from the artist/designer. The developer has to make the dialog look identical with the image.  This could be a tedious process that might take many hours of fine tuning and checking until the results are satisfactory.

The good news is now the developer can use this mockup image to guide designing the dialog. In Visual Studio 2010, Dialog Editor has a semitransparent layer that shows the image in the background and that provides the exact guide on how to layout the controls. To make the dialog look identical with the mockup image, the only thing the developer has to do is to drag and drop controls to the position indicated in the image.

In the following scenario, I got the mockup image from my designer, and I will use this mockup image to guide me in designing the dialog.

I create the new dialog resource in Dialog Editor. At the bottom of the Dialog Editor window, there is a mockup bar that controls how the mockup image shows up. The Mockup bar can be toggled on or off in the “Guide Settings” dialog by checking or clearing the “Mockup bar” checkbox.

To use the mockup image, I first check the “Mockup Image” checkbox in the Mockup bar. This action will enable the rest of the controls in the Mockup bar. Then I click the browsing button (…) at the right end of the bar to open the “File Open“ dialog and select the mockup image file I am going to use for designing the dialog. The image file name is displayed in the Mockup bar and the mockup image immediately shows up as a semitransparent image overlaying the client area of the dialog form. I can drag the “Transparency” slider to adjust the transparency level of the mockup image so that it has a comfortable visual effect. By default the mockup image anchors to the upper-left corner of the client area of the dialog form. I can adjust its anchor position by changing the X and/or Y coordination offset values in the Mockup bar.

Once I complete my design, I can clear the “Mockup Image” checkbox not to show the image. Note that clearing this checkbox doesn’t remove the mockup image. Once you check it again, the mockup image shows up with its previous settings – transparency level and position.

The mockup image information is persisted in the .rc file. In the GUIDELINES section, each dialog resource that has associated mockup image will have a MOCKUP entry that specifies the mockup image information:



        MOCKUP, 1, 81, 0, 0, “.\res\mockup.jpg”

        LEFTMARGIN, 7

        RIGHTMARGIN, 267

        TOPMARGIN, 7

        BOTTOMMARGIN, 170



The information starts with “MOCKUP” indicating a mockup image guide is using in this dialog, followed by the status of the “Mockup Image” checkbox, the transparency level, the offsets of the image position and the mockup image file.

The mockup image effects only at design time, it will not be saved as part of the dialog resource thus has no effect at runtime.

Using new MFC Controls in dialogs

Starting Visual Studio 2008 SP1, new MFC controls were introduced, however these new controls could only be used in source code and visual effect could not be seen at design time. In Visual Studio 2010, the most commonly used “new” MFC controls were integrated into the Toolbox and can be drag and drop to Dialog Editor at design time. Below is a screenshot that shows the “new” MFC controls in the Toolbox. The “new” MFC controls start with “MFC” in their names.

I know this may sound obvious to many but I would like to mention that these MFC controls require MFC support. They may not show up correctly in the dialog at runtime if they are used in non-MFC applications.

Handling ActiveX controls in dialogs

In Visual Studio 2010, you may have slightly different experience in using ActiveX controls in Dialog Editor than previous versions. When you open a dialog resource that contains ActiveX control(s), you’ll get the following message box before the dialog resource is opened in Dialog Editor:


If you are not sure of the resource of the ActiveX controls you are using, you could choose “No” and the dialog resource will not be opened in Dialog Editor. If you trust the ActiveX controls, you can choose “Yes” and the dialog resource will be opened for you. This is a one-time “Yes” answer per session. Next time, before you unload the resource file, when you open a dialog resource containing ActiveX controls you will not get this message box if you already answered “yes”.

Another different experience you may have is you may get the following message box before the dialog runs in test mode, when you test a dialog containing ActiveX controls by pressing CTRL-T or clicking the “Test Dialog” toolbar button:

If you don’t trust the ActiveX controls or you want to save your work before running the dialog in test mode, choose “No” to stop entering the test mode. If you want to proceed testing the dialog, click “Yes” and Dialog Editor will try to run the dialog in test mode – if everything runs well, you will not get this message box next time when you run the dialog in test mode again.

I recommend you to save your work before running a dialog containing ActiveX controls in test mode because you might lose your work if any of the ActiveX controls does something wrong and crashes the Visual Studio.

There are several reasons why we need these security enhancements in handling ActiveX controls in Dialog Editor:

·         ActiveX controls usually come from third party. Dialog Editor doesn’t have the knowledge about whether they are safe or not, and cannot make the decision for the developer whether it is safe to use these controls.

·         When Dialog Editor opens a dialog resource containing ActiveX controls, these controls are initialized using the data persisted in the .rc file. The data could be unsafe and the ActiveX controls could be harmful to the system.

·         When the dialog runs in test mode, the contained ActiveX controls are running in the system as well. If any of the controls is unsafe, it could be harmful to the system.  If anything unexpected happens within the ActiveX controls, it might crash the Visual Studio and you could lose your data because Dialog Editor cannot control the ActiveX control’s running behavior.