Référence du contrôle InkPicture

Le contrôle InkPicture permet de placer une image dans une application et de permettre aux utilisateurs d’ajouter de l’encre par-dessus. 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 sous forme d’encre.

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

Notes

Le contrôle InkPicture n’est pas marqué comme étant sûr pour les 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 la propriété WS_EX_TRANSPARENT définie) empêche InkPicture de collecter l’encre.

Membres

Énumération	Description
InkPictureSizeMode	Définit des valeurs qui spécifient le comportement de l’image d’arrière-plan à l’intérieur du contrôle InkPicture.

Événement	Description
ChangeUICues	Action déconseillée.
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’embout du curseur contacte la surface de numérisation de la tablette.
É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.
Événement de 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 en position bas alors que le contrôle InkPicture a le focus.
Événement KeyPress[Contrôle InkPicture]	Se produit lorsqu’une touche est enfoncée alors que le contrôle InkPicture a le focus.
Événement KeyUp [Contrôle InkPicture]	Se produit lorsqu’une clé est libérée alors 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 relâché.
MouseWheel	Se produit lorsque la roulette de la souris se déplace alors que le contrôle InkPicture a le focus.
Événement NewInAirPackets	Se produit lorsqu’un paquet en l’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 ne redessine lui-même.
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 des modifications de l’interface utilisateur, des procédures de coupe-collage ou de 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 de l’interface utilisateur, de procédures couper-coller ou de la propriété Selection .
SélectionDéplacement	Se produit lorsque la position de la sélection actuelle a changé, par exemple par des modifications de l’interface utilisateur, des procédures de coupe-collage ou de 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 via des modifications de l’interface utilisateur, des procédures de coupe-collage ou de la propriété Selection .
SelectionResized	Se produit lorsque la taille de la sélection actuelle a changé, par exemple par des modifications de l’interface utilisateur, des procédures de coupe-collage ou de la propriété Selection .
SélectionResizing	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 .
SizeChanged	Se produit après le redimensionnement du contrôle InkPicture, en particulier après la modification de la valeur de la propriété Width ou Height .
SizeModeChanged	Se produit après la modification de la propriété SizeMode du contrôle InkPicture.
StyleChanged	Non implémenté.
Course	Se produit lorsque l’utilisateur dessine un nouveau trait sur n’importe quelle tablette.
TraitsDeleted	Se produit après la suppression des objets IInkStrokeDisp de la propriété Ink .
TraitsUppression	Se produit avant la suppression des objets IInkStrokeDisp 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.
Événement TabletRemoved	Se produit lorsqu’une tablette est supprimée du système.

Méthode	Description
GetEventInterest, méthode	Retourne une valeur qui indique si le contrôle InkPicture a de l’intérêt pour un événement particulier.
GetGestureStatus	Retourne une valeur qui indique si le contrôle InkPicture a de l’intérêt pour un mouvement d’application particulier.
GetWindowInputRectangle, méthode	Renvoie 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, qui a été atteinte lors d’un test d’accès.
SetAllTabletsMode, méthode	Permet au contrôle InkPicture de collecter l’encre de n’importe quelle tablette attachée au Tablet PC.
SetEventInterest, méthode	Définit une valeur qui indique si un contrôle InkPicture a de l’intérêt pour un événement spécifié.
SetFocus	Déplace le focus sur le contrôle InkPicture.
SetGestureStatus, méthode	Définit l’intérêt de l’objet InkPicture dans un mouvement d’application spécifié.
SetSingleTabletIntegratedMode, méthode	Définit le contrôle InkPicture pour collecter l’encre d’un seul comprimé attaché au Tablet PC. L’entrée manuscrite d’autres tablettes est ignorée.
SetWindowInputRectangle, méthode	Spécifie le rectangle de fenêtre à définir, en coordonnées de fenêtre, dans lequel 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 de la conception uniquement).
ZOrder	Place le contrôle à l’avant ou à l’arrière de l’ordre z dans son niveau graphique (au moment du design uniquement).

Propriété	Description
AutoRedraw, propriété	Obtient ou définit une valeur qui spécifie si le contrôle InkPicture repeint 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, qui est généralement blanche.
CollectingInk, propriété	Obtient la valeur qui spécifie si le contrôle InkPicture collecte l’encre (durée d’exécution uniquement).
CollectionMode	Obtient ou définit le mode de collection qui détermine si l’entrée manuscrite, les mouvements ou l’entrée manuscrite et les mouvements sont reconnus au fur et à mesure que l’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’encre (au moment du design uniquement).
Propriété DefaultDrawingAttributes	Obtient ou définit la collection InkDrawingAttributes par défaut à utiliser lors du dessin et de l’affichage de l’encre (durée d’exécution uniquement).
DesiredPacketDescription, propriété	Obtient ou définit la description du paquet du contrôle InkPicture (durée d’exécution uniquement).
DynamicRendering, propriété	Obtient ou définit la valeur qui spécifie si le contrôle InkPicture restitue dynamiquement l’encre lors de sa collecte.
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. Note: 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’embout du stylet de gomme.
Hwnd	Obtient le handle de fenêtre auquel le contrôle InkPicture est lié. (durée d’exécution uniquement)
Entrée manuscrite	Obtient ou définit l’objet InkDisp associé au contrôle InkPicture (durée d’exécution uniquement).
InkEnabled	Obtient ou définit une valeur qui spécifie si le contrôle InkPicture collecte l’entrée du stylet (paquets en l’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 dans le contrôle InkPicture.
Renderer, propriété	Obtient ou définit l’objet InkRenderer utilisé pour dessiner de l’encre sur le contrôle InkPicture (durée d’exécution uniquement).
Sélection	Obtient la collection InkStrokes actuellement sélectionnée à l’intérieur du contrôle InkPicture (durée d’exécution uniquement).
SizeMode	Obtient ou définit la façon dont le contrôle gère le placement et le dimensionnement des images.
Propriété SupportHighContrastInk	Obtient une valeur qui spécifie si l’encre est rendue sous la forme d’une 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 l’entrée.

Remarques

L’interface utilisateur au moment de l’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 de l’encre opaque.

Vous pouvez utiliser le contrôle InkPicture pour restituer l’encre dans Microsoft Windows 2000, Windows Server 2003, n’importe quelle édition de Windows XP autre que Windows XP Édition Tablet PC et n’importe quelle version de Windows Vista. Toutefois, vous pouvez entrer de l’entrée manuscrite, 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 Édition Tablet PC 2005 est installé.
• Les gestes peuvent également être reconnus.
• L’écriture manuscrite peut être reconnue en tant que texte si l’écriture manuscrite provient de machines exécutant des versions antérieures de Windows tant que des modules de reconnaissance sont présents.

Si vous utilisez Windows 2000, Windows Server 2003, toute édition de Windows XP autre que Windows XP Édition Tablet PC 2005, vous pouvez affecter des valeurs aux propriétés ambiantes du contrôle InkPicture, puis copier et coller l’entrée manuscrite 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, ainsi que sur les systèmes qui n’ont installé que le Kit de développement logiciel (SDK) Windows XP Édition Tablet PC. Les 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 échouent, un HRESULT légal est retourné. Si des conditions d’erreur se traduisent, case activée 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 être déclenché.

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

Notes

Lorsqu’un contrôle InkPicture est écrasé par un autre contrôle, tel qu’un GroupBox défini sur transparent, l’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 du GroupBox.

Implémentation COM

Cet objet implémente l’interface COM IInkPicture .

Rubriques connexes

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

Classe InkOverlay