InkPicture.InkEnabled, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit une valeur qui spécifie si le contrôle InkPicture collecte les entrées du stylet.

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

Syntaxe

'Déclaration
<BrowsableAttribute(True)> _
Public Property InkEnabled As Boolean
'Utilisation
Dim instance As InkPicture
Dim value As Boolean

value = instance.InkEnabled

instance.InkEnabled = value

[BrowsableAttribute(true)]
public bool InkEnabled { get; set; }

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

/** @property */
/** @attribute BrowsableAttribute(true) */
public boolean get_InkEnabled()
/** @property */
/** @attribute BrowsableAttribute(true) */
public  void set_InkEnabled(boolean value)

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

Valeur de propriété

Type : System.Boolean
true si le contrôle InkPicture collecte les entrées du stylet. Par défaut.
false si le contrôle InkPicture ne signale pas les entrées 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.

Le contrôle InkPicture 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é InkEnabled 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 type InkCollector ou InkOverlay actif (défini dans le constructeur ou avec la méthode SetWindowInputRectangle) chevauche le rectangle de saisie de la fenêtre d'un type InkPicture, une exception COMException 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é InkEnabled tant que le contrôle collecte l'entrée manuscrite (la propriété CollectingInk a la valeur true).

La propriété InkEnabled doit avoir la valeur false avant qu'il soit possible de définir ou d'appeler les propriétés et les méthodes spécifiques du contrôle. 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, à moins que la propriété InkEnabled n'ait la valeur false au préalable :

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

Vous devez affecter la valeur false à la propriété InkEnabled d'un contrôle InkPicture avant d'arrêter une application.

Exemples

L'exemple suivant définit un gestionnaire d'événements pour un événement ButtonClick. Lorsque l'événement est déclenché, le gestionnaire bascule la valeur de la propriété InkEnabled et met à jour le texte du Button pour refléter l'action que le prochain clic exécutera.

' Event handler for the button's Click event.
Private Sub buttonToggle_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles buttonToggle.Click
    ' toggle the InkEnabled property and update button text
    mInkPicture.InkEnabled = Not mInkPicture.InkEnabled
    If mInkPicture.InkEnabled Then
        DirectCast(sender, Button).Text = "Disable Ink"
    Else
        DirectCast(sender, Button).Text = "Enable Ink"
    End If

End Sub

// Event handler for the button's Click event.
private void buttonToggle_Click(object sender, System.EventArgs e)
{
    // toggle the InkEnabled property and update button text
    mInkPicture.InkEnabled = !mInkPicture.InkEnabled;
    ((Button)sender).Text = (mInkPicture.InkEnabled) ? "Disable Ink" : "Enable Ink";
}

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.