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

Chamado por um IImePadApplet para inserir texto em um aplicativo.

A solicitação é o único método que IImePadApplet pode chamar. Ao chamar esse método com uma das IDs de solicitação IMEPADREQ_* , iImePadApplet pode inserir texto em um aplicativo e pode controlar a cadeia de caracteres de composição do IME em um aplicativo.

Sintaxe

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

Parâmetros

[in] pIImePadApplet

O ponteiro da interface do applet de chamada.

[in] reqId

O tipo de solicitação (a ID da solicitação). Isso deve ser definido como um dos seguintes valores:

Valor	Significado
IMEPADREQ_INSERTSTRING	Insira uma cadeia de caracteres no aplicativo como uma cadeia de caracteres de composição. wParam: ponteiro para a cadeia de caracteres terminada em NULL (LPWSTR) a ser inserida no aplicativo. lParam: não usado. Deve ser definido como 0.
IMEPADREQ_SENDCONTROL	Controla a composição da cadeia de caracteres e do cursor no aplicativo. wParam: especifica o valor de controle (IMEPADCTRL_*) que solicita o IME para processar a cadeia de caracteres de composição e a posição do cursor. Consulte Comentários para obter uma lista dos valores IMEPADCTRL_* . lParam: não usado. Deve ser definido como 0.
IMEPADREQ_SETAPPLETSIZE	Defina um novo tamanho de janela de miniaplicativo. wParam: LOWORD(wParam) especifica a largura do applet. HIWORD(wParam) especifica a altura do applet lParam: não usado. Deve ser definido como 0.
IMEPADREQ_GETCOMPOSITIONSTRING	Obtém o texto da cadeia de caracteres de composição atual. wParam: aponta para o buffer (LPWSTR) que deve receber o texto da cadeia de caracteres de composição atual. lParam: o número máximo de caracteres a serem copiados, incluindo o caractere nulo de terminação.
IMEPADREQ_GETCOMPOSITIONSTRINGINFO	Obtém informações sobre a cadeia de caracteres de composição atual. wParam: ponteiro para uma estrutura IMECOMPOSITIONSTRINGINFO que recebe as informações de composição. lParam: não usado. Deve ser definido como 0.
IMEPADREQ_DELETESTRING	Exclua a cadeia de caracteres de composição. wParam: LOWORD(wParam) especifica a posição inicial da cadeia de caracteres de composição a ser excluída. HIWORD(wParam) especifica o comprimento da cadeia de caracteres de composição a ser excluída. lParam: não usado. Deve ser definido como 0.
IMEPADREQ_CHANGESTRING	Substitua parte da cadeia de caracteres de composição. wParam: ponteiro para a cadeia de caracteres de substituição (LPWSTR). lParam: LOWORD(lParam) especifica a posição inicial da cadeia de caracteres de composição a ser substituída. HIWORD(lParam) especifica o comprimento da cadeia de caracteres de composição a ser substituída.
IMEPADREQ_GETAPPLHWND	Obtém o identificador da janela do aplicativo. wParam: o endereço do identificador HWND (HWND *) para receber o identificador da janela do aplicativo. lParam: não usado. Deve ser definido como 0.
IMEPADREQ_FORCEIMEPADWINDOWSHOW	Mantém a janela ImePad visível. wParam: TRUE para manter a janela IMEPad visível. lParam: não usado. Deve ser definido como 0.
IMEPADREQ_POSTMODALNOTIFY	Faz com que o IImePad chame o método Notify do applet de forma assíncrona com uma ID de notificação específica e dados definidos pelo usuário. wParam: o código de notificação (IMEPN_*). Consulte os Comentários de IImePadApplet::Notify para obter os possíveis códigos IMEPN_* . lParam: dados definidos pelo usuário
IMEPADREQ_GETDEFAULTUILANGID	Obtém a linguagem de interface do usuário de applet do ImePad recomendada (padrão). wParam: endereço da ID da linguagem (LANGID *) para receber a linguagem padrão da interface do usuário. lParam: não usado. Deve ser definido como 0.
IMEPADREQ_GETCURRENTUILANG	Obtenha a linguagem de interface do usuário do applet do ImePad atual. wParam: endereço da ID da linguagem (LANGID *) para receber a linguagem de interface do usuário atual. lParam: não usado. Deve ser definido como 0.
IMEPADREQ_GETAPPLETUISTYLE	Obtém o estilo de interface do usuário do applet (sinalizadores IPAWS_* ). wParam: endereço para receber o estilo de interface do usuário do applet (DWORD *). O estilo é uma combinação de sinalizadores IPAWS_* ; consulte Comentários para obter os possíveis sinalizadores IPAWS_* . lParam: não usado. Deve ser definido como 0.
IMEPADREQ_SETAPPLETUISTYLE	Define o estilo da interface do usuário do applet (sinalizadores IPAWS_* ). wParam: estilo de interface do usuário do Applet. O estilo é uma combinação de sinalizadores IPAWS_* ; consulte Comentários para obter os possíveis sinalizadores IPAWS_* . lParam: não usado. Deve ser definido como 0.
IMEPADREQ_ISAPPLETACTIVE	Determina se o applet está ativo. wParam: endereço para receber o valor (BOOL *). Se for TRUE, o applet estará ativo; caso contrário, o applet não está ativo. lParam: não usado. Deve ser definido como 0.
IMEPADREQ_ISIMEPADWINDOWVISIBLE	Determina se o ImePad está visível. wParam: endereço para receber o valor (BOOL *). Se for TRUE, imePad ficará visível; caso contrário, imePad não está visível. lParam: não usado. Deve ser definido como 0.
IMEPADREQ_SETAPPLETMINMAXSIZE	Defina o tamanho mínimo e máximo do applet. wParam: LOWORD(wParam) especifica a largura do applet. HIWORD(wParam) especifica a altura do applet. lParam: TRUE define o tamanho máximo; FALSE para definir o tamanho mínimo.
IMEPADREQ_GETCONVERSIONSTATUS	Obtém o status de conversão do IME do aplicativo atual. Para obter uma lista completa dos modos de conversão e frase, consulte o arquivo de cabeçalho Imm.h. wParam: endereço para receber o modo de conversão (DWORD *). lParam: endereço para receber o modo de frase (DWORD *).
IMEPADREQ_GETVERSION	Obtém as informações de versão do IImePad. wParam: endereço para receber a versão principal (DWORD *). lParam: endereço para receber a versão secundária (DWORD *).
IMEPADREQ_GETCURRENTIMEINFO	Obtém as informações de IME que invocaram o ImePad. wParam: endereço para receber a ID de idioma do IME (DWORD *). lParam: endereço para receber a ID de entrada do IME (DWORD *).

