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

Evento Application.MouseUp (Visio)Application.MouseUp Event (Visio)

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

Ocorre quando um botão do mouse é liberado.Occurs when a mouse button is released.

SintaxeSyntax

Private Sub expressãoMouseUp( **_ByVal botão como Long** , ByVal KeyButtonState como longo , ByVal x como duplas , ByVal y como Double , ByVal CancelDefault como booleano )Private Sub expressionMouseUp( **_ByVal Button As Long** , ByVal KeyButtonState As Long , ByVal x As Double , ByVal y As Double , ByVal CancelDefault As Boolean )

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

ParâmetrosParameters

NomeNameObrigatório/opcionalRequired/OptionalTipo de dadosData TypeDescriçãoDescription
ButtonButtonObrigatórioRequiredLongLongO botão do mouse que foi liberado. Consulte Comentários para obter os valores possíveis.The mouse button that was released. See Remarks for possible values.
KeyButtonStateKeyButtonStateObrigatórioRequiredLongLongO estado dos botões do mouse e das teclas SHIFT e CTRL para o evento. Consulte Comentários para obter os valores possíveis.The state of the mouse buttons and the SHIFT and CTRL keys for the event. See Remarks for possible values.
xxObrigatórioRequiredDoubleDoubleA coordenada x do ponteiro do mouse.The x-coordinate of the mouse pointer.
yyObrigatórioRequiredDoubleDoubleA coordenada y do ponteiro do mouse.The y-coordinate of the mouse pointer.
CancelDefaultCancelDefaultObrigatórioRequiredBooleanBooleanFalse se o Microsoft Visio deve processar a mensagem que ele recebe desse evento; Caso contrário, True .False if Microsoft Visio should process the message it receives from this event; otherwise, True .

ComentáriosRemarks

Valores possíveis para Button são mostrados na tabela a seguir e são declarados em VisKeyButtonFlags na biblioteca de tipos do Visio.Possible values for Button are shown in the following table, and are declared in VisKeyButtonFlags in the Visio type library.

* * Constante * *Constant *** * O valor * *Value **
* * visMouseLeft * *visMouseLeft **11
* * visMouseMiddle * *visMouseMiddle **1616
visMouseRightvisMouseRight22

Os valores possíveis para KeyButtonState podem ser uma combinação dos valores mostrados na tabela a seguir, que são declaradas em VisKeyButtonFlags na biblioteca de tipos do Visio. Por exemplo, se KeyButtonState retornar 9, indica que o usuário clicou no botão esquerdo do mouse enquanto pressiona a tecla CTRL.Possible values for KeyButtonState can be a combination of the values shown in the following table, which are declared in VisKeyButtonFlags in the Visio type library. For example, if KeyButtonState returns 9, it indicates that the user clicked the left mouse button while pressing CTRL.

* * Constante * *Constant *** * O valor * *Value **
visKeyControlvisKeyControl88
visKeyShiftvisKeyShift44
visMouseLeftvisMouseLeft11
visMouseMiddlevisMouseMiddle1616
visMouseRightvisMouseRight22

Se você definiu CancelDefault como True , o Visio não processará a mensagem recebida quando o botão do mouse for clicado.If you set CancelDefault to True , Visio will not process the message received when the mouse button is clicked.

Ao contrário de alguns outros eventos do Visio, MouseUp não tem o prefixo "Query", mas Todavia é um evento de consulta. Ou seja, você pode cancelar processar a mensagem enviada pelo MouseUp , por definição CancelDefault como True , ou, se você estiver usando o método VisEventProc para manipular o evento, retornando True . Para obter mais informações, consulte os tópicos para o método VisEventProc e para qualquer um dos eventos de consulta (por exemplo, o evento QueryCancelSuspend ) nesta referência.Unlike some other Visio events, MouseUp does not have the prefix "Query," but it is nevertheless a query event. That is, you can cancel processing the message sent by MouseUp , either by setting CancelDefault to True , or, if you are using the VisEventProc method to handle the event, by returning True . For more information, see the topics for the VisEventProc method and for any of the query events (for example, the QueryCancelSuspend event) in this reference.

