Classe InkOverlay

Représente un objet utile pour les scénarios d’annotation dans lesquels les utilisateurs ne sont pas concernés par la reconnaissance sur l’entrée manuscrite, mais s’intéressent plutôt à la taille, à la forme, à la couleur et à la position de l’encre.

La création du contrôle InkOverlay derrière un contrôle transparent (par exemple, un GroupBox avec la propriété WS_EX_TRANSPARENT définie) empêche InkOverlay de collecter l’encre.

InkOverlay a les types de membres suivants :

• Événements
• Interfaces
• Méthodes
• Propriétés

Événements

La classe InkOverlay contient ces événements.

Événement	Description
CursorButtonDown	Se produit lorsque inkOverlay détecte un bouton de curseur qui est vers le bas.
CursorButtonUp	Se produit lorsque inkOverlay détecte un bouton de curseur qui est en place.
CursorDown	Se produit lorsque l’extrémité du curseur contacte la surface de la tablette de numérisation.
CursorInRange	Se produit lorsqu’un curseur entre dans la plage de détection physique (proximité) du contexte de la tablette.
CursorOutOfRange	Se produit lorsque le curseur quitte la plage de détection physique (proximité) du contexte de la tablette.
Doubleclick	Se produit lorsque l’objet InkOverlay fait l’objet d’un double-clic.
Mouvement	Se produit lorsqu’un mouvement spécifique à l’application est reconnu.
Mousedown	Se produit lorsque le pointeur de la souris se trouve sur l’objet InkOverlay et qu’un bouton de la souris est enfoncé.
Mousemove	Se produit lorsque le pointeur de la souris est déplacé sur l’objet InkOverlay .
Mouseup	Se produit lorsque le pointeur de la souris se trouve sur l’objet InkOverlay et qu’un bouton de la souris est relâché.
MouseWheel	Se produit lorsque la roulette de la souris se déplace alors que l’objet InkOverlay a le focus.
NewInAirPackets	Se produit lorsqu’un paquet en air est visible, ce qui se produit lorsqu’un utilisateur déplace un stylet près de la tablette et que le curseur se trouve dans la fenêtre de l’objet InkOverlay ou que l’utilisateur déplace une souris dans la fenêtre associée de l’objet InkOverlay .
NewPackets	Se produit lorsque l’objet InkOverlay reçoit des paquets.
Peint	Se produit lorsque l’objet InkOverlay a terminé de se redessiner lui-même.
Peinture	Se produit avant que l’objet InkOverlay ne se redessine lui-même.
SelectionChanged	Se produit lorsque la sélection de l’entrée manuscrite dans le contrôle a changé, par exemple par le biais de modifications de l’interface utilisateur, de procédures couper-coller ou de la propriété Selection .
SelectionChanging	Se produit lorsque la sélection de l’entrée manuscrite dans le contrôle est sur le point de changer, par exemple par le biais de modifications de l’interface utilisateur, de procédures couper-coller ou de la propriété Selection .
SelectionMoved	Se produit lorsque la position de la sélection actuelle a changé, par exemple par le biais de modifications de l’interface utilisateur, de procédures couper-coller ou de la propriété Selection .
SelectionMoving	Se produit lorsque la position de la sélection actuelle est sur le point de changer, par exemple par le biais de modifications de l’interface utilisateur, de procédures couper-coller ou de la propriété Selection .
SelectionResized	Se produit lorsque la taille de la sélection actuelle a changé, par exemple par le biais de modifications de l’interface utilisateur, de procédures de couper-coller ou de la propriété Selection .
SelectionResizing	Se produit lorsque la taille de la sélection actuelle est sur le point de changer, par exemple par le biais de modifications de l’interface utilisateur, de procédures couper-coller ou de la propriété Selection .
Trait	Se produit lorsque l’utilisateur a fini de dessiner un nouveau trait sur n’importe quelle tablette.
StrokesDeleted	Se produit après la suppression des traits de la propriété Ink .
StrokesDeleting	Se produit avant la suppression des traits de la propriété Ink .
SystemGesture	Se produit lorsqu’un mouvement système est reconnu.
TabletAdded	Se produit lorsqu’un IInkTablet est ajouté au système.
TabletRemoved	Se produit lorsqu’une tablette est supprimée du système.

