InkEdit, classe

Article
11/05/2008

Mise à jour : November 2007

Le contrôle InkEdit vous permet de collecter l'entrée manuscrite, de la reconnaître et de l'afficher comme du texte. Ce contrôle vous permet d'activer des formulaires intelligents. Ils améliorent l'exactitude de la saisie de texte.

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

Syntaxe

'Déclaration
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Class InkEdit _
    Inherits RichTextBox
'Utilisation
Dim instance As InkEdit

[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public class InkEdit : RichTextBox

[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public ref class InkEdit : public RichTextBox

/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public class InkEdit extends RichTextBox

public class InkEdit extends RichTextBox

Notes

Ce contrôle est un sur-ensemble du contrôle RichTextBox. Il permet au contrôle RichTextBox de capturer, de reconnaître et d'afficher l'entrée manuscrite.

Si une énumération, un événement, une méthode ou une propriété du contrôle RichTextBox n'est pas abordé ci-dessous, il ne faut pas le substituer dans le contrôle InkEdit mais l'utiliser exactement tel que décrit la documentation du contrôle RichTextBox. Par exemple, les valeurs et les paramètres décrits comme n'étant valides qu'avec un contrôle RichTextBox, comme le champ d'énumération RichNoOleObjs, fonctionnent de la même façon avec le contrôle InkEdit car c'est un contrôle RichTextBox.

Attention :
Pour éviter une fuite de mémoire, vous devez appeler explicitement la méthode Dispose sur tout objet InkEdit auquel un gestionnaire d'événements a été attaché avant que les objets ne soient hors de portée.

Avec Windows Vista, vous pouvez utiliser le contrôle InkEdit. Avec Microsoft Windows 2000, Windows Server 2003 et toute édition de Windows XP autre que Windows XP Édition Tablet PC, vous ne pouvez pas utiliser le contrôle InkEdit pour restituer l'entrée manuscrite. Vous pouvez entrer l'entrée manuscrite, accepter des mouvements ou reconnaître l'écriture manuscrite uniquement dans les conditions suivantes :

L'entrée manuscrite ne peut être entrée et reconnue que si Windows XP Édition Tablet PC est installé.
Les mouvements ne sont reconnus que si Windows XP Édition Tablet PC est installé.
L'écriture manuscrite peut être reconnue comme du texte elle provient d'ailleurs et si les modules de reconnaissance sont présents.

Si vous utilisez Windows 2000, Windows Server 2003 ou toute édition de Windows XP autre que l'édition Tablet PC, vous pouvez affecter des valeurs aux propriétés du contrôle InkEdit et copier-coller l'entrée manuscrite dans d'autres applications. La valeur de sa propriété InkMode sera alors toujours Disabled.

L'insertion intelligente d'espaces n'est disponible que lorsque Windows XP Édition Tablet PC est installé.

Les fichiers avec des objets Ink incorporés peuvent être chargés et affichés dans n'importe quelle édition de Windows XP (y compris Windows XP Édition Tablet PC) et sur des systèmes sur lesquels seul le Kit de développement logiciel (SDK) Tablet PC peut être installé. Toutefois, les objets Ink incorporés ne peuvent être convertis en texte que si Windows XP Édition Tablet PC est installé.

Pour plus d'informations sur les contrôles d'entrée manuscrite, consultez Ink Controls.

Pour plus d'informations sur les threads qui déclenchent des événements particuliers, consultez Threads on Which an Event Can Fire.

Pour améliorer la performance de votre application, supprimez manuellement un contrôle InkEdit lorsque il n'est plus nécessaire.

Note de sécurité :
Lors de l'utilisation sous confiance partielle, cette classe et toutes ses méthodes requièrent l'autorisation SafeTopLevelWindows. Pour plus d'informations, consultez Security and Trust.

La version gérée du contrôle InkEdit encapsule le contrôle COM InkEdit. Le constructeur du contrôle InkEdit managé, la méthode Divide, la propriété LineHeight, la propriété RecognizerContext et la propriété Strokes lèvent tous une exception Marshal.ThrowExceptionForHR si le contrôle COM InkEdit retourne une erreur. Consultez InkEdit Control Reference pour plus d'informations sur les erreurs qui peuvent être retournées.

Hiérarchie d'héritage

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.Control
        System.Windows.Forms.TextBoxBase
          System.Windows.Forms.RichTextBox
            Microsoft.Ink.InkEdit

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

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.