InkCollector.Enabled, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit une valeur qui spécifie si l'objet InkCollector collecte la saisie effectuée à l'aide du stylet.

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

Syntaxe

'Déclaration
Public Property Enabled As Boolean
'Utilisation
Dim instance As InkCollector
Dim value As Boolean

value = instance.Enabled

instance.Enabled = value

public bool Enabled { get; set; }

public:
property bool Enabled {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_Enabled()
/** @property */
public  void set_Enabled(boolean value)

public function get Enabled () : boolean
public function set Enabled (value : boolean)

Valeur de propriété

Type : System.Boolean
true si l'objet InkCollector collecte la saisie effectuée à l'aide du stylet. false si l'objet InkCollector ne signale pas la saisie effectuée à l'aide du stylet. Aucun événement associé au stylet n'est déclenché.

Notes

En plus de l'entrée manuscrite, la saisie effectuée à l'aide du stylet peut inclure des paquets in-air, un curseur dans des événements de plage, etc.

L'objet InkCollector collecte l'entrée manuscrite dans Microsoft® Windows® XP Édition Tablet PC ou toute édition de Windows 2000, Windows Server 2003 ou Windows XP sur laquelle le kit de développement logiciel (SDK) de Windows XP Édition Tablet PC est installé. Toutefois, la reconnaissance de l'écriture manuscrite se produit uniquement si vous utilisez Windows XP Édition Tablet PC. Dans toute édition de Windows 2000, Windows Server 2003 ou Windows XP autre que Windows XP Édition Tablet PC, la propriété Enabled a toujours la valeur false si le Kit de développement logiciel (SDK) de Windows XP Édition Tablet PC n'est pas installé.

Si le rectangle de saisie de la fenêtre d'un InkCollector ou d'un InkOverlay activé (défini dans le constructeur ou avec la méthode SetWindowInputRectangle) chevauche le rectangle de saisie de la fenêtre d'un InkCollector, une exception COMException (page pouvant être en anglais) est levée.

Remarque :
Le chevauchement ne génère pas d'erreur si un seul rectangle de saisie est activé à la fois.

Lorsqu'un contrôle n'est pas activé, vous ne recevez aucun événement.

Lorsque vous affectez la valeur false à la propriété Enabled d'un contrôle conteneur, tous les contrôles contenus sont eux aussi désactivés.

Vous ne pouvez pas affecter la valeur false à la propriété Enabled tant que l'objet collecte l'entrée manuscrite (la propriété CollectingInk a la valeur true).

La propriété Enabled doit avoir la valeur false avant la définition ou l'appel à des propriétés et des méthodes spécifiques de l'objet. Si vous essayez de modifier les propriétés spécifiées ou appelez les méthodes spécifiées, une erreur se produit.

Les propriétés et méthodes suivantes ne peuvent pas être définies ou appelées sauf si la propriété Enabled prend la valeur false au préalable :

Propriétés :
- Handle
- Ink
- MarginX
- MarginY
Méthodes :
- SetAllTabletsMode
- SetSingleTabletIntegratedMode

Vous devez affecter la valeur false à la propriété Enabled d'un objet InkCollector avant d'arrêter une application.

Remarque :
Cette fonction peut être entrée à nouveau si la propriété Enabled est définie dans certains gestionnaires de messages et provoque 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é.

Cette fonction peut être entrée à nouveau si la propriété Enabled est définie dans certains gestionnaires de messages et provoque 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 C# crée un objet InkCollector et l'active.

using Microsoft.Ink;
//...
InkCollector theInkCollector = new InkCollector(Handle);
theInkCollector.Enabled = true;
//...

Cet exemple Microsoft Visual Basic .NET crée un objet InkCollector et l'active.

Imports Microsoft.Ink
'...
Dim theInkCollector As New InkCollector(Handle)
theInkCollector.Enabled() = True
'...

Plateformes

Windows Vista

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.