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 dessus. Il est destiné aux scénarios dans lesquels l’encre n’est pas reconnue comme du 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++.
Notes
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 | Action déconseillée. |
| Cliquez sur | Se produit lorsqu’un utilisateur clique sur le contrôle InkPicture. |
| CursorButtonDown, événement | Se produit lorsque le contrôle InkCollector détecte un objet IInkCursorButton qui est arrêté. |
| CursorButtonUp, événement | Se produit lorsque le contrôle InkPicture détecte un IInkCursorButton qui est en cours. |
| CursorDown, événement | Se produit lorsque l’info-bulle du curseur contacte la surface de la tablette de numérisation. |
| CursorInRange, événement | Se produit lorsqu’un curseur entre dans la plage de détection physique (proximité) du contexte de tablette. |
| CursorOutOfRange, événement | Se produit lorsque le curseur quitte la plage de détection physique (proximité) du contexte de 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 à la position vers le bas pendant que le contrôle InkPicture a le focus. |
| Événement KeyPress[Contrôle InkPicture] | 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 alors que le contrôle InkPicture a le focus. |
| MouseDown Event [InkPicture Control] | 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. |
| MouseUp Event [InkPicture Control] | Se produit lorsque le pointeur de la souris se trouve sur le contrôle InkPicture et qu’un bouton de la souris est relâché. |
| MouseWheel | Se produit lorsque la roulette de la souris se déplace pendant que le contrôle InkPicture a le focus. |
| NewInAirPackets, événement | Se produit lorsqu’un paquet en air est visible. |
| NewPackets, événement | 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 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 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 . |
| SelectionMoving Event [InkPicture Control] | 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, aux 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, aux 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, aux procédures couper-coller ou à 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 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. |
| StrokesDeleted | Se produit une fois que les objets IInkStrokeDisp ont été supprimés de la propriété Ink . |
| StrokesDeleting | Se produit avant que les 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. |
| TabletAdded, événement | Se produit lorsqu’une tablette est ajoutée au système. |
| TabletRemoved, événement | 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 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. |
| GetWindowInputRectangle, méthode | 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 quelle partie d’une sélection, le cas échéant, a été atteinte lors d’un test d’accès. |
| SetAllTabletsMode, méthode | Permet au contrôle InkPicture de collecter l’encre à partir de n’importe quelle tablette attachée au PC Tablette. |
| SetEventInterest, méthode | 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. |
| 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 à partir d’une seule tablette attachée au PC Tablette. L’encre provenant d’autres tablettes est ignorée. |
| SetWindowInputRectangle, méthode | Spécifie le rectangle de fenêtre à définir, dans les coordonnées de la fenêtre, dans lesquelles l’encre est dessinée. |
| ShowWhatsThis | Affiche une rubrique sélectionnée dans un fichier d’aide à l’aide de la fenêtre contextuelle « Présentation » fournie par l’aide dans les systèmes d’exploitation Microsoft Windows 32 bits (temps de conception uniquement). |
| ZOrder | Place le contrôle à l’avant ou à l’arrière de l’ordre z dans son niveau graphique (temps de conception uniquement). |
| Propriété | Description |
|---|---|
| AutoRedraw, propriété | 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 redéployé 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 les entrées manuscrites, les mouvements ou les mouvements sont reconnus comme l’utilisateur écrit. |
| Cursors, propriété | Obtient la collection IInkCursors disponible pour une utilisation dans la région d’entrée manuscrite du contrôle InkPicture. |
| CustomStrokes | Obtient la collection IInkCustomStrokes à conserver avec l’encre (au moment du design uniquement). |
| DefaultDrawingAttributes, propriété | Obtient ou définit la collection InkDrawingAttributes par défaut à 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 affiche dynamiquement l’encre à mesure 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] |
| EraserMode | Obtient ou définit la valeur qui spécifie si l’encre est effacée par trait ou par point. |
| EraserWidth | Obtient ou définit la valeur qui spécifie la largeur 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 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 s’affiche 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 l’encre sur le contrôle InkPicture (durée d’exécution uniquement). |
| Sélection | Obtient la collection InkStrokes actuellement sélectionnée dans le contrôle InkPicture (heure d’exécution uniquement). |
| SizeMode | Obtient ou définit la façon dont le contrôle gère le placement et le dimensionnement de l’image. |
| SupportHighContrastInk, propriété | Obtient une valeur qui spécifie si l’encre est rendue comme 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 d’exécution du contrôle InkPicture est une fenêtre avec un arrière-plan opaque (couleur unique, arrière-plan image ou les deux) qui contient de l’encre opaque.
Vous pouvez utiliser le contrôle InkPicture pour afficher l’encre dans Microsoft Windows 2000, Windows Server 2003, n’importe quelle édition de Windows XP autre que Windows XP Tablet PC Edition et toute version de Windows Vista. Toutefois, vous pouvez entrer de l’encre, 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 gestes peuvent également être reconnus.
- L’écriture manuscrite peut être reconnue comme du texte si l’écriture manuscrite provient des machines exécutant des versions antérieures de Windows tant que les reconnaissances sont présentes.
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 de l’encre dans d’autres applications. Toutefois, la valeur de sa propriété InkEnabled est 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 n’ont que les Windows XP Tablet PC Edition Software Development Kit (SDK) installés. Les objets InkDisp peuvent uniquement être convertis en texte (reconnus), si Windows Vista ou le 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 le résultat des conditions d’erreur se produit, vérifiez le HRESULT retourné par rapport à l’erreur.
Pour plus d’informations sur les contrôles manuscrits, 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 retardé avec 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 doit être un enfant de GroupBox.
Implémentation COM
Cet objet implémente l’interface COM IInkPicture .