InkOverlay.Enabled, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit une valeur qui spécifie si l'objet InkOverlay collecte les saisies effectuées à l'aide du stylet.

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

Syntaxe

'Déclaration
<BrowsableAttribute(False)> _
Public Property Enabled As Boolean
'Utilisation
Dim instance As InkOverlay
Dim value As Boolean

value = instance.Enabled

instance.Enabled = value

[BrowsableAttribute(false)]
public bool Enabled { get; set; }

[BrowsableAttribute(false)]
public:
property bool Enabled {
    bool get ();
    void set (bool value);
}

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

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

Valeur de propriété

Type : System.Boolean
Si l'objet InkOverlay collecte ou non les saisies effectuées à l'aide du stylet.
true si l'objet InkOverlay collecte les saisies effectuées à l'aide du stylet.
false si l'objet InkOverlay ne signale pas les saisies effectuées à 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 InkOverlay collecte l'entrée manuscrite dans Microsoft Windows Vista, 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 n'est possible que dans Microsoft Windows XP Édition Tablet PC ou version ultérieure. La propriété Enabled a la valeur false pour toutes les éditions de Windows 2000, Windows Server 2003 ou Windows XP 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) recouvre le rectangle de saisie de la fenêtre d'un InkOverlay, 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 InkOverlay avant d'arrêter une application.

Exemples

Cet exemple C# crée un objet InkOverlay et l'active.

using Microsoft.Ink;
//...
InkOverlay theInkOverlay = new InkOverlay(Handle);
theInkOverlay.Enabled = true;
//...

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

Imports Microsoft.Ink
'...
Dim theInkOverlay As New InkOverlay(Handle)
theInkOverlay.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.