Interfaces

La classe InkOverlay définit ces interfaces.

Interface	Description
IInkOverlay	Cet objet implémente l’interface COM IInkOverlay .

Méthodes

La classe InkOverlay a ces méthodes.

Méthode	Description
Dessin	Définit un rectangle dans lequel redessiner l’entrée manuscrite dans l’objet InkOverlay .
GetEventInterest	Retourne l’état actuel d’un événement d’objet InkOverlay particulier, c’est-à-dire si l’événement est écouté ou utilisé.
GetGestureStatus	Retourne si l’objet InkOverlay s’intéresse à un mouvement particulier.
GetWindowInputRectangle	Récupère le rectangle de fenêtre, en pixels, dans lequel l’entrée manuscrite est dessinée.
HitTestSelection	Détermine la partie de la sélection qui a été atteinte lors d’un test de positionnement.
SetAllTabletsMode	Ce mode permet à l’objet InkOverlay de collecter des entrées manuscrites à partir de n’importe quelle tablette attachée au Tablet PC.
SetEventInterest	Définit si un événement spécifique doit être écouté ou utilisé.
SetGestureStatus	Définit l’intérêt de l’objet InkOverlay dans un mouvement connu.
SetSingleTabletIntegratedMode	Ce mode permet à l’objet InkOverlay de collecter des entrées manuscrites à partir d’une seule tablette. L’entrée manuscrite d’autres tablettes est ignorée par l’objet InkOverlay .
SetWindowInputRectangle	Définit le rectangle de fenêtre, en pixels, à utiliser pour mapper l’entrée manuscrite dessinée à la fenêtre.

Propriétés

La classe InkOverlay a ces propriétés.

Propriété	Type d’accès	Description
AttachMode	Lecture/écriture	Obtient ou définit la valeur qui spécifie si l’objet InkOverlay est attaché derrière ou devant la fenêtre connue.
Redessinage automatique	Lecture/écriture	Obtient ou définit une valeur qui spécifie si inkOverlay repeint l’encre lorsque la fenêtre est invalidée.
CollectingInk	Lecture seule	Obtient une valeur qui spécifie si l’encre est en cours de dessin sur un objet InkOverlay .
CollectionMode	Lecture/écriture	Obtient ou définit le mode de collection qui détermine si l’entrée manuscrite, les mouvements ou les deux sont reconnus au fur et à mesure que l’utilisateur écrit.
Curseurs	Lecture seule	Obtient la collection Cursors qui est disponible pour une utilisation dans la région d’entrée manuscrite.
DefaultDrawingAttributes	Lecture/écriture	Obtient ou définit l’objet InkDrawingAttributes par défaut, qui spécifie les attributs de dessin utilisés lors du dessin et de l’affichage de l’encre.
DesiredPacketDescription	Lecture/écriture	Obtient ou définit l’intérêt pour les aspects du paquet associé à l’encre dessinée sur l’objet InkOverlay .
DynamicRendering	Lecture/écriture	Obtient ou définit une valeur qui indique si l’encre est rendue au fur et à mesure qu’elle est dessinée.
EditingMode	Lecture/écriture	Obtient ou définit une valeur qui indique si InkOverlay est en mode encre, en mode suppression ou en mode sélection/édition.
activé	Lecture/écriture	Obtient ou définit une valeur qui spécifie si l’objet InkOverlay collecte l’entrée du stylet.
EraserMode	Lecture/écriture	Obtient ou définit une valeur qui indique si l’entrée manuscrite est effacée par trait ou par point.
EraserWidth	Lecture/écriture	Obtient ou définit une valeur qui spécifie la largeur de l’embout du stylet de gomme.
Poignée	Lecture/écriture	Obtient ou définit le handle de la fenêtre à laquelle l’objet InkOverlay est attaché.
Entrée manuscrite	Lecture/écriture	Obtient ou définit l’objet InkDisp associé à l’objet InkOverlay .
MarginX	Lecture/écriture	Obtient ou définit les marges le long de l’axe X, en pixels.
Marge	Lecture/écriture	Obtient ou définit les marges le long de l’axe y, en pixels.
MouseIcon	Lecture/écriture	Obtient ou définit l’icône de souris personnalisée actuelle.
MousePointer	Lecture/écriture	Obtient ou définit une valeur qui indique le type de pointeur de souris qui apparaît lorsque la souris se trouve sur une partie particulière de l’objet.
Renderer	Lecture/écriture	Obtient ou définit l’objet InkRenderer utilisé pour dessiner de l’encre.
Sélection	Lecture/écriture	Obtient ou définit la collection InkStrokes actuellement sélectionnée à l’intérieur du contrôle InkOverlay .
SupportHighContrastInk	Lecture/écriture	Obtient ou définit une valeur qui spécifie si l’entrée manuscrite est rendue sous forme d’une seule couleur lorsque le système est en mode Contraste élevé.
SupportHighContrastSelectionUI	Lecture/écriture	Obtient ou définit une valeur qui spécifie si toute l’interface utilisateur de sélection est dessinée avec un contraste élevé lorsque le système est en mode Contraste élevé.
Tablette	Lecture seule	Obtient le périphérique de tablette que l’objet InkOverlay utilise actuellement pour collecter l’entrée.

