Méthode IImePad::Request (imepad.h)

Appelé par un IImePadApplet pour insérer du texte dans une application.

La requête est la seule méthode que IImePadApplet peut appeler. En appelant cette méthode avec l’un des ID de requête IMEPADREQ_* , IImePadApplet peut insérer du texte dans une application et contrôler la chaîne de composition de l’IME dans une application.

Syntaxe

HRESULT Request(
  [in]      IImePadApplet *pIImePadApplet,
  [in]      INT           reqId,
  [in, out] WPARAM        wParam,
  [in, out] LPARAM        lParam
);

Paramètres

[in] pIImePadApplet

Pointeur d’interface de l’applet appelante.

[in] reqId

Type de demande (ID de demande). Cette valeur doit être définie sur l’une des valeurs suivantes :

Valeur Signification
IMEPADREQ_INSERTSTRING
Insérez une chaîne dans l’application en tant que chaîne de composition.
  • wParam : pointeur vers la chaîne terminée par NULL (LPWSTR) à insérer dans l’application.
  • lParam : non utilisé. Doit avoir la valeur 0.
IMEPADREQ_SENDCONTROL
Contrôle la composition de la chaîne et de l’insertion dans l’application.
  • wParam : spécifie la valeur de contrôle (IMEPADCTRL_*) qui demande à IME de traiter la chaîne de composition et la position d’insertion. Consultez Remarques pour obtenir la liste des valeurs IMEPADCTRL_* .
  • lParam : non utilisé. Doit avoir la valeur 0.
IMEPADREQ_SETAPPLETSIZE
Définissez une nouvelle taille de fenêtre d’applet.
  • wParam : LOWORD(wParam) spécifie la largeur de l’applet. HIWORD(wParam) spécifie la hauteur de l’applet
  • lParam : non utilisé. Doit avoir la valeur 0.
IMEPADREQ_GETCOMPOSITIONSTRING
Obtient le texte de la chaîne de composition actuelle.
  • wParam : pointe vers la mémoire tampon (LPWSTR) qui doit recevoir le texte de la chaîne de composition actuelle.
  • lParam : nombre maximal de caractères à copier, y compris le caractère null de fin.
IMEPADREQ_GETCOMPOSITIONSTRINGINFO
Obtient des informations sur la chaîne de composition actuelle.
  • wParam : pointeur vers une structure IMECOMPOSITIONSTRINGINFO qui reçoit les informations de composition.
  • lParam : non utilisé. Doit avoir la valeur 0.
IMEPADREQ_DELETESTRING
Supprimez la chaîne de composition.
  • wParam : LOWORD(wParam) spécifie la position de début de la chaîne de composition à supprimer. HIWORD(wParam) spécifie la longueur de la chaîne de composition à supprimer.
  • lParam : non utilisé. Doit avoir la valeur 0.
IMEPADREQ_CHANGESTRING
Remplacez une partie de la chaîne de composition.
  • wParam : pointeur vers la chaîne de remplacement (LPWSTR).
  • lParam : LOWORD(lParam) spécifie la position de début de la chaîne de composition à remplacer. HIWORD(lParam) spécifie la longueur de la chaîne de composition à remplacer.
IMEPADREQ_GETAPPLHWND
Obtient le handle de fenêtre d’application.
  • wParam : adresse de handle HWND (HWND *) pour recevoir le handle de fenêtre d’application.
  • lParam : non utilisé. Doit avoir la valeur 0.
IMEPADREQ_FORCEIMEPADWINDOWSHOW
Conserve la fenêtre ImePad visible.
  • wParam : TRUE pour que la fenêtre IMEPad reste visible.
  • lParam : non utilisé. Doit avoir la valeur 0.
IMEPADREQ_POSTMODALNOTIFY
Amène IImePad à appeler la méthode Notify de l’applet de manière asynchrone avec un ID de notification spécifique et des données définies par l’utilisateur.
  • wParam : code de notification (IMEPN_*). Consultez les notes relatives à IImePadApplet::Notify pour connaître les codes IMEPN_* possibles.
  • lParam : données définies par l’utilisateur
IMEPADREQ_GETDEFAULTUILANGID
Obtient la langue de l’interface utilisateur de l’applet ImePad recommandée (par défaut).
  • wParam : Adresse de l’ID de langue (LANGID *) pour recevoir la langue d’interface utilisateur par défaut.
  • lParam : non utilisé. Doit avoir la valeur 0.
IMEPADREQ_GETCURRENTUILANG
Obtenez la langue actuelle de l’interface utilisateur de l’applet ImePad.
  • wParam : Adresse de l’ID de langue (LANGID *) pour recevoir la langue de l’interface utilisateur actuelle.
  • lParam : non utilisé. Doit avoir la valeur 0.
IMEPADREQ_GETAPPLETUISTYLE
Obtient le style d’interface utilisateur de l’applet (indicateurs IPAWS_* ).
  • wParam : adresse pour recevoir le style d’interface utilisateur de l’applet (DWORD *). Le style est une combinaison d’indicateurs IPAWS_* ; Consultez Remarques pour connaître les indicateurs IPAWS_* possibles.
  • lParam : non utilisé. Doit avoir la valeur 0.
IMEPADREQ_SETAPPLETUISTYLE
Définit le style d’interface utilisateur de l’applet (indicateurs IPAWS_* ).
  • wParam : style d’interface utilisateur d’applet. Le style est une combinaison d’indicateurs IPAWS_* ; Consultez Remarques pour connaître les indicateurs IPAWS_* possibles.
  • lParam : non utilisé. Doit avoir la valeur 0.
