Subroutine de IMIoctl

Propósito

Executa uma variedade de operações de controle ou consulta sobre o método de entrada.

Biblioteca

Biblioteca de Método de Entrada (libIM.a)

Sintaxe

Descrição

A subroutine IMIoctl executa uma variedade de operações de controle ou consulta no método de entrada especificado pelo parâmetro IM . Além disso, essa subroutine pode ser usada para controlar a função única de cada método de entrada de linguagem porque ele fornece extensões específicas do método de entrada. Cada método de entrada define sua própria função.

Parâmetros

IM

Especifica a instância do método de entrada.

Operação

Especifica a operação.

Argumento

O uso desse parâmetro depende de qual das operações a seguir é realizada.

IM_Refresh

Atualiza a área de texto, áreas auxiliares e indicador chamando as funções de callback necessárias se essas áreas não estiverem vazias. O parâmetro Argumento não é usado.

IM_GetString

Obtém a cadeia de pré-edição atual. O parâmetro Argumento especifica o endereço da estrutura do IMSTR fornecida pelo responsável pelo chamamento. A função de callback é invocada para limpar a pré-edição se ela existir.

IM_Clear

Limpa o texto e as áreas auxiliares se elas existirem. Se o parâmetro Argument não for um valor nulo, esta operação invoca as funções de callback para limpar a tela. O estado do teclado permanece o mesmo.

IM_Reset

Limpa a área auxiliar se ela existe atualmente. Se o parâmetro Argumento for um valor nulo, esta operação limpa apenas o buffer interno do método de entrada. Caso contrário, a sub-rotina IMAuxHide será chamada e o método de entrada retornará ao seu estado inicial

IM_ChangeLength

Altera o comprimento máximo da cadeia de pré-edição.

IM_ChangeMode

Configura o Modo de Processamento do método de entrada para o modo especificado pelo parâmetro Argumento . O valor válido para Argumento é:

IMNormalMode

Especifica o modo normal de pré-edição.

IMSuppressedMode

Suprime a pré-edição.

 

IM_QueryState

Retorna o status da área de texto, a área auxiliar e o indicador. Ele também retorna o status beep e o modo de processamento. Os resultados são armazenados na estrutura IMQueryState fornecida pelo responsável pela chamada apontada pelo parâmetro Argument .

IM_QueryText

Retorna informações detalhadas sobre a área de texto. Os resultados são armazenados na estrutura IMQueryText fornecida pelo responsável pela chamada apontada pelo parâmetro Argument .

IM_QueryAuxiliary

Retorna informações detalhadas sobre a área auxiliar. Os resultados são armazenados na estrutura IMQueryAuxiliary fornecida pelo responsável pela chamada, apontados pelo parâmetro Argument

IM_QueryIndicator

Retorna informações detalhadas sobre o indicador. Os resultados são armazenados na estrutura IMQueryIndicator fornecida pelo responsável pela chamada apontada pelo parâmetro Argument ..

IM_QueryIndicatorString

Retorna uma cadeia de indicadores correspondente ao indicador atual. Os resultados são armazenados na estrutura IMQueryIndicatorString fornecida pelo chamador, apontada pelo parâmetro Argument. O chamador pode solicitar um formulário curto ou longo com o membro format da estrutura IMQueryIndicatorString.

IM_SupportSelection

Informa o método de entrada se um aplicativo suporta ou não uma lista de seleção de área auxiliar. O aplicativo deve suportar seleções dentro da área auxiliar e determinar como as seleções são exibidas. Se esta operação não for realizada, o método de entrada assume que o aplicativo não suporta uma lista de seleção de área auxiliar.

 

Valores De Retorno

O subroutine IMIoctl retorna um valor para a variável global IMError que indica o tipo de erro encontrado. Alguns tipos de erro são fornecidos no arquivo /usr/include/imerrno.h .