Référence du contrôle InkPicture

Le contrôle InkPicture offre la possibilité de placer une image dans une application et permet aux utilisateurs d’ajouter de l’encre par-dessus. Elle est destinée aux scénarios dans lesquels l’encre n’est pas reconnue en tant que texte, mais est stockée en tant qu’entrée manuscrite.

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 les pages HTML ou ASP.NET.

La création du contrôle InkPicture derrière un contrôle transparent (par exemple, une zone de _ groupe avec le _ jeu de propriétés.

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.
Événement CursorButtonDown Se produit lorsque le contrôle InkCollector détecte un objet IInkCursorButton qui est en panne.
Événement CursorButtonUp Se produit lorsque le contrôle InkPicture détecte un IInkCursorButton .
Événement CursorDown Se produit lorsque l’info-bulle de curseur contacte la surface de tablette numérique.
É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.
Double Se produit lors d’un double-clic sur le contrôle InkPicture.
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.
KeyOut, événement [ InkPicture, contrôle] Se produit lorsqu’une touche est enfoncée et en position inférieure alors que le contrôle InkPicture a le focus.
Contrôle InkPicture de l’événement KeyPress [] Se produit lorsqu’une touche est enfoncée alors que le contrôle InkPicture a le focus.
Contrôle d’événement d’événement KeyUp [] Se produit lorsqu’une touche est relâché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.
Contrôle d’événement MouseMove [] Se produit lorsque le pointeur de la souris est déplacé au-dessus du contrôle InkPicture.
Contrôle InkPicture d’événement MouseUp [] 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 alors que le contrôle InkPicture a le focus.
Événement NewInAirPackets Se produit lorsqu’un paquet air est détecté.
Événement NewPackets Se produit lorsque le contrôle InkPicture reçoit un paquet.
Toile Se produit lorsque le contrôle InkPicture s’est correctement redessiné.
Peinture Se produit avant que le contrôle InkPicture ne 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 de l’interface utilisateur, de procédures couper-coller ou de la propriété de sélection .
SelectionChanging Se produit lorsque la sélection de texte dans le contrôle InkPicture va être modifiée, par exemple par le biais de modifications de l’interface utilisateur, de procédures couper-coller ou de la propriété de sélection .
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é de sélection .
Contrôle d’événement 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é de sélection .
SelectionResized Se produit lorsque la taille de la sélection actuelle a été modifiée, par exemple par le biais de modifications de l’interface utilisateur, de procédures couper-coller ou de la propriété de sélection .
SelectionResizing Se produit lorsque la taille de la sélection actuelle va être modifiée, par exemple par le biais de modifications de l’interface utilisateur, de procédures couper-coller ou de la propriété de sélection .
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é ModeAffichage du contrôle InkPicture.
StyleChanged Non implémenté.
Stroke Se produit lorsque l’utilisateur dessine un nouveau trait sur une tablette.
StrokesDeleted Se produit après la suppression des objets IInkStrokeDisp de la propriété Ink .
StrokesDeleting 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
Méthode GetEventInterest Retourne une valeur qui indique si le contrôle InkPicture s’intéresse à un événement particulier.
GetGestureStatus Retourne une valeur qui indique si le contrôle InkPicture présente un intérêt pour un mouvement d’application particulier.
Méthode GetWindowInputRectangle Retourne le rectangle de la fenêtre, en pixels, au sein duquel l’encre est dessinée.
HitTestSelection Retourne un membre de l’énumération SelectionHitResult , qui spécifie la partie d’une sélection qui, le cas échéant, a été atteinte pendant un test de positionnement.
Méthode SetAllTabletsMode Permet au contrôle InkPicture de collecter de l’encre à partir de n’importe quelle tablette attachée au Tablet PC.
Méthode SetEventInterest Définit une valeur qui indique si un contrôle InkPicture présente un intérêt dans un événement spécifié.
SetFocus Déplace le focus vers 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 l’encre à partir d’une seule tablette attachée au Tablet PC. L’encre d’autres tablettes est ignorée.
Méthode SetWindowInputRectangle Spécifie le rectangle de la fenêtre à définir, en 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 « qu’est-ce que c’est » 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 au début ou à l’arrière de l’ordre de plan dans son niveau graphique (au moment de la conception uniquement).
Propriété Description
AutoRedraw, propriété Obtient ou définit une valeur qui spécifie si le contrôle InkPicture est repeint quand la fenêtre est invalidée (si l’objet InkDisp actuellement associé au contrôle InkPicture est redessiné automatiquement lorsque la fenêtre associée à l’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.
Propriété CollectingInk Obtient la valeur qui spécifie si le contrôle InkPicture collecte l’encre (heure de l’exécution uniquement).
CollectionMode Obtient ou définit le mode de collecte qui détermine si l’encre, les gestes ou l’encre et les gestes sont reconnus lorsque l’utilisateur écrit.
Curseurs, 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 à rendre persistante avec l’encre (au moment de la conception 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 (heure de l’exécution uniquement).
Propriété DesiredPacketDescription Obtient ou définit la description du paquet du contrôle InkPicture (heure de l’exécution uniquement).
Propriété DynamicRendering Obtient ou définit la valeur qui spécifie si le contrôle InkPicture affiche dynamiquement l’encre au fur et à mesure de sa collecte.
EditingMode Obtient ou définit une valeur qui spécifie si le contrôle InkPicture est en mode Ink, en mode de suppression ou en mode de sélection/modification.
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é est équivalente à la propriété InkEnabled .

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 de l’info-bulle du stylet de gomme.
hWnd Obtient le handle de fenêtre auquel le contrôle InkPicture est lié. (heure de l’exécution uniquement)
Entrée manuscrite Obtient ou définit l’objet InkDisp associé au contrôle InkPicture (heure de l’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 in-air, curseurs dans les événements de plage, etc.).
Propriété MarginX Obtient ou définit la marge de l’axe x autour du rectangle de la fenêtre en coordonnées d’écran.
MarginY (propriété) Obtient ou définit la marge de l’axe y autour du rectangle de la fenêtre en coordonnées d’écran.
Propriété MouseIcon 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 la souris qui apparaît lorsque la souris se trouve sur une partie particulière du contrôle InkPicture.
Aperçu Obtient le fichier graphique à afficher sur 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 (heure de l’exécution uniquement).
Sélection Obtient la collection InkStrokes actuellement sélectionnée dans le contrôle InkPicture (heure de l’exécution uniquement).
SizeMode Obtient ou définit la manière dont le contrôle gère le placement et le dimensionnement de l’image.
Propriété SupportHighContrastInk Obtient une valeur qui spécifie si l’entrée manuscrite 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 (poignées de sélection et de cadre englobant de sélection) sont dessinées en contraste élevé lorsque le système est en mode contraste élevé.
Propriété de tablette Obtient l’objet IInkTablet actuellement utilisé par le contrôle InkPicture pour collecter l’entrée.

Notes

L’interface utilisateur au moment de l’exécution pour le contrôle InkPicture est une fenêtre avec un arrière-plan opaque (couleur unique, arrière-plan de l’image ou les deux) qui contient l’encre opaque.

vous pouvez utiliser le contrôle InkPicture pour restituer l’encre dans Microsoft Windows 2000, Windows Server 2003, toute édition de Windows xp autre que Windows xp édition Tablet PC 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’encre 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 sous forme de texte si l’écriture manuscrite s’est exécutée sur des ordinateurs exécutant des versions antérieures de Windows tant que des détecteurs 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 l’encre 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 dans toutes les éditions de Windows Vista et XP, ainsi que sur les systèmes sur lesquels seul le kit de développement logiciel (SDK) de Windows XP Tablet PC Edition est installé. les objets InkDisp peuvent uniquement être convertis en texte (reconnu), si Windows Vista ou l’Windows XP édition Tablet PC 2005 est installé.

Si les opérations sur ce contrôle échouent, un HRESULT légal est retourné. Si les conditions d’erreur sont générées, vérifiez le HRESULT retourné par rapport à l’erreur.

Pour plus d’informations sur les contrôles Ink, consultez Ink.

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

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 superposé à un autre contrôle, tel qu’un GroupBox défini sur transparent, l’InkPicture ne collecte pas d’encre. L’InkPicture doit être le contrôle supérieur dans l’ordre de plan ou il doit être un enfant de la zone de zone.

Implémentation COM

Cet objet implémente l’interface com IInkPicture .

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

InkOverlay, classe