IMEPADREQ_ISAPPLETACTIVE
Détermine si l’applet est active.
  • wParam : adresse pour recevoir la valeur (BOOL *). Si la valeur est TRUE, l’applet est active ; sinon, l’applet n’est pas active.
  • lParam : non utilisé. Doit avoir la valeur 0.
IMEPADREQ_ISIMEPADWINDOWVISIBLE
Détermine si ImePad est visible.
  • wParam : adresse pour recevoir la valeur (BOOL *). Si la valeur est TRUE, ImePad est visible ; sinon, ImePad n’est pas visible.
  • lParam : non utilisé. Doit avoir la valeur 0.
IMEPADREQ_SETAPPLETMINMAXSIZE
Définissez la taille minimale et maximale de l’applet.
  • wParam : LOWORD(wParam) spécifie la largeur de l’applet. HIWORD(wParam) spécifie la hauteur de l’applet.
  • lParam : TRUE définit la taille maximale ; FALSE pour définir la taille minimale.
IMEPADREQ_GETCONVERSIONSTATUS
Obtient le status de conversion de l’IME de l’application actuelle. Pour obtenir la liste complète des modes de conversion et de phrase, consultez le fichier d’en-tête Imm.h.
  • wParam : adresse pour recevoir le mode de conversion (DWORD *).
  • lParam : adresse pour recevoir le mode de phrase (DWORD *).
IMEPADREQ_GETVERSION
Obtient les informations de version d’IImePad.
  • wParam : adresse pour recevoir la version principale (DWORD *).
  • lParam : adresse pour recevoir la version mineure (DWORD *).
IMEPADREQ_GETCURRENTIMEINFO
Obtient les informations IME qui ont appelé ImePad.
  • wParam : adresse pour recevoir l’ID de langue de l’IME (DWORD *).
  • lParam : adresse pour recevoir l’ID d’entrée de l’IME (DWORD *).

[in, out] wParam

Informations supplémentaires spécifiques à reqId.

[in, out] lParam

Informations supplémentaires spécifiques à reqId.

Valeur retournée

S_OK si elle réussit, sinon E_FAIL.

Notes

Valeurs IMEPADCTRL_* possibles

Voici les valeurs possibles que wParam peut prendre lorsque reqId est défini sur IMEPADREQ_SENDCONTROL :
Nom Valeur Description
IMEPADCTRL_CONVERTALL 1 Convertissez toutes les chaînes de composition.
IMEPADCTRL_DETERMINALL 2 Déterminez toutes les chaînes de composition.
IMEPADCTRL_DETERMINCHAR 3 Déterminez le caractère de chaîne de composition du nombre spécifié.
IMEPADCTRL_CLEARALL 4 Effacez toutes les chaînes de composition.
IMEPADCTRL_CARETLEFT 6 Déplacez le caret de caractère vers la gauche.
IMEPADCTRL_CARETRIGHT 7 Déplacez le caret de caractère vers la droite.
IMEPADCTRL_CARETTOP 8 Déplacez le caret de caractère vers le haut de la chaîne de composition.
IMEPADCTRL_CARETBOTTOM 9 Déplacez le caret de caractère vers la fin de la chaîne de composition.
IMEPADCTRL_CARETBACKSPACE 10 Supprimez le caractère de la chaîne de composition avant le caret (comme la touche BACKSPACE).
IMEPADCTRL_CARETDELETE 11 Supprimez le caractère de la chaîne de composition après le caret (comme la touche DELETE).
IMEPADCTRL_PHRASEDELETE 12 Supprimez l’expression de la chaîne de composition.
IMEPADCTRL_INSERTSPACE 13 Insérez un caractère d’espace (pleine largeur ou demi-largeur selon la configuration IME).
IMEPADCTRL_INSERTFULLSPACE 14 Insérez un espace pleine largeur.
IMEPADCTRL_INSERTHALFSPACE 15 Insérer un espace demi-largeur.
IMEPADCTRL_ONIME 16 Définissez IME ACTIVÉ.
IMEPADCTRL_OFFIME 17 Définissez IME DÉSACTIVÉ.
IMEPADCTRL_ONPRECONVERSION 18 Définissez la pré-conversion ACTIVÉ.
IMEPADCTRL_OFFPRECONVERSION 19 Définissez la pré-conversion OFF.
IMEPADCTRL_PHONETICCANDIDATE 20 Ouvrez le candidat de l’IME.
 

Valeurs IPAWS_* possibles

Voici les valeurs possibles qui peuvent être reçues via wParam lorsque reqId est défini sur IMEPADREQ_GETAPPLETUISTYLE, ou que wParam peut être défini sur lorsque reqId est défini sur IMEPADREQ_SETAPPLETUISTYLE :
Name Description
IPAWS_ENABLED Affichez l’applet sous la forme d’une fenêtre activée.
IPAWS_SIZINGNOTIFY Envoyez le code de notification IMEPN_SIZECHANGING ou IMEPN_SIZECHANGED à l’applet.
IPAWS_VERTICALFIXED Fixe verticalement.
IPAWS_HORIZONTALFIXED Fixe horizontalement.
IPAWS_SIZEFIXED La taille est fixe.
IPAWS_MAXWIDTHFIXED La largeur maximale est fixe.
IPAWS_MAXHEIGHTFIXED La hauteur maximale est fixe.
IPAWS_MAXSIZEFIXED La taille maximale est fixe.
IPAWS_MINWIDTHFIXED La largeur minimale est fixe.
IPAWS_MINHEIGHTFIXED La hauteur minimale est fixe.
IPAWS_MINSIZEFIXED La taille minimale est fixe.

Spécifications

   
Plateforme cible Windows
En-tête imepad.h

Voir aussi

IImePad

IImePadApplet

IMECOMPOSITIONSTRINGINFO