Compartilhar via

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

  • Artigo

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