GestureRecognizer.Dispose (Método)

Actualización: noviembre 2007

Libera los recursos que usa el objeto GestureRecognizer.

Espacio de nombres:  Microsoft.StylusInput
Ensamblado:  Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Sub Dispose
'Uso
Dim instance As GestureRecognizer

instance.Dispose()

public void Dispose()

public:
virtual void Dispose() sealed

public final void Dispose()

public final function Dispose()

Implementaciones

IDisposable.Dispose()

Comentarios

Una llamada al método Dispose permite que los recursos que usa el objeto se reasignen para otros propósitos. Para obtener más información sobre la recolección de elementos no utilizados, vea Programming for Garbage Collection.

Advertencia

Para evitar una pérdida de memoria, debe llamar explícitamente a este método en cualquier objeto o control del Kit de desarrollo de software (SDK) de Microsoft® Windows® XP Tablet PC Edition al que se haya asociado un controlador de eventos antes de que dicho objeto o control estén fuera de ámbito.

Para cualquier clase del SDK de Tablet PC en la que se defina el método Dispose, elimine manualmente cada instancia de esa clase cuando ya no la necesite. La eliminación de estos objetos mejorará el rendimiento de la aplicación.

Ejemplos

Este ejemplo de C# es un fragmento de código del controlador de eventos Closed de un formulario que deshabilita los objetos RealTimeStylus, GestureRecognizer y DynamicRenderer, vacía las colas de objetos RealTimeStylus y llama al método Dispose de los objetos.

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

Plataformas

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión

.NET Framework

Compatible con: 3.0

Vea también

Referencia

GestureRecognizer (Clase)

GestureRecognizer (Miembros)

Microsoft.StylusInput (Espacio de nombres)