RealTimeStylus.Dispose-Methode
Gibt alle vom RealTimeStylus-Objekt verwendeten Ressourcen frei.
Namespace: Microsoft.StylusInput
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Syntax
'Declaration
Public Sub Dispose
'Usage
Dim instance As RealTimeStylus
instance.Dispose()
public void Dispose()
public:
virtual void Dispose() sealed
public final void Dispose()
public final function Dispose()
Implementiert
Hinweise
Durch Aufrufen der Dispose-Methode können die vom Objekt verwendeten Ressourcen für andere Zwecke neu reserviert werden.
Das RealTimeStylus-Objekt garantiert keine Threadsicherheit für die Dispose-Methode. Vermeiden Sie das Aufrufen der Dispose-Methode, während andere Threads möglicherweise das RealTimeStylus-Objekt verwenden.
Warnung
Sie müssen ausgehend vom Microsoft Windows XP Tablet PC Edition-SDK (Software Development Kit) die Dispose-Methode für jedes Objekt oder Steuerelement explizit aufrufen, an das ein Ereignishandler angefügt wurde, bevor das Objekt oder Steuerelement den Gültigkeitsbereich verlässt.
Entfernen Sie für jede Klasse im Tablet PC SDK, für die Dispose definiert ist, manuell jede nicht mehr benötigte Instanz dieser Klasse. Durch Freigeben dieser Objekte wird die Leistung der Anwendung verbessert.
Hinweis
Das RealTimeStylus-Objekt löst eine Ausnahme aus, wenn dessen Dispose-Methode durch eines seiner Plug-Ins von einer Implementierung einer IStylusSyncPlugin- oder IStylusAsyncPlugin-Schnittstellenmethode aufgerufen wird.
Beispiele
Dieses Microsoft Visual C# .NET-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