RealTimeStylus.WindowInputRectangle (Propiedad)
Actualización: noviembre 2007
Obtiene o establece el rectángulo de entrada para el objeto RealTimeStylus.
Espacio de nombres: Microsoft.StylusInput
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)
Sintaxis
'Declaración
Public Property WindowInputRectangle As Rectangle
'Uso
Dim instance As RealTimeStylus
Dim value As Rectangle
value = instance.WindowInputRectangle
instance.WindowInputRectangle = value
public Rectangle WindowInputRectangle { get; set; }
public:
property Rectangle WindowInputRectangle {
Rectangle get ();
void set (Rectangle value);
}
/** @property */
public Rectangle get_WindowInputRectangle()
/** @property */
public void set_WindowInputRectangle(Rectangle value)
public function get WindowInputRectangle () : Rectangle
public function set WindowInputRectangle (value : Rectangle)
Valor de propiedad
Tipo: System.Drawing.Rectangle
Rectángulo de entrada para el objeto RealTimeStylus, en píxeles.
Valor |
Significado |
|---|---|
(0, 0, 0, 0) |
El rectángulo de entrada se corresponde con los límites de la ventana. |
System.Drawing.Rectangle |
El rectángulo de entrada se corresponde con el objeto Rectangle. |
Comentarios
La región de entrada es la intersección de los límites de la ventana y el valor de esta propiedad. Cuando esta propiedad se establece en el rectángulo vacío, el objeto RealTimeStylus abarca toda la ventana, incluso cuando se cambia el tamaño de la misma.
Cuando el objeto RealTimeStylus empieza a recopilar datos del lápiz de Tablet PC, continúa recopilándolos hasta que se levanta el lápiz, aun cuando éste se mueve fuera de la región de entrada. Puede decidir administrar los datos del lápiz de Tablet PC que se recopilan fuera de la región de entrada de manera diferente, bien en un objeto IStylusSyncPlugin asociado o en el objeto IStylusAsyncPlugin asociado.
Esta propiedad inicia una excepción en las condiciones siguientes.
El objeto RealTimeStylus se desecha.
Esta propiedad se establece en un objeto RealTimeStylus que se creó con el constructor RealTimeStylus().
Nota
Al establecer u obtener la propiedad, se puede producir una llamada reentrante cuando se usa en ciertos controladores de mensajes, con resultados inesperados. Procure evitar que se produzca una llamada reentrante al controlar cualquiera de los siguientes mensajes: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam se establece en SC_HOTKEY o SC_TASKLIST; y WM_SYSKEYDOWN (al procesar las combinaciones de teclas Alt-Tab o Alt-Esc). Este problema se produce con las aplicaciones del modelo de contenedor uniproceso.
Ejemplos
Este ejemplo de Microsoft Visual C# .NET es un fragmento de código del controlador de eventos Load de un formulario que crea un objeto GestureRecognizer, DynamicRenderer, y dos objetos RealTimeStylus, asocia los objetos en un modelo RealTimeStylus en cascada y habilita la representación dinámica, el reconocimiento de movimientos y la recopilación de datos manuscritos del Tablet PC a través del objeto RealTimeStylus. El objeto GestureRecognizer se establece para reconocer los movimientos de un solo trazo y para reconocer sólo los movimientos de aplicación ApplicationGesture, ApplicationGesture y ApplicationGesture. La propiedad WindowInputRectangle del objeto RealTimeStylus primario se establece explícitamente para usar todo el control al que está asociado el objeto RealTimeStylus. El formulario implementa por sí mismo la interfaz IStylusAsyncPlugin y se asocia al objeto RealTimeStylus.
using Microsoft.Ink;
using Microsoft.StylusInput;
using Microsoft.StylusInput.PluginData;
// ...
// The panel where the tablet pen data is collected.
private System.Windows.Forms.Panel thePanel;
// 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 Load event handler.
private void theForm_Load(object sender, System.EventArgs e)
{
// ...
// Create a DynamicRenderer attached to the drawing area ,
// and enable dynamic rendering.
this.theDynamicRenderer = new DynamicRenderer(this.thePanel);
this.theDynamicRenderer.Enabled = true;
// Create a GestureRecognizer, and set it to recognize single-stroke gestures.
this.theGestureRecognizer = new GestureRecognizer();
this.theGestureRecognizer.MaxStrokeCount = 1;
// Allow gesture recognition for specific gestures.
this.theGestureRecognizer.EnableGestures( new ApplicationGesture[]
{
ApplicationGesture.Right,
ApplicationGesture.ChevronRight,
ApplicationGesture.ArrowRight
} );
// Enable gesture recognition.
this.theGestureRecognizer.Enabled = true;
// Create the primary and secondary RealTimeStylus objects.
this.thePrimaryRealTimeStylus = new RealTimeStylus(this.thePanel);
this.theSecondaryRealTimeStylus = new RealTimeStylus();
// Add the secondary RealTimeStylus to the primary's asynchronous plug-in collection.
this.thePrimaryRealTimeStylus.AsyncPluginCollection.Add(
this.theSecondaryRealTimeStylus);
// Add the dynamic renderer to the primary's synchronous plug-in collection.
this.thePrimaryRealTimeStylus.SyncPluginCollection.Add(this.theDynamicRenderer);
// Add the gesture recognizer to the secondary's synchronous plug-in collection.
this.theSecondaryRealTimeStylus.SyncPluginCollection.Add(this.theGestureRecognizer);
// Add the form to the secondary's asynchronous plug-in colleciton.
this.theSecondaryRealTimeStylus.AsyncPluginCollection.Add(this);
// Set the input rectangle to the entire panel for the RealTimeStylus.
this.thePrimaryRealTimeStylus.WindowInputRectangle = new Rectangle(0,0,0,0);
// Enable the RealTimeStylus, which allows notifications to flow to the plug-ins.
this.thePrimaryRealTimeStylus.Enabled = true;
// ...
}
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