Messages InkEdit (Win32 uniquement)

  • Article

Le contrôle InkEdit est une super classe du contrôle RichEdit . Chaque message RichEdit est transmis directement dans la plupart des cas et a exactement le même effet que dans RichEdit. Cela s’applique également aux messages de notification d’événement.

Pour envoyer ces messages, appelez la fonction SendMessage avec les paramètres suivants :

C++ 
LRESULT SendMessage(  HWND hWnd,      // handle to destination window  UINT Msg,       // message  WPARAM wParam,  // first message parameter  LPARAM lParam   // second message parameter);

Message

La fenêtre parente du contrôle InkEdit reçoit des messages de notification d’événement via le message WM_NOTIFY :

LRESULT CALLBACK WindowProc(
    HWND hWnd,                // handle to window
    UINT uMsg,                // WM_NOTIFY
    WPARAM wParam,        // InkEdit control identifier
    LPARAM lParam            // see documentation for notification messages
);
Obtenir/définir le message Description
EM_GETINKMODE
 Obtient le mode d’entrée manuscrite du contrôle InkEdit .
Paramètres :
Ce message n’a aucun paramètre ; wParam et lParam doivent être 0.
Valeurs de retour :
Ce message retourne l’une des valeurs définies dans l’énumération InkMode , qui spécifie si la collection d’encre est désactivée, si l’encre est collectée ou si l’entrée manuscrite et les mouvements sont collectés.
EM_SETINKMODE
 Définit le mode d’entrée manuscrite du contrôle InkEdit .
Paramètres :
Wparam Spécifie l’une des valeurs de l’énumération InkMode , qui spécifie si la collection d’encre est désactivée, si l’encre est collectée ou si l’encre et les mouvements sont collectés.
Lparam Ce paramètre n’est pas utilisé ; il doit être 0.
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou de zéro en cas d’erreur.
Remarques :
Il ne doit être utilisé que si le EM_GETSTATUS retourne IES_Idle.
EM_GETINKINSERTMODE
 Obtient le mode d’insertion manuscrite du contrôle InkEdit .
Paramètres :
Ce message n’a aucun paramètre ; wParam et lParam doivent être 0.
Valeurs de retour :
Ce message retourne l’une des valeurs de l’énumération InkInsertMode , qui spécifie si l’encre est insérée dans le contrôle sous forme de texte ou d’entrée manuscrite.
EM_SETINKINSERTMODE
 Définit le mode d’insertion manuscrite du contrôle InkEdit . L’envoi de ce message n’a aucun effet s’il est utilisé avec un système d’exploitation autre que Microsoft Windows XP Édition Tablet PC.
Paramètres :
Wparam Spécifie l’une des valeurs de l’énumération InkInsertMode , qui spécifie si l’encre est insérée dans le contrôle sous forme de texte ou d’entrée manuscrite.
Lparam Ce paramètre n’est pas utilisé ; il doit être 0.
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou de zéro en cas d’erreur.
EM_GETDRAWATTR
 Obtient les attributs de dessin actuels du contrôle InkEdit .
Paramètres :
Wparam Ce paramètre n’est pas utilisé ; il doit être 0.
Lparam Spécifie un pointeur (IInkDrawingAttributes **pDrawAttr) pour recevoir l’objet InkDrawingAttributes actuel.
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou de zéro en cas d’erreur.
EM_SETDRAWATTR
 Définit les attributs de dessin à utiliser pour la collection d’encre future.
Paramètres :
Wparam Ce paramètre n’est pas utilisé ; il doit être 0.
Lparam Spécifie un pointeur (IInkDrawingAttributes *pDrawAttr) vers un objet InkDrawingAttributes .
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou de zéro en cas d’erreur.
EM_GETRECOTIMEOUT
 Obtient le délai d’expiration de la reconnaissance, en millisecondes, pour le contrôle InkEdit .
Paramètres :
Ce message n’a aucun paramètre ; wParam et lParam doivent être 0.
Valeurs de retour :
Ce message retourne le délai d’expiration de la reconnaissance, en millisecondes.
EM_SETRECOTIMEOUT
 Définit le délai d’expiration de la reconnaissance, en millisecondes, pour le contrôle InkEdit .
Paramètres :
Wparam Spécifie le délai d’expiration de la reconnaissance, en millisecondes.
Lparam Ce paramètre n’est pas utilisé ; il doit être 0.
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou de zéro en cas d’erreur.
EM_GETGESTURESTATUS
 Obtient le status de mouvement pour le contrôle InkEdit.
Paramètres :
Wparam Spécifie le type de mouvement, tel que défini dans l’énumération InkApplicationGesture .
Lparam Ce paramètre n’est pas utilisé ; il doit être 0.
Valeurs de retour :
Ce message retourne TRUE si le contrôle InkEdit s’abonne au mouvement ou FALSE si le contrôle InkEdit ne s’abonne pas au mouvement.
EM_SETGESTURESTATUS
 Définit le status de mouvement pour le contrôle InkEdit.
Paramètres :
Wparam Spécifie le type de mouvement, tel que défini dans l’énumération InkApplicationGesture .
Lparam Spécifie TRUE si l’abonnement au mouvement est activé ou FALSE si l’écoute du mouvement n’est pas activée.
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou de zéro en cas d’erreur.
Remarques :
Il ne doit être utilisé que si le EM_GETSTATUS retourne IES_Idle.
EM_GETRECOGNIZER
 Obtient le module de reconnaissance utilisé par le contrôle InkEdit .
Paramètres :
Wparam Ce paramètre n’est pas utilisé ; il doit être 0.
Lparam Spécifie un pointeur vers un IInkRecognizer* pour recevoir l’objet IInkRecognizer utilisé par le contrôle InkEdit .
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou de zéro en cas d’erreur.
EM_SETRECOGNIZER
 Définit le module de reconnaissance utilisé par le contrôle InkEdit . Si un Factoid est utilisé pour le contrôle InkEdit, il doit être réapplicé après l’envoi de ce message.
Paramètres :
Wparam Ce paramètre n’est pas utilisé ; il doit être 0.
Lparam Spécifie un pointeur vers un IInkRecognizer* pour définir l’objet IInkRecognizer que le contrôle InkEdit utilise pour une utilisation ultérieure.
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou de zéro en cas d’erreur.
Remarques :
Il ne doit être utilisé que si le EM_GETSTATUS retourne IES_Idle.
EM_GETFACTOID
 Obtient le factoid à utiliser pour la reconnaissance.
Paramètres :
Wparam Ce paramètre n’est pas utilisé ; il doit être 0.
Lparam Spécifie un pointeur vers un BSTR pour recevoir la chaîne factoid.
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou différent de zéro si une erreur se produit.
EM_SETFACTOID
 Définit le Factoid à utiliser pour la reconnaissance.
Paramètres :
Wparam Ce paramètre n’est pas utilisé ; il doit être 0.
Lparam Spécifie le BSTR qui contient la chaîne factoid.
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou différent de zéro si une erreur se produit.
Remarques :
Il ne doit être utilisé que si le EM_GETSTATUS retourne IES_Idle.
EM_GETSELINK
 Obtient l’entrée manuscrite dans la sélection. L’entrée manuscrite doit être reconnue avant d’être accessible via ce message. S’il n’est pas reconnu en premier, EM_GETSELINK retourne toujours zéro objet InkDisp .
Paramètres :
Wparam Ce paramètre n’est pas utilisé ; il doit être 0.
Lparam Spécifie un pointeur vers un VARIANT pour recevoir un tableau sécurisé pour recevoir des objets InkDisp dans la sélection actuelle.
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou différent de zéro si une erreur se produit.
EM_SETSELINK
 Définit l’entrée manuscrite dans la sélection. L’envoi de ce message n’a aucun effet s’il est utilisé avec un système d’exploitation autre que Windows XP Édition Tablet PC.
Paramètres :
Wparam Ce paramètre n’est pas utilisé ; il doit être 0.
Lparam Spécifie un pointeur vers un VARIANT avec un tableau sécurisé d’objets InkDisp pour remplacer la sélection actuelle.
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou différent de zéro si une erreur se produit.
EM_GETSELINKDISPLAYMODE
 Retourne l’apparence actuelle de l’encre dans la plage sélectionnée à l’aide de l’une des valeurs de l’énumération InkDisplayMode .
Paramètres :
Ce message n’a aucun paramètre ; wParam et lParam doivent avoir la valeur 0.
Valeurs de retour :
Ce message retourne l’une des valeurs de l’énumération InkDisplayMode (IDM_Text ou IDM_Ink), qui spécifie comment une sélection apparaît sur le contrôle.
EM_SETSELINKDISPLAYMODE
 Définit l’apparence de l’encre dans la plage sélectionnée à l’aide de l’une des valeurs de l’énumération InkDisplayMode .
Paramètres :
Wparam Ce paramètre n’est pas utilisé ; il doit être 0.
Lparam Spécifie le mode d’affichage de l’entrée manuscrite dans la plage sélectionnée, comme défini dans l’énumération InkDisplayMode .
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou différent de zéro si une erreur se produit. L’envoi de ce message n’a aucun effet s’il est utilisé avec un système d’exploitation autre que Windows XP Édition Tablet PC.
EM_GETSTATUS
 Obtient le status du contrôle InkEdit.
Paramètres :
Ce message n’a aucun paramètre ; wParam et lParam doivent avoir la valeur 0.
Valeurs de retour :
Ce message retourne l’une des valeurs de l’énumération InkEditStatus , qui spécifie si le contrôle est inactif, collecte d’encre ou reconnaissance de l’entrée manuscrite.
EM_RECOGNIZE
 Force la reconnaissance.
Paramètres :
Ce message n’a aucun paramètre ; wParam et lParam doivent avoir la valeur 0.
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou différent de zéro si une erreur se produit.
EM_GETMOUSEICON
 Obtient l’icône de la souris.
Paramètres :
Wparam Ce paramètre n’est pas utilisé ; il doit être 0.
Lparam Spécifie un pointeur HICON* qui est rempli avec le HICON MouseIcon actuel. Il peut s’agir d’une valeur HICON ou NULL .
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou différent de zéro si une erreur se produit.
EM_SETMOUSEICON
 Définit l’icône de la souris.
Paramètres :
Wparam Spécifie une valeur BOOLEAN définie sur TRUE si le contrôle InkEdit doit posséder le handle HICON ou FALSE si le contrôle InkEdit ne doit pas posséder le handle HICON. Si le contrôle InkEdit est propriétaire du HICON, il prend en charge et détruit le HICON de manière appropriée. Sinon, l’appelant est propriétaire du HICON et est responsable de sa suppression.
Lparam Spécifie la nouvelle valeur HICON. Utilisez NULL pour effacer la valeur. La valeur par défaut est NULL.
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou différent de zéro si une erreur se produit.
EM_GETMOUSEPOINTER
 Obtient le pointeur de la souris.
Paramètres :
Wparam Ce paramètre n’est pas utilisé ; il doit être 0.
Lparam Contient un pointeur InkMousePointer* rempli avec la valeur MousePointer actuelle. Cela se comporte comme la propriété InkCollector::get_MousePointer .
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou différent de zéro si une erreur se produit.
EM_SETMOUSEPOINTER
 Définit le pointeur de la souris.
Paramètres :
Wparam Ce paramètre n’est pas utilisé ; il doit être 0.
Lparam Contient la nouvelle valeur MousePointer , qui est définie dans l’énumération InkMousePointer . Cela se comporte comme la propriété InkCollector::p ut_MousePointer .
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou différent de zéro si une erreur se produit.
EM_GETUSEMOUSEFORINPUT
 Obtient l’état indiquant si l’entrée de la souris est traitée comme une entrée de stylet.
Paramètres :
Ce message n’a aucun paramètre ; wParam et lParam doivent avoir la valeur 0.
Valeurs de retour :
Ce message retourne 0 si FALSE ou 1 si TRUE.
EM_SETUSEMOUSEFORINPUT
 Définit l’état indiquant si l’entrée de la souris est traitée comme une entrée de stylet.
Paramètres :
Wparam Spécifie une valeur booléenne qui détermine s’il faut traiter l’entrée de la souris comme entrée de stylet.
Lparam Ce paramètre n’est pas utilisé ; il doit être 0.
Valeurs de retour :
Ce message retourne 0 en cas de réussite ou de zéro en cas d’erreur.
Remarques :
Il ne doit être utilisé que si le EM_GETSTATUS retourne IES_Idle.
Message de notification d’événement Description
IECN_STROKE
 Avertit la fenêtre parente du contrôle InkEdit qu’un IInkStrokeDisp a été créé. Celui-ci est envoyé dans un message WM_NOTIFY avec les paramètres suivants.
Paramètres :
Wparam Spécifie l’identificateur du contrôle qui a envoyé le message.
Lparam Spécifie un pointeur vers la structure IEC_STROKEINFO .
Valeurs de retour :
Le client retourne 0 pour accepter le trait et 1 pour annuler le trait.
IECN_GESTURE
 Avertit la fenêtre parente du contrôle InkEdit qu’un mouvement a été reconnu. Celui-ci est envoyé dans un message WM_NOTIFY avec les paramètres suivants.
Paramètres :
Wparam Spécifie l’identificateur du contrôle qui a envoyé le message.
Lparam Spécifie un pointeur vers la structure IEC_GESTUREINFO .
Valeurs de retour :
Le client retourne 0 pour accepter le mouvement et 1 pour annuler le mouvement.
IECN_RECOGNITIONRESULT
 Avertit la fenêtre parente du contrôle InkEdit que la reconnaissance s’est produite. Celui-ci est envoyé dans un message WM_NOTIFY avec les paramètres suivants.
Paramètres :
Wparam Spécifie l’identificateur du contrôle qui a envoyé le message.
Lparam Spécifie un pointeur vers la structure IEC_RECOGNITIONRESULTINFO .
Valeurs de retour :
Le client retourne 0 s’il traite le message.

S'applique à

structure IEC_GESTUREINFO (Win32 uniquement)

structure IEC_STROKEINFO (Win32 uniquement)

structure IEC_RECOGNITIONRESULTINFO (Win32 uniquement)

MousePointer, propriété

InkEditStatus, énumération

InkInsertMode, énumération

Énumération InkMode

IInkCursor, interface

InkDrawingAttributes, classe

IInkRecognitionResult, interface

IInkRecognizer Interface

Classe InkDisp

IInkGesture, interface