XL97: How to Temporarily Hide a UserForm

ID: Q161536

The information in this article applies to:

• Microsoft Excel 97 for Windows

SUMMARY

In earlier versions of Microsoft Excel, if you use the Hide method to hide a custom dialog box, Microsoft Excel does not hide the dialog box until the macro that contains the Hide method is finished running.

In Microsoft Excel 97, if you use the Hide method to hide a UserForm, the UserForm is hidden immediately. You can redisplayed the UserForm later by using the Show method in the macro (or in another macro). You can also use the Unload statement to hide a UserForm; however, any settings in the UserForm are lost. Note that you may want to use the Unload statement if you want to reset the UserForm.

This article explains how to create a UserForm and contains a sample Visual Basic for Applications macro that temporarily hides the UserForm (using the Hide method and the Unload statement).

MORE INFORMATION

Microsoft provides programming examples for illustration only, without warranty either expressed or implied, including, but not limited to, the implied warranties of merchantability and/or fitness for a particular purpose. This article assumes that you are familiar with the programming language being demonstrated and the tools used to create and debug procedures. Microsoft support professionals can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific needs. If you have limited programming experience, you may want to contact the Microsoft fee-based consulting line at (800) 936-5200. For more information about the support options available from Microsoft, please see the following page on the World Wide Web:

   http://www.microsoft.com/support/supportnet/refguide/

Creating the UserForm

1. Save and close any open workbooks, and then create a new workbook.

2. Start the Visual Basic Editor (press ALT+F11).

3. On the Insert menu, click UserForm.

This step inserts UserForm1 into the project.

4. Add a CommandButton control to the UserForm.

5. Change the properties of the CommandButton to the following.

      Property   Value
      --------------------
      Caption    Hide Form
      Name       cmdHide

7. Change the properties of the CommandButton to the following.

      Property   Value
      ----------------------
      Caption    Unload Form
      Name       cmdUnload

Sample Macro for Hiding the UserForm

 1. Double-click the cmdHide CommandButton on UserForm1.

 2. Type the following code for the cmdHide Click event:

       Private Sub cmdHide_Click()
           UserForm1.Hide
       End Sub

 3. Type the following code for cmdUnload Click event:

       Private Sub cmdUnload_Click()
           Unload UserForm1
       End Sub

 4. On the Insert menu, click Module.

 5. Type the following code into this module:

       Sub Show_Form()

           UserForm1.Show   'Display the UserForm

           Do
               response = MsgBox("Do you want to redisplay the form?", _
                   vbYesNo)

               If response = vbYes Then

                   UserForm1.Show  'Redisplay the UserForm.

               End If

           Loop Until response = vbNo  'Do not redisplay the UserForm.

       End Sub

 6. Run the Show_Form macro.

 7. Type text in the TextBox control.

 8. Click Hide Form.

 9. When you are prompted whether to redisplay the UserForm, click Yes.

10. Click Unload Form.

11. When you are prompted whether to redisplay the UserForm, click Yes.

The UserForm reappears, but the text in the TextBox is NOT retained.

12. Click Unload Form.

13. When you are prompted whether to redisplay the UserForm, click No.

The UserForm is not redisplayed, and the macro ends.

For additional information about hiding dialog boxes in earlier versions of Microsoft Excel, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q141506
   TITLE     : XL: How to Temporarily Hide a Dialog Box

REFERENCES

For more information about Hiding UserForms, click the Office Assistant, type "hide", click Search, and then click to view "Hide Method".

For more information about Unloading UserForms, click the Office Assistant, type "unload", click Search, and then click to view "Unload Statement".

NOTE: If the Assistant is hidden, click the Office Assistant button on the Standard toolbar. If Microsoft Excel Help is not installed on your computer, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q120802
   TITLE     : Office: How to Add/Remove a Single Office
               Program or Component

Keywords          : kbprg kbdta kbdtacode KbVBA 
Version           : WINDOWS:97
Platform          : WINDOWS

Last Reviewed: May 18, 1999