PRB: Closing SDI (Top-Level) Form Does Not Release Menu

Last reviewed: January 10, 1997
Article ID: Q156089

The information in this article applies to:

Microsoft Visual FoxPro for Windows, version 5.0

SYMPTOMS

If a Top-Level, or single document interface (SDI), form uses a menu, this menu is not automatically released when the form is released.

WORKAROUND

In order for a menu to be released, you must issue the RELEASE MENUS command. If you want the menu to be released when the form is closed, issue the command as follows in the Destroy method of the form:

   RELEASE MENUS <menuname> EXTENDED

STATUS

This behavior is by design.

MORE INFORMATION

With Visual FoxPro 5.0 you can create forms that appear outside of (or in lieu of) the FoxPro desktop and that appear in the task list or on the task bar. These forms are called Top-Level, or SDI, forms and require setting the form's ShowWindow property to "2 - As Top-Level Form." You can add menus, toolbars, and child forms to these forms the same way you add them to the Visual FoxPro desktop in this and previous versions of Visual FoxPro.

There is a sample SDI form in the Solution sample application that displays these new capabilities.

Access the Solution sample by clicking Sample Applications from the Help menu in the Visual FoxPro 5.0. This brings up the Sample Applications Overview help topic. Start the Solution sample by clicking Run, which is to the right of Solutions Sample under Access.

You can access the SDI form example within the Solution application by clicking Forms to expand the folder tree in the Visual FoxPro Solutions dialog box. Then click "Create an SDI form" and the Run Sample button to run the form. Alternately, you can click the See Code button to display the form in the Form Designer.

You must explicitly release the menu so you can reuse the menu if desired.

Steps to Reproduce Behavior

Create a form called Test.
Set its ShowWindow property to "2 - As Top-Level Form" in the Form Designer.
In the Init method of the form, add the following code:
```
      DO TESTMENU.MPR with THIS, .T.
```
Create a new menu. Click the Menu button, rather than the Shortcut button.
On the Menu menu, click Quick Menu to create a default quick menu.
On the View menu, click General Options. In the General Options dialog box, select the Top-Level Form check box, then click OK.
On the Menu menu, click Generate and Save the menu as Testmenu. Click the Generate button to generate the default .mpr file.
Run the Test form. Notice that the menu appears in the form itself.
Close the form. Issue a DISPLAY MEMORY command, and notice that the menu definition remains in memory.

You can place the following code in the form's Destroy method, which causes the menu to be released when the form is closed:

   RELEASE MENUS (This.Name) EXTENDED

NOTE: This technique is explained in more detail in the header of any .mpr file created when you generate a Top-Level menu.

KBCategory: kbtool kbui kbprb
KBSubcategory: FxtoolFormdes FxtoolMbuilder
Additional reference words: 5.00 kbdse VFoxWin

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: January 10, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.