Compartir a través de

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

  • Artículo

Lo llama un IImePadApplet para insertar texto en una aplicación.

Request es el único método al que puede llamar IImePadApplet . Al llamar a este método con uno de los identificadores de solicitud de IMEPADREQ_* , IImePadApplet puede insertar texto en una aplicación y controlar la cadena de composición de IME en una aplicación.

Sintaxis

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

Parámetros

[in] pIImePadApplet

Puntero de interfaz del applet que llama.

[in] reqId

Tipo de solicitud (identificador de solicitud). Debe establecerse en uno de los valores siguientes:

Valor Significado
IMEPADREQ_INSERTSTRING
 Inserte una cadena en la aplicación como una cadena de composición.
  • wParam: puntero a la cadena terminada en NULL (LPWSTR) que se va a insertar en la aplicación.
  • lParam: no se usa. Se debe establecer en 0.
IMEPADREQ_SENDCONTROL
 Controla la composición de la cadena y el símbolo de intercalación en la aplicación.
  • wParam: especifica el valor de control (IMEPADCTRL_*) que solicita a IME que procese la cadena de composición y la posición del símbolo de intercalación. Vea Comentarios para obtener una lista de los valores de IMEPADCTRL_* .
  • lParam: no se usa. Se debe establecer en 0.
IMEPADREQ_SETAPPLETSIZE
 Establezca un nuevo tamaño de ventana de applet.
  • wParam: LOWORD(wParam) especifica el ancho del applet. HIWORD(wParam) especifica el alto del applet
  • lParam: no se usa. Se debe establecer en 0.
IMEPADREQ_GETCOMPOSITIONSTRING
 Obtiene el texto de la cadena de composición actual.
  • wParam: apunta al búfer (LPWSTR) que va a recibir el texto de la cadena de composición actual.
  • lParam: el número máximo de caracteres que se van a copiar, incluido el carácter nulo de terminación.
IMEPADREQ_GETCOMPOSITIONSTRINGINFO
 Obtiene información sobre la cadena de composición actual.
  • wParam: puntero a una estructura IMECOMPOSITIONSTRINGINFO que recibe la información de composición.
  • lParam: no se usa. Se debe establecer en 0.
IMEPADREQ_DELETESTRING
 Elimine la cadena de composición.
  • wParam: LOWORD(wParam) especifica la posición inicial de la cadena de composición que se va a eliminar. HIWORD(wParam) especifica la longitud de la cadena de composición que se va a eliminar.
  • lParam: no se usa. Se debe establecer en 0.
IMEPADREQ_CHANGESTRING
 Reemplace parte de la cadena de composición.
  • wParam: puntero a la cadena de reemplazo (LPWSTR).
  • lParam: LOWORD(lParam) especifica la posición inicial de la cadena de composición que se va a reemplazar. HIWORD(lParam) especifica la longitud de la cadena de composición que se va a reemplazar.
IMEPADREQ_GETAPPLHWND
 Obtiene el identificador de la ventana de la aplicación.
  • wParam: la dirección del controlador HWND (HWND *) para recibir el identificador de la ventana de la aplicación.
  • lParam: no se usa. Se debe establecer en 0.
IMEPADREQ_FORCEIMEPADWINDOWSHOW
 Mantiene visible la ventana del ImePad.
  • wParam: TRUE para mantener visible la ventana del IMEPad.
  • lParam: no se usa. Se debe establecer en 0.
IMEPADREQ_POSTMODALNOTIFY
 Hace que IImePad llame al método Notify del applet de forma asincrónica con un identificador de notificación específico y datos definidos por el usuario.
  • wParam: el código de notificación (IMEPN_*). Consulte los comentarios de IImePadApplet::Notify para conocer los posibles códigos IMEPN_* .
  • lParam: datos definidos por el usuario
IMEPADREQ_GETDEFAULTUILANGID
 Obtiene el lenguaje de interfaz de usuario de applet de ImePad recomendado (valor predeterminado).
  • wParam: dirección del identificador de idioma (LANGID *) para recibir el idioma predeterminado de la interfaz de usuario.
  • lParam: no se usa. Se debe establecer en 0.
IMEPADREQ_GETCURRENTUILANG
 Obtenga el lenguaje actual de la interfaz de usuario de applet de ImePad.
  • wParam: dirección del identificador de idioma (LANGID *) para recibir el idioma actual de la interfaz de usuario.
  • lParam: no se usa. Se debe establecer en 0.
IMEPADREQ_GETAPPLETUISTYLE
 Obtiene el estilo de la interfaz de usuario del applet (marcas IPAWS_* ).
  • wParam: dirección para recibir el estilo de interfaz de usuario de applet (DWORD *). El estilo es una combinación de marcas IPAWS_* ; vea Comentarios para ver las posibles marcas de IPAWS_* .
  • lParam: no se usa. Se debe establecer en 0.
IMEPADREQ_SETAPPLETUISTYLE
 Establece el estilo de la interfaz de usuario del applet (marcas IPAWS_* ).
  • wParam: estilo de interfaz de usuario de Applet. El estilo es una combinación de marcas IPAWS_* ; vea Comentarios para ver las posibles marcas de IPAWS_* .
  • lParam: no se usa. Se debe establecer en 0.
IMEPADREQ_ISAPPLETACTIVE
 Determina si el applet está activo.
  • wParam: dirección para recibir el valor (BOOL *). Si es TRUE, el applet está activo; de lo contrario, el applet no está activo.
  • lParam: no se usa. Se debe establecer en 0.
