Partager via


Référence du contrôle InkPicture

Le contrôle InkPicture permet de placer une image dans une application et permet aux utilisateurs d’ajouter des entrées manuscrites au-dessus de celle-ci. Il est destiné aux scénarios dans lesquels l’entrée manuscrite n’est pas reconnue en tant que texte, mais est plutôt stockée en tant qu’encre.

Le contrôle InkPicture peut être instancié en appelant la méthode CoCreateInstance en C++.

Note

Le contrôle InkPicture n’est pas marqué comme sécurisé pour l’écriture de scripts. Le contrôle InkPicture ne doit pas être utilisé dans des pages HTML ou ASP.NET.

La création du contrôle InkPicture derrière un contrôle transparent (par exemple, un GroupBox avec le jeu de propriétés WS_EX_TRANSPARENT) empêche InkPicture de collecter des entrées manuscrites.

Membres

Énumération Description
InkPictureSizeMode Définit des valeurs qui spécifient le comportement de l’image d’arrière-plan dans le contrôle InkPicture.
Événement Description
ChangeUICues Obsolescent.
Cliquez sur Se produit lorsqu’un utilisateur clique sur le contrôle InkPicture.
'événement CursorButtonDown Se produit lorsque le contrôle InkCollector détecte un objet IInkCursorButton qui est arrêté.
'événement CursorButtonUp Se produit lorsque le contrôle InkPicture détecte un IInkCursorButton qui est en cours.
'événement CursorDown Se produit lorsque l’extrémité du curseur contacte la surface de la tablette de numérisation.
de l’événement CursorInRange Se produit lorsqu’un curseur entre dans la plage de détection physique (proximité) du contexte de la tablette.
'événement CursorOutOfRange Se produit lorsque le curseur quitte la plage de détection physique (proximité) du contexte de la tablette.
DblClick Se produit lorsque le contrôle InkPicture est double-cliqué.
Cette méthode d’événement est définie dans l’interface _IInkPictureEvents. L’interface _IInkPictureEvents implémente l’interface IDispatch avec un identificateur de DISPID_IPEDblClick.
de l’événement mouvement Se produit lorsqu’un mouvement d’application est reconnu.
'événement KeyDown [Contrôle InkPicture] Se produit lorsqu’une touche est enfoncée et à la position vers le bas pendant que le contrôle InkPicture a le focus.
événement KeyPress[InkPicture Control] Se produit lorsqu’une touche est enfoncée pendant que le contrôle InkPicture a le focus.
'événement KeyUp [Contrôle InkPicture] Se produit lorsqu’une clé est libérée pendant que le contrôle InkPicture a le focus.
'événement MouseDown [Contrôle InkPicture] Se produit lorsque le pointeur de la souris se trouve sur le contrôle InkPicture et qu’un bouton de la souris est enfoncé.
MouseEnter Se produit lorsque le pointeur de la souris entre dans le contrôle InkPicture.
MouseHover Se produit lorsque le pointeur de la souris pointe sur le contrôle InkPicture.
MouseLeave Se produit lorsque le pointeur de la souris quitte le contrôle InkPicture.
'événement MouseMove [Contrôle InkPicture] Se produit lorsque le pointeur de la souris est déplacé sur le contrôle InkPicture.
'événement MouseUp [Contrôle InkPicture] Se produit lorsque le pointeur de la souris se trouve sur le contrôle InkPicture et qu’un bouton de souris est libéré.
mouseWheel Se produit lorsque la roulette de la souris se déplace pendant que le contrôle InkPicture a le focus.
NewInAirPackets Event Se produit lorsqu’un paquet en air est visible.
'événement NewPackets Se produit lorsque le contrôle InkPicture reçoit un paquet.
peint Se produit lorsque le contrôle InkPicture a terminé de redessiner lui-même.
peinture Se produit avant que le contrôle InkPicture se redessine.
Redimensionner Se produit lorsque le contrôle InkPicture est redimensionné.
SelectionChanged Se produit lorsque la sélection de texte dans le contrôle InkPicture a changé, par exemple par le biais de modifications apportées à l’interface utilisateur, aux procédures couper-coller ou à la propriété Selection.
SelectionChanging Se produit lorsque la sélection de texte dans le contrôle InkPicture est sur le point de changer, par exemple par le biais de modifications apportées à l’interface utilisateur, aux procédures couper-coller ou à la propriété Selection.
SelectionMoved Se produit lorsque la position de la sélection actuelle a changé, par exemple par le biais de modifications apportées à l’interface utilisateur, aux procédures couper-coller ou à la propriété Selection .
'événement SelectionMoving [Contrôle InkPicture] Se produit lorsque la position de la sélection actuelle est sur le point de changer, par exemple par le biais de modifications apportées à l’interface utilisateur, à des procédures couper-coller ou à la propriété Selection.
SelectionResized Se produit lorsque la taille de la sélection actuelle a changé, par exemple par le biais de modifications apportées à l’interface utilisateur, à des procédures couper-coller ou à 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 apportées à l’interface utilisateur, à des procédures couper-coller ou à la propriété Selection.
SizeChanged Se produit une fois que le contrôle InkPicture a été redimensionné, en particulier après que laWidthou Height valeur de propriété change.
SizeModeChanged Se produit une fois que la propriété SizeMode du contrôle InkPicture a été modifiée.
StyleChanged Non implémenté.
trait Se produit lorsque l’utilisateur dessine un nouveau trait sur n’importe quelle tablette.
StrokesDeleted Se produit après que objets IInkStrokeDisp ont été supprimés de la propriété Ink.
StrokesDeleting Se produit avant que objets IInkStrokeDisp soient supprimés de la propriété Ink.
SystemColorsChanged Se produit après la modification des couleurs système.
SystemGesture Se produit lorsqu’un mouvement système est reconnu.
'événement TabletAdded Se produit lorsqu’une tablette est ajoutée au système.
l’événement TabletRemoved Se produit lorsqu’une tablette est supprimée du système.
Méthode Description
méthode GetEventInterest Retourne une valeur qui indique si le contrôle InkPicture a intérêt dans un événement particulier.
GetGestureStatus Retourne une valeur qui indique si le contrôle InkPicture a intérêt dans un mouvement d’application particulier.
méthode GetWindowInputRectangle Retourne le rectangle de fenêtre, en pixels, dans lequel l’encre est dessinée.
hitTestSelection Retourne un membre de l’énumération SelectionHitResult, qui spécifie la partie d’une sélection, le cas échéant, a été atteinte pendant un test de positionnement.
méthode SetAllTabletsMode Permet au contrôle InkPicture de collecter des entrées manuscrites à partir de n’importe quelle tablette attachée au PC tablette.
méthode SetEventInterest Définit une valeur qui indique si un contrôle InkPicture a intérêt dans un événement spécifié.
SetFocus Déplace le focus sur le contrôle InkPicture.
méthode SetGestureStatus Définit l’intérêt de l’objet InkPicture dans un mouvement d’application spécifié.
méthode SetSingleTabletIntegratedMode Définit le contrôle InkPicture pour collecter des entrées manuscrites à partir d’une seule tablette attachée au PC tablette. L’entrée manuscrite d’autres tablettes est ignorée.
méthode SetWindowInputRectangle Spécifie le rectangle de fenêtre à définir, dans les coordonnées de la fenêtre, dans laquelle l’encre est dessinée.
ShowWhatsThis Affiche une rubrique sélectionnée dans un fichier d’aide à l’aide de la fenêtre contextuelle « What’s This » fournie par l’aide dans les systèmes d’exploitation Microsoft Windows 32 bits (au moment du design uniquement).
ZOrder Place le contrôle à l’avant ou à l’arrière de l’ordre z au sein de son niveau graphique (au moment du design uniquement).
Propriété Description
propriété AutoRedraw Obtient ou définit une valeur qui spécifie si le contrôle InkPicture repaint lorsque la fenêtre est invalidée (si l’objet InkDisp actuellement associé au contrôle InkPicture est automatiquement redessiné lorsque la fenêtre associée à InkPicture reçoit un message WM_PAINT).
BackColor Obtient ou définit la couleur d’arrière-plan du contrôle InkPicture. La couleur d’arrière-plan par défaut est la couleur d’arrière-plan de la fenêtre système, généralement blanche.
collectingInk, propriété Obtient la valeur qui spécifie si le contrôle InkPicture collecte des entrées manuscrites (heure d’exécution uniquement).
CollectionMode Obtient ou définit le mode collection qui détermine si les entrées manuscrites, les mouvements ou les entrées manuscrites sont reconnues en tant qu’utilisateur écrit.
Cursors, propriété Obtient la collection IInkCursors disponible pour une utilisation dans la région manuscrite du contrôle InkPicture.
CustomStrokes Obtient la collection IInkCustomStrokes à conserver avec l’entrée manuscrite (au moment du design uniquement).
DefaultDrawingAttributes, propriété Obtient ou définit la InkDrawingAttributes par défaut collection à utiliser lors du dessin et de l’affichage de l’encre (heure d’exécution uniquement).
DesiredPacketDescription, propriété Obtient ou définit la description du paquet du contrôle InkPicture (heure d’exécution uniquement).
DynamicRendering, propriété Obtient ou définit la valeur qui spécifie si le contrôle InkPicture restitue dynamiquement l’entrée manuscrite telle qu’elle est collectée.
EditingMode Obtient ou définit une valeur qui spécifie si le contrôle InkPicture est en mode encre, en mode suppression ou en mode sélection/édition.
activé Obtient ou définit une valeur qui détermine si le contrôle InkPicture peut répondre aux événements générés par l’utilisateur.
Remarque : Cette propriété équivaut à la propriétéInkEnabled.
EraserMode Obtient ou définit la valeur qui spécifie si l’entrée manuscrite est effacée par trait ou par point.
EraserWidth Obtient ou définit la valeur qui spécifie la largeur de l’extrémité du stylet de gomme.
hWnd Obtient le handle de fenêtre auquel le contrôle InkPicture est lié. (heure d’exécution uniquement)
ink Obtient ou définit l’objet InkDisp associé au contrôle InkPicture (heure d’exécution uniquement).
InkEnabled Obtient ou définit une valeur qui spécifie si le contrôle InkPicture collecte les entrées de stylet (paquets en air, curseur dans les événements de plage, etc.).
MarginX, propriété Obtient ou définit la marge de l’axe x autour du rectangle de fenêtre dans les coordonnées de l’écran.
MarginY, propriété Obtient ou définit la marge de l’axe y autour du rectangle de fenêtre dans les coordonnées de l’écran.
MouseIcon, propriété Obtient ou définit l’icône de souris personnalisée actuelle.
mousePointer, propriété 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 du contrôle InkPicture.
Image Obtient le fichier graphique à afficher sur le contrôle InkPicture.
renderer, propriété Obtient ou définit l’objet InkRenderer utilisé pour dessiner des entrées manuscrites sur le contrôle InkPicture (heure d’exécution uniquement).
sélection Obtient la collection InkStrokes actuellement sélectionnée à l’intérieur du contrôle InkPicture (heure d’exécution uniquement).
SizeMode Obtient ou définit la façon dont le contrôle gère le positionnement et le dimensionnement de l’image.
SupportHighContrastInk, propriété Obtient une valeur qui spécifie si l’entrée manuscrite est rendue en tant que seule couleur, Color = COLOR_WINDOWTEXT (à partir de l’appel GetSystemMetrics) lorsque le système est en mode Contraste élevé.
SupportHighContrastSelectionUI Obtient ou définit une valeur qui spécifie si toutes les interfaces utilisateur de sélection (zone englobante de sélection et poignées de sélection) sont dessinées en contraste élevé lorsque le système est en mode Contraste élevé.
Tablet, propriété Obtient l’objet IInkTablet que le contrôle InkPicture utilise actuellement pour collecter des entrées.

