Partager via


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

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