Evento ListBox.DblClick (Access)ListBox.DblClick event (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.The DblClick event occurs when the user presses and releases the left mouse button twice over an object within the double-click time limit of the system.

SintaxeSyntax

expressão. DblClick (Cancelar)expression.DblClick (Cancel)

expressão Uma variável que representa um objeto ListBox .expression A variable that represents a ListBox object.

ParâmetrosParameters

NomeName Obrigatório/OpcionalRequired/Optional Tipo de dadosData type DescriçãoDescription
CancelCancel ObrigatórioRequired IntegerInteger A configuração determina se o evento DblClick ocorrerá.The setting determines if the DblClick event occurs. A definição do argumento Cancel como true (1) cancela o evento DblClick .Setting the Cancel argument to True (1) cancels the DblClick event.

ComentáriosRemarks

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.On a form, the DblClick event occurs when the user double-clicks a blank area or record selector on the form. Para um controle, ele ocorre quando o usuário clica duas vezes em um controle ou seu rótulo no modo formulário.For a control, it occurs when the user double-clicks a control or its label in Form view. 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).The DblClick event occurs when the user double-clicks the form or control but before the result of the double-click action occurs (for example, before Microsoft Access selects the word that the insertion point is on in a text box).

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.This event doesn't apply to check boxes, option buttons, or toggle buttons in an option group. Aplica-se somente ao grupo de opções propriamente dito.It applies only to the option group itself.

Esse evento não se aplica a um rótulo anexado a um outro controle, como o rótulo de uma caixa de texto.This event doesn't apply to a label attached to another control, such as the label for a text box. Aplica-se somente a rótulos "independentes".It applies only to "freestanding" labels. Clicar duas vezes em um rótulo anexado produz o mesmo efeito que clicar duas vezes no controle associado.Double-clicking an attached label has the same effect as double-clicking the associated control. Os eventos normais do controle ocorrem, mas não os eventos para o rótulo anexado.The normal events for the control occur, but not any events for the attached label.

Para executar uma macro ou um procedimento de evento quando esse evento ocorrer, defina a propriedade AoClicarDuasVezes com o nome da macro ou como [procedimento do evento].To run a macro or event procedure when this event occurs, set the OnDblClick property to the name of the macro or to [Event Procedure].

Em controles, o resultado da ação de clicar duas vezes depende do controle.For controls, the result of double-clicking depends on the control. Por exemplo, clicar duas vezes em uma palavra de uma caixa de texto selecionará a palavra inteira.For example, double-clicking a word in a text box selects the entire word. Clicar duas vezes em um controle que contém um objeto OLE iniciará o aplicativo usado para criar o objeto, permitindo que seja editado.Double-clicking a control containing an OLE object starts the application used to create the object, allowing it to be edited.

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.If the DblClick event doesn't occur within the double-click time limit of the system, the form, form section, or control recognizes two Click events instead of a single DblClick event. O limite de tempo de clique duplo depende da configuração em velocidade de clique duas vezes na guia botões da opção mouse do painel de controle do Windows.The double-click time limit depends on the setting under Double-Click Speed on the Buttons tab of the Mouse option of the Windows Control Panel.

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.By running a macro or an event procedure when the DblClick event occurs, you can open a window or document when an icon is double-clicked.

Clicando duas vezes em um controle faz com que os eventos de clique e DblClick ocorram.Double-clicking a control causes both Click and DblClick events to occur. 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.If the control doesn't already have the focus when you double-click it, the Enter and GotFocus events for the control occur before the Click and DblClick events.

Para os objetos que recebem eventos do mouse, os eventos ocorrem nesta ordem:For objects that receive mouse events, the events occur in this order:

MouseDownMouseUpclique emDblClickMouseDownMouseUpClickDblClick

Quando você clicar duas vezes em um botão de comando, os eventos ocorrerão na ordem a seguir:When you double-click a command button, the following events occur in this order:

MouseDownMouseUpclique emDblClickMouseUpclique emMouseDownMouseUpClickDblClickMouseUpClick

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 ).The second click may have no effect (for example, if the Click macro or event procedure opens a modal dialog box in response to the first Click event). Para impedir que a segunda macro ou procedimento de evento Click seja executado, coloque uma ação CancelarEvento na macro DblClick ou use o argumento Cancel no procedimento de evento DblClick .To prevent the second Click macro or event procedure from running, put a CancelEvent action in the DblClick macro, or use the Cancel argument in the DblClick event procedure. Observe que, em geral, clicando duas vezes em um botão de comando não é recomendável.Note that, generally speaking, double-clicking a command button should be discouraged.

Se você clicar duas vezes qualquer outro controle que não seja um botão de comando, o segundo evento Click não ocorrerá.If you double-click any other control besides a command button, the second Click event doesn't occur.

ExemploExample

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.The following example shows how you can use a DblClick event procedure to open a form that displays records from the table that is the row source of a combo box. Quando o usuário clica duas vezes na caixa de combinação vendedor em um formulário pedidos , **** o formulário Employees é exibido, mostrando o registro do funcionário selecionado na caixa de combinação.When the user double-clicks the Salesperson combo box in an Orders form, the Employees form is displayed, showing the record for the employee selected in the combo box.

Para testar o exemplo, adicione o seguinte procedimento de evento a um formulário denominado pedidos que contenha uma caixa de combinação denominada EmployeeID.To try the example, add the following event procedure to a form named Orders that contains a combo box named EmployeeID. A caixa de combinação deve ter como fonte de linha a mesma tabela que é a fonte do **** formulário Employees (ou uma consulta baseada nessa tabela).The combo box should have as its row source the same table that is the source for the Employees form (or a query based on that table).

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

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.