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

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