InkPicture, classe

Article
11/05/2008

Mise à jour : November 2007

Le contrôle InkPicture permet d'insérer une image dans une application et offre aux utilisateurs la possibilité d'y ajouter une entrée manuscrite. Ce contrôle est destiné aux situations où l'entrée manuscrite n'est pas reconnue comme du texte mais est stockée en tant qu'entrée manuscrite.

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

Syntaxe

'Déclaration
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
Public Class InkPicture _
    Inherits PictureBox
'Utilisation
Dim instance As InkPicture

[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
public class InkPicture : PictureBox

[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
public ref class InkPicture : public PictureBox

/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
public class InkPicture extends PictureBox

public class InkPicture extends PictureBox

Notes

Attention :
Vous devez appeler la méthode Dispose sur cet objet avant qu'il soit hors de portée. Cet objet gère des ressources non managées. Le fait de compter sur la finalisation pour cet objet peut provoquer des fuites de mémoire et des exceptions dans votre application. Pour obtenir un exemple de suppression d'objets managés, consultez Using the Managed Library.

Vous devez appeler la méthode Dispose sur cet objet avant qu'il soit hors de portée. Cet objet gère des ressources non managées. Le fait de compter sur la finalisation pour cet objet peut provoquer des fuites de mémoire et des exceptions dans votre application.

Pour obtenir un exemple de suppression d'objets managés, consultez Using the Managed Library.

Pour ce contrôle, l'interface utilisateur d'exécution est une fenêtre avec un arrière-plan opaque (couleur unie, image d'arrière-plan, ou les deux) qui contient une entrée manuscrite opaque.

Vous pouvez utiliser le contrôle InkPicture pour restituer une entrée manuscrite dans Microsoft Windows 2000, Windows Server 2003, toutes les éditions de Windows XP et toutes les versions de Windows Vista. Toutefois, vous pouvez effectuer une entrée manuscrite, accepter des mouvements ou reconnaître l'écriture manuscrite uniquement sous les conditions suivantes :

L'entrée manuscrite peut être entrée et reconnue uniquement si la technologie Tablet and Touch est installée.
Les mouvements ne peuvent être reconnus que si la reconnaissance de mouvements Microsoft est installée.
L'écriture manuscrite peut être reconnue comme du texte si 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 assigner des valeurs aux propriétés du contrôle InkPicture et copier-coller l'entrée manuscrite dans d'autres applications, mais la valeur de sa propriété InkEnabled sera toujours false.

Les objets Ink persistants peuvent être chargés et affichés sur toutes les éditions de Windows XP (y compris l'édition Tablet PC). Toutefois, les objets Ink peuvent être convertis en texte (reconnus) uniquement 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 les performances de votre application, supprimez manuellement un contrôle InkPicture lorsqu'il n'est plus nécessaire.

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

Hiérarchie d'héritage

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.Control
        System.Windows.Forms.PictureBox
          Microsoft.Ink.InkPicture

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.