GestureRecognizer.Dispose, méthode

Article
11/05/2008

Mise à jour : November 2007

Libère les ressources utilisées par l'objet GestureRecognizer.

Espace de noms : Microsoft.StylusInput
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Sub Dispose
'Utilisation
Dim instance As GestureRecognizer

instance.Dispose()

public void Dispose()

public:
virtual void Dispose() sealed

public final void Dispose()

public final function Dispose()

Implémentations

IDisposable.Dispose()

Notes

L'appel à la méthode Dispose autorise la réallocation à d'autres fins des ressources utilisées par l'objet. Pour plus d'informations sur le garbage collection, consultez Programmation du garbage collection (page pouvant être en anglais).

Attention :
Pour éviter toute fuite de mémoire, vous devez appeler explicitement cette méthode sur tout objet ou contrôle du Kit de développement logiciel (SDK) Windows XP Édition Tablet PC auquel un gestionnaire d'événements a été attaché avant que l'objet ou le contrôle ne se trouve hors de portée.

Pour toute classe du Kit de développement logiciel Tablet PC (SDK) sur laquelle la méthode Dispose est définie, supprimez manuellement chaque instance de cette classe lorsqu'elle n'est plus d'aucune utilité. La suppression de ces objets améliore les performances de votre application.

Exemples

Cet exemple C# est un extrait de code du gestionnaire d'événements Closed (page pouvant être en anglais) d'un formulaire, qui désactive les objets RealTimeStylus, GestureRecognizer et DynamicRenderer, vide les files d'attente des objets RealTimeStylus et appelle la méthode Dispose des objets.

using Microsoft.Ink;
using Microsoft.StylusInput;
using Microsoft.StylusInput.PluginData;

// ...

// Declare the RealTimeStylus objects, the GestureRecognizer plugin,
// and the DynamicRenderer plug-in.
private Microsoft.StylusInput.RealTimeStylus thePrimaryRealTimeStylus = null;
private Microsoft.StylusInput.RealTimeStylus theSecondaryRealTimeStylus = null;
private Microsoft.StylusInput.GestureRecognizer theGestureRecognizer = null;
private Microsoft.StylusInput.DynamicRenderer theDynamicRenderer = null;

// ...

// The form's Closed event handler.
private void theForm_Closed(object sender, System.EventArgs e)
{
    // Disable appropriate plug-ins.
    this.theGestureRecognizer.Enabled = false;
    this.theDynamicRenderer.Enabled = false;
    this.theFilterPlugin.Enabled = false;

    // Empty the RealTimeStylus queues
    this.thePrimaryRealTimeStylus.ClearStylusQueues();
    this.theSecondaryRealTimeStylus.ClearStylusQueues();

    // Disable the RealTimeStylus.
    this.thePrimaryRealTimeStylus.Enabled = false;

    // Dispose of the the RealTimeStylus objects and appropriate plug-ins.
    this.thePrimaryRealTimeStylus.Dispose();
    this.thePrimaryRealTimeStylus = null;
    this.theSecondaryRealTimeStylus.Dispose();
    this.theSecondaryRealTimeStylus = null;
    this.theDynamicRenderer.Dispose();
    this.theDynamicRenderer = null;
    this.theGestureRecognizer.Dispose();
    this.theGestureRecognizer = null;
}

Plateformes

Windows Vista, Windows XP SP2, Windows Server 2003

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Informations de version

.NET Framework

Pris en charge dans : 3.0

Voir aussi

Référence

GestureRecognizer, classe

Membres GestureRecognizer

Microsoft.StylusInput, espace de noms

Partager via