InkOverlay, classe

Article
11/05/2008

Mise à jour : November 2007

Représente un objet qui est utile pour les scénarios d'annotation où les utilisateurs ne s'intéressent pas à la reconnaissance de l'écriture manuscrite, mais plutôt à la taille, forme, couleur et position de l'entrée manuscrite.

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

Syntaxe

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

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

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

/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public class InkOverlay implements IDisposable

public class InkOverlay implements IDisposable

Notes

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

L'objet InkOverlay est tout à fait adapté à la prise de notes et aux gribouillages simples. Cet objet a principalement été conçu pour afficher une entrée manuscrite sous forme d'écriture manuscrite.

En général, l'interface utilisateur d'exécution pour cet objet se présente sous la forme d'une fenêtre transparente avec une entrée manuscrite opaque.

Les événements MouseDown, MouseMove, MouseUp et MouseWheel retournent les coordonnées X et Y en pixels et non les unités HIMETRIC associées à l'espace d'entrée manuscrite. Cela tient au fait que ces événements remplacent les événements de souris des applications qui ne prennent pas en charge les stylets et qui comprennent uniquement les pixels.

Attention :
Si vous affectez la valeur InFront à la propriété AttachMode de l'objet InkOverlay, créez l'objet InkOverlay dans le thread dans lequel le formulaire s'exécute. Votre application peut cesser de répondre si l'objet InkOverlay est créé dans un thread différent et que sa propriété AttachMode a la valeur InFront.

Remarque :
L'objet InkOverlay ne peut pas être libéré sans risques sur un thread d'interface non-utilisateur.

Pour améliorer les performances de votre application, supprimez manuellement un objet InkOverlay lorsqu'il n'est plus utile.

Note de sécurité :
Lors de l'utilisation en situation de confiance partielle, cette classe et toutes ses méthodes requièrent l'autorisation UIPermissionWindow.SafeTopLevelWindows (page pouvant être en anglais). Pour plus d'informations, consultez Security and Trust.

Hiérarchie d'héritage

System.Object
Microsoft.Ink.InkOverlay

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.