RealTimeStylus.Dispose, méthode

Article
11/05/2008

Mise à jour : November 2007

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

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

Syntaxe

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

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.

L'objet RealTimeStylus ne garantit pas la sécurité des threads pour la méthode Dispose. Évitez d'appeler la méthode Dispose pendant que d'autres threads sont susceptibles d'utiliser l'objet RealTimeStylus.

Attention :
À partir du Kit de développement logiciel (SDK) Windows® XP Édition Tablet PC, vous devez appeler explicitement la méthode Dispose sur tout objet ou contrôle 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 (SDK) Tablet PC sur laquelle la méthode Dispose est définie, supprimez manuellement chaque instance de classe lorsqu'elle n'est plus d'aucune utilité. La suppression de ces objets améliore les performances de votre application.

Remarque :
L'objet RealTimeStylus lève une exception si sa méthode Dispose est appelée par l'un de ses plug-in à partir d'une implémentation de méthode d'interface IStylusSyncPlugin ou IStylusAsyncPlugin.

Exemples

Cet exemple Microsoft Visual C# .NET 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 leurs 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

RealTimeStylus, classe

Membres RealTimeStylus

Microsoft.StylusInput, espace de noms

Partager via