MODELESS is an MFC for Windows CE (MFC WCE) sample that demonstrates the use of an MFC WCE CDialog object as a modeless dialog. MODELESS is a very simple dialog-based application that manages a list box in its main dialog while providing a modeless dialog that allows you to add strings to the list box in the main window.
When the sample starts, it presents an empty list box. You can open the modeless dialog box by clicking Add. Even while the MODELESS Adder dialog box is open, you can bring focus back to the main dialog. The Add button on the main dialog is disabled when the modeless dialog box is open so that the user cannot create more than one instance of the modeless box.
The main dialog's CMainDlg class manages a pointer to the modeless dialog box. It does this just for convenience; once created, the modeless dialog box requires no further management.
The code for the Add button in the main dialog creates the modeless dialog box using the Create function, instead of calling DoModal. This is what makes the box modeless. When the box is destroyed, EndDialog is not used; instead, DestroyWindow is called. Since the normal OnOk and OnCancel member functions of a CDialog object would call EndDialog, you need to make sure your modeless dialog doesn't call those functions but instead overrides them to call DestroyWindow.
Usually, when you create a modal dialog box, you destroy it manually after DoModal returns. Since you can't wait for Create to return while displaying your modeless dialog box, you'll need to have some other mechanism for destroying the C++ object associated with the window. This sample uses a very simple mechanism: It performs delete this in the handler for OnPostNcDestroy, a function that is called after the client area of the box has been destroyed.
The MODELESS dialog communicates with its parent dialog in two different ways. First, when the user presses OK, the string in the edit control in the MODELESS dialog is added to the content of the list box in the modal dialog box. Second, when the user destroys the window by whatever means, the modeless box calls the BoxDone function in the modal window. This function simply resets the pointer to the modal dialog and re-enables the Add button.
This sample demonstrates the following keywords:
You can find the MODELESS project files in the Wce\Samples\Mfc\MODELESS directory.
To build the MODELESS sample, follow the procedure described in Building the Sample Applications, selecting one or more of the following project configurations.