Notes d’implémentation MFC

Si vous avez attaché l’objet InkOverlay à un objet CView, relâchez l’objet InkOverlay en réponse au message WM_DESTROY comme illustré dans l’exemple suivant :

BOOL CRecognitionAlternatesSampleCppView::OnWndMsg(UINT msg, WPARAM wp, PARAM lp, LRESULT *pLR)
{
    if(WM_DESTROY == msg)
        m_spInkOverlay.Release();
    return CView::OnWndMsg(msg, wp, lp, pLR);
}

Notes

Cet objet peut être instancié en appelant la méthode CoCreateInstance en C++.

L’objet InkOverlay est bien adapté pour la prise de notes et le gribouillage de base. L’utilisation principale de cet objet est d’afficher l’entrée manuscrite sous forme d’encre.

En général, l’interface utilisateur au moment de l’exécution de cet objet est une fenêtre transparente avec une entrée manuscrite opaque.

Les événements MouseDown, MouseMove, MouseUp et MouseWheel retournent les coordonnées x et les coordonnées y en pixels, et non les unités HIMETRIC associées à l’espace d’encre. En effet, ces événements remplacent les événements de souris des applications qui ne connaissent pas le stylet et ces applications ne comprennent que les pixels.

Attention

Si vous définissez la propriété AttachMode de l’objet InkOverlay sur InFront, 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 autre thread et que sa propriété AttachMode est définie sur InFront.

Notes

L’objet InkOverlay ne peut pas être libéré en toute sécurité sur un thread autre que l’interface utilisateur.

Pour améliorer les performances de votre application, éliminez votre objet InkOverlay lorsqu’il n’est plus nécessaire.

Si vous avez attaché l’objet InkOverlay à un objet CView, relâchez l’objet InkOverlay en réponse au message WM_DESTROY comme illustré dans l’exemple suivant :

BOOL CRecognitionAlternatesSampleCppView::OnWndMsg(UINT msg, WPARAM wp, PARAM lp, LRESULT *pLR)
{
    if(WM_DESTROY == msg)
        m_spInkOverlay.Release();
    return CView::OnWndMsg(msg, wp, lp, pLR);
}

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablet PC [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
En-tête	Msinkaut.h (nécessite également Msinkaut_i.c)
Bibliothèque	InkObj.dll

Voir aussi

InkCollector, classe

Référence du contrôle InkPicture

Informations de référence sur le contôle InkEdit