UNLOAD |
Décharger |
|---|---|
| Visual Basic | |
Syntaxe
| Unload object |
Paramètres
| Nom | Description |
|---|---|
| object | Ce paramètre permet d'indiquer l'espace réservé d'objet est le nom d'un objet Form ou d'un élément de tableau de contrôle à décharger. |
Description
Cette commande permet de décharger un formulaire ou un contrôle de la mémoire.
Remarques
- Le déchargement d'un formulaire ou d'un contrôle peut être nécessaire ou opportun dans certains cas où la mémoire utilisée est nécessaire pour autre chose ou lorsque vous devez réinitialiser les propriétés à leurs valeurs d'origine.
- Avant le déchargement d'un formulaire, la procédure événementielle Query_Unload se produit, suivie de la procédure événementielle Form_Unload. La définition du paramètre cancel sur True dans l'un de ces événements empêche le déchargement du formulaire. Pour les objets MDIForm, la procédure événementielle Query_Unload de l'objet MDIForm se produit, suivie de la procédure événementielle Query_Unload et de la procédure événementielle Form_Unload pour chaque formulaire enfant MDI, et enfin de la procédure événementielle Form_Unload de l'objet MDIForm.
- Lorsqu'un formulaire est déchargé, tous les contrôles placés sur le formulaire au moment de l'exécution ne sont plus accessibles. Les contrôles placés sur le formulaire au moment de la conception restent intacts; cependant, toutes les modifications au moment de l'exécution de ces contrôles et de leurs propriétés sont perdues lorsque le formulaire est rechargé. Toutes les modifications apportées aux propriétés du formulaire sont également perdues.
- Lorsqu'un formulaire est déchargé, seul la composante affiché est déchargé. Le code associé au module de formulaire reste en mémoire.
- Seuls les éléments de tableau de contrôle ajoutés à un formulaire au moment de l'exécution peuvent être déchargés avec l'instruction Unload. Les propriétés des contrôles déchargés sont réinitialisées lorsque les contrôles sont rechargés.
Exemple
L'exemple suivant utilise l'instruction Unload pour décharger l'objet Form. Pour essayer cet exemple, collez le code dans les sections Déclarations d'un objet Form, puis exécutez l'exemple et cliquez sur l'objet Form :
- Private Sub Form_Click()
- Dim Answer
- Unload Form1
- Answer = MsgBox("Form1 a été déchargé. Choisissez Oui pour charger et afficher le formulaire. Choisissez Non pour charger le formulaire et le laisser invisible.", 4)
- If Answer = 6 Then
- Show
- Else
- Load Form1
- MsgBox "Form1 est maintenant chargé. Choisissez OK pour l'afficher."
- Show
- End If
- End Sub
Dernière mise à jour : Mardi, le 29 Décembre 2020