IMEPADREQ_ISIMEPADWINDOWVISIBLE
 Determina si ImePad está visible.
  • wParam: dirección para recibir el valor (BOOL *). Si es TRUE, ImePad es visible; de lo contrario, ImePad no está visible.
  • lParam: no se usa. Se debe establecer en 0.
IMEPADREQ_SETAPPLETMINMAXSIZE
 Establezca el tamaño mínimo y máximo del applet.
  • wParam: LOWORD(wParam) especifica el ancho del applet. HIWORD(wParam) especifica el alto del applet.
  • lParam: TRUE establece el tamaño máximo; FALSE para establecer el tamaño mínimo.
IMEPADREQ_GETCONVERSIONSTATUS
 Obtiene el estado de conversión del IME de la aplicación actual. Para obtener una lista completa de los modos de conversión y oración, vea el archivo de encabezado Imm.h.
  • wParam: dirección para recibir el modo de conversión (DWORD *).
  • lParam: dirección para recibir el modo de oración (DWORD *).
IMEPADREQ_GETVERSION
 Obtiene la información de la versión de IImePad.
  • wParam: dirección para recibir la versión principal (DWORD *).
  • lParam: dirección para recibir la versión secundaria (DWORD *).
IMEPADREQ_GETCURRENTIMEINFO
 Obtiene la información de IME que invocó el ImePad.
  • wParam: dirección para recibir el identificador de idioma del IME (DWORD *).
  • lParam: dirección para recibir el identificador de entrada del IME (DWORD *).

[in, out] wParam

Información adicional específica de reqId.

[in, out] lParam

Información adicional específica de reqId.

Valor devuelto

S_OK si se ejecuta correctamente; de lo contrario, E_FAIL.

Comentarios

Valores posibles IMEPADCTRL_*

Estos son los valores posibles que wParam puede tomar cuando reqId está establecido en IMEPADREQ_SENDCONTROL:
Nombre Valor Descripción
IMEPADCTRL_CONVERTALL 1 Convierta todas las cadenas de composición.
IMEPADCTRL_DETERMINALL 2 Determine todas las cadenas de composición.
IMEPADCTRL_DETERMINCHAR 3 Determine el carácter de cadena de composición del recuento especificado.
IMEPADCTRL_CLEARALL 4 Borre todas las cadenas de composición.
IMEPADCTRL_CARETLEFT 6 Mueva el símbolo de intercalación de caracteres a la izquierda.
IMEPADCTRL_CARETRIGHT 7 Mueva el símbolo de intercalación de caracteres a la derecha.
IMEPADCTRL_CARETTOP 8 Mueva el símbolo de intercalación de caracteres a la parte superior de la cadena de composición.
IMEPADCTRL_CARETBOTTOM 9 Mueva el símbolo de intercalación de caracteres al final de la cadena de composición.
IMEPADCTRL_CARETBACKSPACE 10 Elimine el carácter de la cadena de composición antes del símbolo de intercalación (como la tecla BACKSPACE).
IMEPADCTRL_CARETDELETE 11 Elimine el carácter de la cadena de composición después del símbolo de intercalación (como la tecla DELETE).
IMEPADCTRL_PHRASEDELETE 12 Elimine la frase de la cadena de composición.
IMEPADCTRL_INSERTSPACE 13 Inserte un carácter de espacio: ancho completo o ancho medio en función de la configuración de IME.
IMEPADCTRL_INSERTFULLSPACE 14 Insertar espacio de ancho completo.
IMEPADCTRL_INSERTHALFSPACE 15 Insertar espacio de ancho medio.
IMEPADCTRL_ONIME 16 Establezca IME ON.
IMEPADCTRL_OFFIME 17 Establezca IME OFF.
IMEPADCTRL_ONPRECONVERSION 18 Establezca on previo a la conversión.
IMEPADCTRL_OFFPRECONVERSION 19 Establezca off de conversión previa.
IMEPADCTRL_PHONETICCANDIDATE 20 Abra el candidato de IME.
 

Posibles valores de IPAWS_*

Estos son los valores posibles que se pueden recibir a través de wParam cuando reqId está establecido en IMEPADREQ_GETAPPLETUISTYLE, o que wParam se puede establecer en cuando reqId se establece en IMEPADREQ_SETAPPLETUISTYLE:
Nombre Descripción
IPAWS_ENABLED Muestra el applet como una ventana habilitada.
IPAWS_SIZINGNOTIFY Envíe el IMEPN_SIZECHANGING o IMEPN_SIZECHANGED notifique el código al applet.
IPAWS_VERTICALFIXED Se ha corregido verticalmente.
IPAWS_HORIZONTALFIXED Se ha corregido horizontalmente.
IPAWS_SIZEFIXED El tamaño es fijo.
IPAWS_MAXWIDTHFIXED El ancho máximo es fijo.
IPAWS_MAXHEIGHTFIXED El alto máximo es fijo.
IPAWS_MAXSIZEFIXED El tamaño máximo es fijo.
IPAWS_MINWIDTHFIXED El ancho mínimo es fijo.
IPAWS_MINHEIGHTFIXED El alto mínimo es fijo.
IPAWS_MINSIZEFIXED El tamaño mínimo es fijo.

Requisitos

   
Plataforma de destino Windows
Encabezado imepad.h

Consulte también

IImePad

IImePadApplet

IMECOMPOSITIONSTRINGINFO