Remarques

L’interface utilisateur d’exécution du contrôle InkPicture est une fenêtre avec un arrière-plan opaque (couleur unique, arrière-plan d’image ou les deux) qui contient des entrées manuscrites opaques.

Vous pouvez utiliser le contrôle InkPicture pour afficher des entrées manuscrites dans Microsoft Windows 2000, Windows Server 2003, toute édition de Windows XP autre que Windows XP Tablet PC Edition et toute version de Windows Vista. Toutefois, vous pouvez entrer des entrées manuscrites, accepter des mouvements ou reconnaître l’écriture manuscrite uniquement dans les conditions suivantes :

  • L’entrée manuscrite peut être entrée et reconnue si Windows Vista ou XP Tablet PC Edition 2005 est installé.
  • Les mouvements peuvent également être reconnus.
  • L’écriture manuscrite peut être reconnue en tant que texte si l’écriture manuscrite provient des machines exécutant des versions antérieures de Windows tant que les modules de reconnaissance sont présents.

Si vous utilisez Windows 2000, Windows Server 2003, toute édition de Windows XP autre que Windows XP Tablet PC Edition 2005, vous pouvez affecter des valeurs aux propriétés ambiantes du contrôle InkPicture, puis copier et coller des entrées manuscrites dans d’autres applications. Toutefois, la valeur de sa propriété InkEnabled sera toujours FALSE.

