Microsoft KB Archive/161536

Knowledge Base

XL97: How to Temporarily Hide a UserForm

Article ID: 161536

Article Last Modified on 11/23/2006

---

APPLIES TO

• Microsoft Excel 97 Standard Edition

---

This article was previously published under Q161536

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 redisplay 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 a Microsoft Certified Partner or the Microsoft fee-based consulting line at (800) 936-5200. For more information about Microsoft Certified Partners, please visit the following Microsoft Web site:

https://partner.microsoft.com/global/30000104

For more information about the support options that are available and about how to contact Microsoft, visit the following Microsoft Web site:

http://support.microsoft.com/default.aspx?scid=fh;EN-US;CNTACTMS

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
                           

6. Add another CommandButton control to the UserForm.

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

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

8. Add a TextBox control to the UserForm.

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.
   
   The UserForm reappears, and the text in the TextBox is retained.
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:

141506 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:

120802 Office: How to Add/Remove a Single Office Program or Component

Additional query words: XL97

Keywords: kbdtacode kbprogramming KB161536

---

Send feedback to Microsoft

© Microsoft Corporation. All rights reserved.