InkCollector, classe

Article
11/05/2008

Mise à jour : November 2007

Représente un objet utilisé pour capturer l'entrée manuscrite à partir de périphériques de tablette disponibles.

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 InkCollector _
    Implements IDisposable
'Utilisation
Dim instance As InkCollector

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

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

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

public class InkCollector implements IDisposable

Notes

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

L'objet InkCollector collecte uniquement les entrées manuscrites et de mouvement. Le seul objectif du InkCollector est de collecter l'entrée manuscrite du matériel (par exemple, à l'aide des objets Cursor et Tablet) et de la transmettre à une application. Pour l'essentiel, il distribue l'entrée manuscrite à un ou plusieurs objets Ink différents, agissant ainsi comme un conteneur pour l'entrée manuscrite distribuée.

Pour utiliser un InkCollector, créez-le, définissez la fenêtre qui collectera l'entrée manuscrite tracée et activez-le. Lorsque le InkCollector est activé, il ne peut collecter l'entrée manuscrite que dans un des trois modes (comme spécifié dans l'énumération CollectionMode) :

InkOnly, dans lequel un objet Stroke est créé.
GestureOnly, dans lequel un objet Gesture est créé.
InkAndGesture, dans lequel un trait, un mouvement ou éventuellement les deux sont créés, selon la manière dont l'application gère les événements.

Pour chaque mouvement d'un curseur dans la plage d'un Tablet PC, le InkCollector collecte un trait ou un mouvement, parfois les deux. La prise en charge des mouvements est intégrée via la reconnaissance des mouvements Microsoft.

Un InkCollector gère la saisie Tablet PC. L'entrée manuscrite peut être collectée simultanément sur toutes les tablettes connectées (y compris la souris). Les modifications apportées aux objets Cursor et CursorButton peuvent conduire l'objet InkCollector à déclencher un événement.

Un InkCollector gère également une liste de curseurs rencontrés pendant son existence. Lorsque le InkCollector rencontre un nouveau curseur, l'événement CursorInRange se déclenche et la propriété NewCursor de l'objet InkCollectorCursorInRangeEventArgs a la valeur true. Les applications utilisent le InkCollector pour gérer les nouveaux curseurs.

Plusieurs InkCollector peuvent être associés à un handle de fenêtre spécifique, même si leurs zones de collection, définies à l'aide du constructeur ou de la méthode SetWindowInputRectangle, se chevauchent. En revanche, ce scénario fonctionne uniquement si chaque InkCollector appelle SetSingleTabletIntegratedMode et utilise un seul Tablet PC. Ce comportement facilite le stockage de l'entrée manuscrite dans un objet distinct pour chaque Tablet PC.

Une erreur se produit si le rectangle de saisie de la fenêtre d'un objet InkCollector activé (défini avec la propriété Enabled) chevauche celui d'un autre objet InkCollector activé.

Remarque :
Le chevauchement ne génère pas d'erreur si un seul rectangle de saisie est activé à la fois.

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.

Le InkCollector se comporte différemment dans les applications créées à l'aide de Microsoft Visual Basic et dans celles créées à l'aide de Microsoft Foundation Classes (MFC). Pour plus d'informations sur ces comportements, consultez Ink Collection.

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

Pour améliorer les performances de votre application, supprimez manuellement un objet InkCollector 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.InkCollector

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.