Les objets InkDisp persistants peuvent être chargés et affichés sur toutes les éditions de Windows Vista et XP et sur les systèmes qui ont uniquement le Kit de développement logiciel Windows XP Tablet PC Edition (SDK) installé. Objets InkDisp ne peuvent être convertis en texte (reconnu) que si Windows Vista ou Windows XP Tablet PC Edition 2005 est installé.

Si les opérations sur ce contrôle ne réussissent pas, un HRESULT légal est retourné. Si des conditions d’erreur se traduisent, vérifiez le HRESULT retourné par rapport à l’erreur.

Pour plus d’informations sur les contrôles d’entrée manuscrite, consultez Ink .

Pour plus d’informations sur les threads qui déclenchent des événements particuliers, consultez Threads sur lesquels un événement peut déclencher.

Pour améliorer les performances de votre application, supprimez manuellement un contrôle InkPicture lorsqu’il n’est plus nécessaire.

Note

Lorsqu’un contrôle InkPicture est retardé avec un autre contrôle, tel qu’un GroupBox défini sur transparent, inkPicture ne collecte pas d’encre. InkPicture doit être le contrôle le plus haut dans l’ordre Z ou il doit être un enfant de l'GroupBox.

Implémentation COM

Cet objet implémente l’interface COM IInkPicture.

référence de contrôle InkEdit

classe InkOverlay