RealTimeStylus.Dispose (Método)
Actualización: noviembre 2007
Libera todos los recursos que usa el objeto RealTimeStylus.
Espacio de nombres: Microsoft.StylusInput
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)
Sintaxis
'Declaración
Public Sub Dispose
'Uso
Dim instance As RealTimeStylus
instance.Dispose()
public void Dispose()
public:
virtual void Dispose() sealed
public final void Dispose()
public final function Dispose()
Implementaciones
Comentarios
Una llamada al método Dispose permite que los recursos que usa el objeto se reasignen para otros propósitos.
El objeto RealTimeStylus no garantiza la seguridad para subprocesos del método Dispose. Evite llamar al método Dispose mientras otros subprocesos puedan estar utilizando el objeto RealTimeStylus.
Advertencia
A partir del Kit de desarrollo de software (SDK) de Microsoft Windows XP Tablet PC Edition, se debe llamar explícitamente al método dispose en cualquier objeto o control 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 Dispose, elimine manualmente cada instancia de esa clase cuando ya no la necesite. La eliminación de estos objetos mejora el rendimiento de la aplicación.
Nota
El objeto RealTimeStylus produce una excepción si cualquiera de sus complementos llama a su método Dispose desde una implementación de método de interfaz IStylusSyncPlugin o IStylusAsyncPlugin.
Ejemplos
Este ejemplo de Microsoft Visual C# .NET 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 los 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