Table of contents
TOC
Recolher sumário
Expandir sumário

Evento CommandButton.MouseDown (Access)CommandButton.MouseDown Event (Access)

office 365 dev account|Última Atualização: 22/03/2018
|
2 Colaboradores

O evento MouseDown ocorre quando o usuário pressiona um botão do mouse.The MouseDown event occurs when the user presses a mouse button.

SintaxeSyntax

expressão. MouseDown (* * Botão, * * Shift, * * X, * * Y ** )expression. **MouseDown( ** Button, ** Shift, ** X, ** Y )

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

ParâmetrosParameters

NomeNameObrigatório/opcionalRequired/OptionalTipo de dadosData TypeDescriçãoDescription
ButtonButtonObrigatórioRequiredIntegerIntegerO botão que foi pressionado para disparar o evento. Se precisar testar o argumento Button, você poderá utilizar uma das seguintes constantes intrínsecas como máscara de bits:The button that was pressed to trigger the event. If you need to test for the Button argument, you can use one of the following intrinsic constants as bit masks:

  • acLeftButton A máscara de bits para o botão esquerdo do mouse.acLeftButton The bit mask for the left mouse button.

  • acRightButton A máscara de bits para o botão direito do mouse.acRightButton The bit mask for the right mouse button.

  • acMiddleButton A máscara de bits para o botão do meio do mouse.acMiddleButton The bit mask for the middle mouse button.

| | SHIFT| Necessário | Inteiro| O estado das teclas SHIFT, CTRL e ALT quando o botão especificado pelo argumento Button foi pressionado ou liberado. Se precisar testar o argumento Shift, você pode usar uma das seguintes constantes intrínsecas como máscaras de bits:| | Shift|Required|Integer|The state of the SHIFT, CTRL, and ALT keys when the button specified by the Button argument was pressed or released. If you need to test for the Shift argument, you can use one of the following intrinsic constants as bit masks:
  • acShiftMask A máscara de bits para a tecla SHIFT.acShiftMask The bit mask for the SHIFT key.

  • acCtrlMask A máscara de bits para a tecla CTRL.acCtrlMask The bit mask for the CTRL key.

  • acAltMask A máscara de bits para a tecla ALT.acAltMask The bit mask for the ALT key.

| | X| Necessário | Único| A coordenada x para o local atual do ponteiro do mouse, em twips. | | Y| Necessário | Único| A coordenada y para o local atual do ponteiro do mouse, em twips. || | X|Required|Single|The x coordinate for the current location of the mouse pointer, in twips. | | Y|Required|Single|The y coordinate for the current location of the mouse pointer, in twips. |

ComentáriosRemarks

  • O evento MouseDown aplica-se somente a formulários, seções de formulário e controles em um formulário, não a controles em um relatório.The MouseDown event applies only to forms, form sections , and controls on a form, not controls on a report.

  • Esse evento não se aplica a um rótulo anexado a outro controle, como o rótulo de uma caixa de texto. Ele se aplica somente a rótulos "independentes". Pressionar e liberar um botão do mouse em um rótulo anexado tem o mesmo efeito de pressionar e liberar o botão no controle associado. Ocorrem os eventos normais para o controle; nenhum evento separado ocorre para o rótulo anexado.This event does not apply to a label attached to another control, such as the label for a text box. It applies only to "freestanding" labels. Pressing and releasing a mouse button in an attached label has the same effect as pressing and releasing the button in the associated control. The normal events for the control occur; no separate events occur for the attached label.

Para executar um macro ou procedimento de evento quando esses eventos ocorrerem, defina a propriedade OnMouseDown com o nome da macro ou como [procedimento do evento].To run a macro or event procedure when these events occur, set the OnMouseDown property to the name of the macro or to [Event Procedure].

Você pode usar um evento MouseDown para especificar o que acontece quando um determinado botão do mouse é pressionado ou liberado. Ao contrário os eventos de clique e DblClick , o evento MouseDown permite distinguir entre os botões esquerdo, direito e do meio do mouse. Você também pode escrever código para combinações de mouse e teclado que usam a tecla SHIFT, CTRL e teclas ALT.You can use a MouseDown event to specify what happens when a particular mouse button is pressed or released. Unlike the Click and DblClick events, the MouseDown event enables you to distinguish between the left, right, and middle mouse buttons. You can also write code for mouse-keyboard combinations that use the SHIFT, CTRL, and ALT keys.

Para fazer com que um evento MouseDown para um formulário ocorra, pressione o botão do mouse em uma área vazia ou o seletor de registro no formulário. Para fazer com que um evento MouseDown para uma seção de formulário ocorra, pressione o botão do mouse em uma área em branco da seção do formulário.To cause a MouseDown event for a form to occur, press the mouse button in a blank area or record selector on the form. To cause a MouseDown event for a form section to occur, press the mouse button in a blank area of the form section.

O exemplo a seguir se aplicam a eventos MouseDown :The following apply to MouseDown events:

  • Se um botão do mouse é pressionado enquanto o ponteiro está sobre um formulário ou controle, esse objeto receberá todos os eventos de mouse até e incluindo o último evento MouseUp .If a mouse button is pressed while the pointer is over a form or control, that object receives all mouse events up to and including the last MouseUp event.

  • Se os botões do mouse forem pressionados sucessivamente, o objeto que receber os eventos do mouse após o primeiro pressionamento receberá todos os eventos de mouse até todos os botões estarem liberados.If mouse buttons are pressed in succession, the object that receives the mouse event after the first press receives all mouse events until all buttons are released.

Para responder a um evento gerado pela movimentação do mouse, utilize um evento MouseMove .To respond to an event caused by moving the mouse, you use a MouseMove event.

ExemploExample

O exemplo a seguir mostra como você pode localizar qual botão do mouse gerou um evento MouseDown.The following example shows how you can find out which mouse button caused a MouseDown event.

Para testar o exemplo, adicione o procedimento de evento a seguir a um formulário:To try the example, add the following event procedure to a form:

Private Sub Form_MouseDown(Button As Integer, _ 
         Shift As Integer, X As Single, _ 
         Y As Single) 
    If Button = acLeftButton Then 
        MsgBox "You pressed the left button." 
    End If 
    If Button = acRightButton Then 
        MsgBox "You pressed the right button." 
    End If 
    If Button = acMiddleButton Then 
        MsgBox "You pressed the middle button." 
    End If 
End Sub

Ver tambémSee also

ConceitosConcepts

Objeto CommandButtonCommandButton Object

© 2018 Microsoft