[in, out] wParam

Informações adicionais específicas para reqId.

[in, out] lParam

Informações adicionais específicas para reqId.

Valor retornado

S_OK se tiver êxito, caso contrário , E_FAIL.

Comentários

Valores possíveis de IMEPADCTRL_*

Esses são os valores possíveis que o wParam pode usar quando reqId é definido como IMEPADREQ_SENDCONTROL:

Nome	Valor	Descrição
IMEPADCTRL_CONVERTALL	1	Converter todas as cadeias de caracteres de composição.
IMEPADCTRL_DETERMINALL	2	Determine todas as cadeias de caracteres de composição.
IMEPADCTRL_DETERMINCHAR	3	Determine o caractere de cadeia de caracteres de composição da contagem especificada.
IMEPADCTRL_CLEARALL	4	Limpe todas as cadeias de caracteres de composição.
IMEPADCTRL_CARETLEFT	6	Mova o cursor de caractere para a esquerda.
IMEPADCTRL_CARETRIGHT	7	Mova o cursor de caractere para a direita.
IMEPADCTRL_CARETTOP	8	Mova o cursor de caractere para a parte superior da cadeia de caracteres de composição.
IMEPADCTRL_CARETBOTTOM	9	Mova o cursor de caractere para o final da cadeia de caracteres de composição.
IMEPADCTRL_CARETBACKSPACE	10	Exclua o caractere da cadeia de caracteres de composição antes do cursor (como a chave BACKSPACE).
IMEPADCTRL_CARETDELETE	11	Exclua o caractere da cadeia de caracteres de composição após o cursor (como a chave DELETE).
IMEPADCTRL_PHRASEDELETE	12	Exclua a frase da cadeia de caracteres de composição.
IMEPADCTRL_INSERTSPACE	13	Insira um caractere de espaço — largura total ou meia largura, dependendo da configuração do IME.
IMEPADCTRL_INSERTFULLSPACE	14	Insira espaço de largura total.
IMEPADCTRL_INSERTHALFSPACE	15	Insira espaço de meia largura.
IMEPADCTRL_ONIME	16	Defina IME ON.
IMEPADCTRL_OFFIME	17	Defina IME DESATIVADO.
IMEPADCTRL_ONPRECONVERSION	18	Defina ON de pré-conversão.
IMEPADCTRL_OFFPRECONVERSION	19	Defina OFF de pré-conversão.
IMEPADCTRL_PHONETICCANDIDATE	20	Abra o candidato do IME.

 

Valores possíveis de IPAWS_*

Esses são os valores possíveis que podem ser recebidos por meio do wParam quando reqId é definido como IMEPADREQ_GETAPPLETUISTYLE ou que wParam pode ser definido como quando reqId é definido como IMEPADREQ_SETAPPLETUISTYLE:

Nome	Descrição
IPAWS_ENABLED	Mostrar o applet como uma janela habilitada.
IPAWS_SIZINGNOTIFY	Envie o código de notificação de IMEPN_SIZECHANGING ou IMEPN_SIZECHANGED para o applet.
IPAWS_VERTICALFIXED	Corrigido verticalmente.
IPAWS_HORIZONTALFIXED	Corrigido horizontalmente.
IPAWS_SIZEFIXED	O tamanho é fixo.
IPAWS_MAXWIDTHFIXED	A largura máxima é fixa.
IPAWS_MAXHEIGHTFIXED	A altura máxima é fixa.
IPAWS_MAXSIZEFIXED	O tamanho máximo é fixo.
IPAWS_MINWIDTHFIXED	A largura mínima é fixa.
IPAWS_MINHEIGHTFIXED	A altura mínima é fixa.
IPAWS_MINSIZEFIXED	O tamanho mínimo é fixo.

Requisitos

Plataforma de Destino	Windows
Cabeçalho	imepad.h

Confira também

IImePad

IImePadApplet

IMECOMPOSITIONSTRINGINFO