Skip to main content

Unload statement

Table of contents
  1. Syntax
  2. Remarks
  3. Example

Removes an object from memory.


Unload object

The required object placeholder represents an object expression that evaluates to an object in the Applies To list.


When an object is unloaded, it's removed from memory and all memory associated with the object is reclaimed. Until it is placed in memory again by using the Load statement, a user can't interact with an object, and the object can't be manipulated programmatically.


The following example assumes two UserForms in a program. In UserForm1's Initialize event, UserForm2 is loaded and shown. When the user clicks UserForm2, it is unloaded and UserForm1 appears. When UserForm1 is clicked, it is unloaded in turn.

' This is the Initialize event procedure for UserForm1
Private Sub UserForm_Initialize()
    Load UserForm2
End Sub
' This is the Click event for UserForm2
Private Sub UserForm_Click()
    Unload UserForm2
End Sub
' This is the Click event for UserForm1
Private Sub UserForm_Click()
    Unload UserForm1
End Sub

Leave a comment

Your email address will not be published. Required fields are marked *

Format your code: <pre><code class="language-vba">place your code here</code></pre>