Evento Clicar
[O Microsoft Agent foi preterido do Windows 7 em diante e pode não estar disponível em versões subsequentes do Windows.]
-
Descrição
-
Ocorre quando o usuário clica em um caractere ou no ícone do caractere.
-
Sintaxe
-
Sub agent**_Click** (ByVal CharacterID, ByVal Button, ByVal Shift, ByVal X, ByVal Y**)**
Parte Descrição CharacterID Retorna a ID do caractere clicado como uma cadeia de caracteres. Botão Retorna um número inteiro que identifica o botão que foi pressionado e liberado para causar o evento. O argumento do botão é um campo de bits com bits correspondentes ao botão esquerdo (bit 0), botão direito (bit 1) e botão do meio (bit 2). Esses bits correspondem aos valores 1, 2 e 4, respectivamente. Apenas um dos bits é definido, indicando o botão que causou o evento. Caso o caractere inclua um ícone da barra de tarefas e o bit 13 também esteja definido, significa que clique ocorreu no ícone da barra de tarefas. Shift Retorna um número inteiro que corresponde ao estado das teclas SHIFT, CTRL e ALT quando o botão especificado no argumento do botão é pressionado ou liberado. Um bit será definido se a tecla estiver pressionada. O argumento shift é um campo de bits com os bits menos significativos correspondentes à tecla SHIFT (bit 0), à tecla CTRL (bit 1) e à tecla ALT (bit 2). Esses bits correspondem aos valores 1, 2 e 4, respectivamente. O argumento shift indica o estado dessas teclas. Alguns, todos ou nenhum dos bits podem ser definidos, indicando que algumas, todas ou nenhuma das teclas são pressionadas. Por exemplo, se CTRL e ALT fossem pressionados, o valor de shift seria 6. X,Y Retorna um número inteiro que especifica a localização atual do ponteiro do mouse. Os valores X e Y são sempre expressos em pixels, em relação ao canto superior esquerdo da tela.
Esse evento é enviado apenas para o cliente ativo de entrada de um caractere. Quando o usuário clica em um caractere ou no ícone da barra de tarefas sem nenhum cliente ativo de entrada, o servidor envia o evento para o cliente ativo. Se o caractere estiver visível (Visible = True), a ação do usuário também definirá o último cliente ativo de entrada do caractere como o cliente ativo de entrada atual, enviando o evento ActivateInput ao cliente e enviando o evento Click. Se o caractere estiver oculto (Visible = False), e o usuário clicar no ícone da barra de tarefas do caractere usando o botão 1, o caractere também será mostrado automaticamente.
Observação
Clicar em um caractere não desativa todas as outras saídas de caracteres (todos os caracteres). No entanto, pressionar a tecla Listening libera a saída do caractere ativo de entrada e dispara o evento RequestComplete, transmitindo Request.Status que indica que a fila do cliente foi interrompida.