Why can't I create my dialog with DialogBox, DialogBoxParam, CreateDialog, CreateDialogParam, or the indirect versions of same?

Raymond Chen

November 29th, 20130 0

One of the purposes of mydialog manager serieswas to help people diagnose problems with their dialog boxes.But since I embedded the tips inside the series body,it’s hard for people to find them,and I still end up answering the same questions over and over.

So here it is in a separate article that hopefully people can find.

Why your call to Dialog­Box orCreate­Dialog is failing.This also goes for CDialog::Do­Modal,but perhaps extra so because the MFC source code says

* 3) CreateDialogIndirect() did NOT create the window (ie. due to error in template)
*    and returns NULL.

even though the problem is rarely due to an error in the template.A wrong comment is worse than no comment at all.¹

I’ve decided to put the reasons in most-likely-error-first orderrather than chronological.

  • Your dialog template uses a custom control which has notbeen registered.

This is by far the number one reason why dialog boxes failto be created.As we saw inPart 3,if a child control cannot be created from the template,then the dialog creation fails.(There is a special dialog box styleDS_NO­FAIL­CREATE that tells the dialog managerto ignore the error and just continue without the child control.)

For example, maybe your dialog box template uses a List Viewcontrol, but you forgot to callInit­Common­Controls orInit­Common­Controls­Ex.Or it uses a Rich Edit control and you forgot toloadthe appropriate library.Or it contains an ActiveX control but you forgot tocallAfx­Enable­Control­Containerto enable ActiveX control hosting.

A special case of this error is where yourdialog template uses a custom control which wasregistered in a different activation context.If you are trying to use a control from version 6of the common controls, then you mustuse the appropriate manifestand make sure that the manifest’s activation context is active at the timeyou call Dialog­Box or whatever.If you forget to do this, then you will be using whatever activationcontext happens to be lying around at the time you callDialog­Box,and it may not be the one you want.(It’s like walking up to a computer and looking on the Desktopand not seeing the file you created yesterday.“Hey, who deleted my file!”But you forgot to do a Switch User to your own account.You’re looking at the Desktop of whoever used the computer last.You’re in the wrong context.)

  • Your resource name is incorrectly declared in the resource template.

One of the annoying features of the Resource Compiler is that ithappily accepts typos!For example, suppose you have the following resource header file:

// ids.h
#define IDD_BRILLIANT 100

and the following resource file:

IDD_BRILLANT DIALOG ...

Since you misspelled IDD_BRILLIANT,you are not in fact creating a dialog box whose ID is 100(which is what would have happened if you had spelled it correctly).Instead, you’re creating a dialog whose name is the string"IDD_BRILLANT".

Later, your code passesMAKE­INT­RESOURCE(IDD_BRILLIANT) to ask for dialog 100,and the dialog manager says, “Sorry, I don’t see one of those.”(To get the typo’d dialog template, you would have to passTEXT("IDD_BRILLANT") as the template name.)

Even if you spell everything correctly, you will also have this problemif you forget to#include "ids.h" in your resource template filein the first place!

To diagnose this error,you canadd a diagnostic call toFind­Resource(or simply trace through the dialog manager’s call to the same function)to see if it can find the resource.Many IDEs will let you load a DLL and inspect its resources interactively.You can check the dialog template to see whether it is listed as resource 100or as resource "IDD_BRILLANT".

  • You passed the wrong instance handle or dialog ID.

This is a generalization of the previous error.The dialog template needs to exist in the module you passed,with the ID or name you passed.If you pass the wrong module or the wrong name,then you’re not going to find it.

An even more generalized version of this error isthe case where you forgot to add the dialog to themodule’s resources in the first place.(Maybe you forgot to add the resource file to your project.)

The diagnosis for this case is the same as thecase of the misspelled dialog identifier.

  • The control refused its creation.

In rare cases, a control may fail its creationby returning FALSE in response tothe WM_NC­CREATE messageor -1 in response to theWM_CREATE message.

  • You passed a bad window handle as the hwnd­Parent.

An invalid parameter will naturally result in the function failing.This rarely occurs in practice because you should be using the handleof a window under your control, so it shouldn’t be destroyed outfrom under you.

  • There is an error in the dialog template.

I have never seen this occur.The Resource Compiler is pretty good aboutnot generating erroneous templates.

¹ Perhaps the author meant to usee.g. (exempli gratia,which means “for example”) instead ofi.e. (id est, which means“that is”). As written, the comment is sayingthat an error in the template is the only reasonthat Create­Dialog­Indirectcould have failed, when in fact it is only oneexample of a failure.Getting the two Latin abbreviations confused is notjust a pedantic error;here, it created genuine confusion and probablywasted a lot of developers’ time.

Raymond Chen