RealTimeStylus.WindowInputRectangle, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit le rectangle de saisie pour l'objet RealTimeStylus.

Espace de noms : Microsoft.StylusInput
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Property WindowInputRectangle As Rectangle
'Utilisation
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)

Valeur de propriété

Type : System.Drawing.Rectangle
Rectangle de saisie pour l'objet RealTimeStylus, en pixels.

Valeur	Signification
(0, 0, 0, 0)	Le rectangle de saisie correspond au cadre de la fenêtre.
System.Drawing.Rectangle	Le rectangle de saisie correspond à l'objet Rectangle (page pouvant être en anglais).

Notes

La région d'entrée est l'intersection entre le cadre de la fenêtre et la valeur de cette propriété. Lorsque cette propriété a pour valeur le rectangle vide, l'objet RealTimeStylus collecte sur toute la fenêtre, même lorsque la fenêtre est redimensionnée.

Une fois que l'objet RealTimeStylus commence à rassembler les données de stylet, il continue à collecter les données tant que l'utilisateur ne lève pas le stylet, même si le stylet sort de la région d'entrée. Vous pouvez gérer différemment les données de stylet collectées en dehors de la région d'entrée, soit dans un objet IStylusSyncPlugin attaché, soit dans l'objet IStylusAsyncPlugin attaché.

Cette propriété lève une exception dans les conditions suivantes.

L'objet RealTimeStylus est supprimé.
Cette propriété est définie sur un objet RealTimeStylus créé avec le constructeur RealTimeStylus().

Remarque :
Définir ou obtenir la propriété peut entraîner un appel réentrant lors de son utilisation avec certains gestionnaires de messages, provoquant des résultats inattendus. Prenez soin d'éviter un appel réentrant lors de la gestion de l'un des messages suivants : WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam a la valeur SC_HOTKEY ou SC_TASKLIST, et WM_SYSKEYDOWN (lors de l'utilisation des raccourcis clavier Alt+Tab ou Alt+Echap). Cette opération pose problème dans les applications de modèle de thread unique cloisonné.

Définir ou obtenir la propriété peut entraîner un appel réentrant lors de son utilisation avec certains gestionnaires de messages, provoquant des résultats inattendus. Prenez soin d'éviter un appel réentrant lors de la gestion de l'un des messages suivants : WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam a la valeur SC_HOTKEY ou SC_TASKLIST, et WM_SYSKEYDOWN (lors de l'utilisation des raccourcis clavier Alt+Tab ou Alt+Echap). Cette opération pose problème dans les applications de modèle de thread unique cloisonné.

Exemples

Cet exemple Microsoft Visual C# .NET est un extrait d'un gestionnaire d'événements Load (page pouvant être en anglais) d'un formulaire, qui crée un GestureRecognizer, un DynamicRenderer et deux objets RealTimeStylus, attache les objets dans un modèle RealTimeStylus en cascade et qui active le rendu dynamique, la reconnaissance de mouvement et la collecte des données de stylet grâce à l'objet RealTimeStylus. L'objet GestureRecognizer est configuré pour reconnaître les mouvements monotraits et uniquement les mouvements d'applicationApplicationGesture, ApplicationGesture et ApplicationGesture. La propriété WindowInputRectangle de l'objet principal RealTimeStylus est explicitement définie pour utiliser la totalité du contrôle auquel l'objet RealTimeStylus est attaché. Le formulaire implémente l'interface IStylusAsyncPlugin et est attaché à l'objet 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;

    // ...
}

Plateformes

Windows Vista, Windows XP SP2, Windows Server 2003

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Informations de version

.NET Framework

Pris en charge dans : 3.0

Voir aussi

Référence

RealTimeStylus, classe

Membres RealTimeStylus

Microsoft.StylusInput, espace de noms

Partager via