GestureRecognizer.Dispose-Methode

Gibt die vom GestureRecognizer-Objekt verwendeten Ressourcen frei.

Namespace:  Microsoft.StylusInput
Assembly:  Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Sub Dispose
'Usage
Dim instance As GestureRecognizer

instance.Dispose()

public void Dispose()

public:
virtual void Dispose() sealed

public final void Dispose()

public final function Dispose()

Implementiert

IDisposable.Dispose()

Hinweise

Durch Aufrufen der Dispose-Methode können die vom Objekt verwendeten Ressourcen für andere Zwecke neu reserviert werden. Weitere Informationen zur Garbage Collection finden Sie unter Programming for Garbage Collection.

Entfernen Sie für jede Klasse im Tablet PC SDK, für die die Dispose-Methode definiert ist, manuell jede nicht mehr benötigte Instanz dieser Klasse. Durch Freigeben dieser Objekte wird die Leistung der Anwendung verbessert.

Beispiele

Dieses C#-Beispiel ist ein Ausschnitt aus dem Closed-Ereignishandler eines Formulars, der die Objekte RealTimeStylus, GestureRecognizer und DynamicRenderer deaktiviert, die Warteschlangen der RealTimeStylus-Objekte leert und die Dispose-Methode der Objekte aufruft.

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;
}

Plattformen

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0

Siehe auch

Referenz

GestureRecognizer-Klasse

GestureRecognizer-Member

Microsoft.StylusInput-Namespace