Evento Form.DblClick (Access)

O evento DblClick ocorre quando o usuário pressiona e libera o botão esquerdo do mouse duas vezes sobre um objeto, dentro do limite de tempo de clique duplo do sistema.

Sintaxe

expressão. DblClick (Cancelar)

expressão Uma variável que representa um objeto Form.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Cancel	Obrigatório	Integer	A configuração determina se o evento DblClick ocorrerá. Definir o argumento Cancelar como True (1) cancela o evento DblClick .

Comentários

Em um formulário, o evento DblClick ocorrerá quando o usuário clica duas vezes em uma área vazia ou o seletor de registro no formulário. Para um controle, ele ocorre quando o usuário clica duas vezes em um controle ou seu rótulo no modo formulário. O evento DblClick ocorre quando o usuário clica duas vezes no formulário ou controle, mas antes do resultado do clique duplo ocorre ação (por exemplo, antes do Microsoft Access seleciona a palavra que o ponto de inserção em uma caixa de texto).

Esse evento não se aplica a caixas de seleção, botões de opção ou botões de alternância em um grupo de opções. Aplica-se somente ao grupo de opções propriamente dito.

Esse evento não se aplica a um rótulo anexado a um outro controle, como o rótulo de uma caixa de texto. Aplica-se somente a rótulos "independentes". Clicar duas vezes em um rótulo anexado produz o mesmo efeito que clicar duas vezes no controle associado. Os eventos normais para o controle ocorrem, mas não eventos para o rótulo anexado.

Para executar uma macro ou procedimento de evento quando esse evento ocorrer, defina a propriedade OnDblClick como o nome da macro ou para [Procedimento de Evento].

Em controles, o resultado da ação de clicar duas vezes depende do controle. Por exemplo, clicar duas vezes em uma palavra de uma caixa de texto selecionará a palavra inteira. Clicar duas vezes em um controle que contém um objeto OLE iniciará o aplicativo usado para criar o objeto, permitindo que seja editado.

Se o evento DblClick não ocorrer dentro do limite de tempo de clique duplo do sistema, o formulário, seção de formulário ou controle reconhece dois eventos Click em vez de um único evento DblClick. O limite de tempo de clique duplo depende da configuração em Velocidade de Clique Duplo na guia Botões da opção Mouse do Windows Painel de Controle.

Executando uma macro ou um procedimento de evento quando ocorre o evento DblClick, você pode abrir uma janela ou um documento quando um ícone for clicado duas vezes.

Clicando duas vezes em um controle faz com que os eventos de clique e DblClick ocorram. Se o controle já não tiver o foco quando você clicar duas vezes, Enter e GotFocus eventos para o controle ocorrem antes dos eventos de clique e DblClick.

Para os objetos que recebem eventos do mouse, os eventos ocorrem nesta ordem:

MouseDown → MouseUp → Clique em → DblClick

Quando você clicar duas vezes em um botão de comando, os eventos ocorrerão na ordem a seguir:

MouseDown → MouseUp → Clique em → → MouseUp → Clique → em MouseUp

O segundo clique pode não ter efeito (por exemplo, se o procedimento de evento ou macro clique abre uma caixa de diálogo modal em resposta ao primeiro evento Click ). Para impedir que o segundo procedimento de evento ou macro clique em execução, coloque uma ação CancelEvent na macro DblClick ou use o argumento Cancelar no procedimento de evento DblClick . Observe que, em geral, clicando duas vezes em um botão de comando não é recomendável.

Se você clicar duas vezes qualquer outro controle que não seja um botão de comando, o segundo evento Click não ocorrerá.

Exemplo

O exemplo a seguir mostra como você pode usar um procedimento de evento DblClick para abrir um formulário que exibe os registros da tabela que representa a origem de linha de uma caixa de combinação. Quando o usuário clica duas vezes na caixa de combinação Vendedor em um formulário Orders , o formulário Funcionários é exibido, mostrando o registro do funcionário selecionado na caixa de combinação.

Para experimentar o exemplo, adicione o procedimento de evento a seguir a um formulário chamado Orders que contém uma caixa de combinação chamada EmployeeID. A caixa de combinação deve ter como fonte de linha a mesma tabela que é a origem do formulário Funcionários (ou uma consulta com base nessa tabela).

Private Sub EmployeeID_DblClick(Cancel As Integer) 
 DoCmd.OpenForm "Employees", , , _ 
 "EmployeeID = Forms!Orders!EmployeeID" 
End Sub

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.