Se estiver usando o Microsoft Visual Basic ou o Visual Basic for Applications (VBA), a sintaxe deste tópico descreverá uma maneira comum e eficiente de lidar com eventos.If you are using Microsoft Visual Basic or Visual Basic for Applications (VBA), the syntax in this topic describes a common, efficient way to handle events.

Se você deseja criar seus próprios objetos de evento , use o método Add ou AddAdvise . Para criar um objeto Event que execute um complemento, use o método Add como ele se aplica à coleção EventList . Para criar um objeto Event que recebe uma notificação, use o método AddAdvise . Para localizar um código de evento para o evento que você deseja criar, consultecódigos de evento.If you want to create your own Event objects, use the Add or AddAdvise method. To create an Event object that runs an add-on, use the Add method as it applies to the EventList collection. To create an Event object that receives notification, use the AddAdvise method. To find an event code for the event you want to create, seeEvent codes.

ExemploExample

Este módulo de classe mostra como definir uma classe de coletor de eventos chamada MouseListener que escuta de eventos acionados por ações do mouse na janela ativa. Ele declara a variável de objeto vsoWindow usando a palavra-chave WithEvents . O módulo de classe também contém manipuladores de eventos para os eventos MouseDown , MouseMove e MouseUp .This class module shows how to define a sink class called MouseListener that listens for events fired by mouse actions in the active window. It declares the object variable vsoWindow by using the WithEvents keyword. The class module also contains event handlers for the MouseDown , MouseMove , and MouseUp events.

Para executar esse exemplo, insira um novo módulo de classe em seu projeto VBA, nomeie-o MouseListener e insira o seguinte código no módulo.To run this example, insert a new class module in your VBA project, name it MouseListener , and insert the following code in the module.

Dim WithEvents vsoWindow As Visio.Window 

Private Sub Class_Initialize() 

 Set vsoWindow = ActiveWindow 

End Sub 

Private Sub Class_Terminate() 

 Set vsoWindow = Nothing 

End Sub 

Private Sub vsoWindow_MouseDown(ByVal Button As Long, ByVal KeyButtonState As Long, ByVal x As Double, ByVal y As Double, CancelDefault As Boolean) 

 If Button = 1 Then 

 Debug.Print "Left mouse button clicked" 

 ElseIf Button = 2 Then 

 Debug.Print "Right mouse button clicked" 

 ElseIf Button = 16 Then 

 Debug.Print "Center mouse button clicked" 

 End If 

End Sub 

Private Sub vsoWindow_MouseMove(ByVal Button As Long, ByVal KeyButtonState As Long, ByVal x As Double, ByVal y As Double, CancelDefault As Boolean) 

 Debug.Print "x-position is "; x 
 Debug.Print "y-position is "; y 

End Sub 

Private Sub vsoWindow_MouseUp(ByVal Button As Long, ByVal KeyButtonState As Long, ByVal x As Double, ByVal y As Double, CancelDefault As Boolean) 

 If Button = 1 Then 

 Debug.Print "Left mouse button released" 

 ElseIf Button = 2 Then 

 Debug.Print "Right mouse button released" 

 ElseIf Button = 16 Then 

 Debug.Print "Center mouse button released" 

 End If 

End Sub

Em seguida, insira o seguinte código no projeto ThisDocument .Then, insert the following code in the ThisDocument project.

Dim myMouseListener As MouseListener 

Private Sub Document_DocumentSaved(ByVal doc As IVDocument) 

 Set myMouseListener = New MouseListener 

End Sub 

Private Sub Document_BeforeDocumentClose(ByVal doc As IVDocument) 

 Set myMouseListener = Nothing 

End Sub

Salve o documento para inicializar a classe e, em seguida, clique em qualquer lugar na janela ativa para acionar um evento MouseUp . Na janela imediata, o manipulador imprime o nome do botão do mouse que foi clicado para acionar o evento.Save the document to initialize the class, and then click anywhere in the active window to fire a MouseUp event. In the Immediate window, the handler prints the name of the mouse button that was clicked to fire the event.

© 2018 Microsoft