Eventos do Mouse nos Formulários do Windows
Quando você manipula a entrada do mouse, você normalmente quer saber a localização do ponteiro e o estado dos botões do mouse.Este tópico fornece detalhes sobre como obter esta informação de eventos do mouse e explica a ordem em que os eventos do mouse são gerados em controles dos Formulários do Windows.Para uma lista e descrição de todos os eventos do mouse, veja Como a entrada do mouse funciona em Formulários do Windows.
Informação sobre o Mouse
A MouseEventArgs é enviada para os manipuladores de eventos de mouse relacionados a clicar em um botão do mouse e rastrear os movimentos do mouse. MouseEventArgs Fornece informações sobre o estado corrente do mouse, incluindo o local do ponteiro do mouse em coordenadas de cliente que botões do mouse são pressionados e se a roda do mouse tiver rolado. Muitos eventos do mouse, como aqueles que simplesmente avisam quando o ponteiro do mouse entrou ou saiu do limite de um controle, enviam um EventArgs ao manipulador do evento sem mais informações.
Se você deseja saber o estado corrente de botões do mouse ou o local do ponteiro do mouse e você desejar evitar manipular um evento de mouse, você também pode usar o MouseButtons e MousePosition propriedades das Control classe. MouseButtons Retorna informações sobre quais botões do mouse são pressionados no momento. MousePosition retorna as coordenadas na tela do ponteiro do mouse e é equivalente ao valor returnado por Position.
Convertendo entre Coordenadas da Tela e do Cliente
Como algumas informações sobre a localização do mouse estão em coordenadas do cliente e outras em coordenadas da tela, você pode querer converter um ponto de um sistema de coordenadas para o outro.Você pode fazer isto facilmente usando os métodos PointToClient e PointToScreen disponíveis na classe Control.
Comportamento Padrão de Eventos de Clique
Se você quiser manipular eventos de clique do mouse na ordem apropriada, você deve saber a ordem em que os eventos de clique são gerados nos controles dos Formulários do Windows.Todos os controles dos Formulários do Windows geram eventos na mesma ordem quando um botão do mouse é pressionado e solto (independentemente do botão do mouse), exceto onde anotado na lista a seguir em controles individuais.A lista a seguir mostra a ordem dos eventos gerados por um único clique de um botão do mouse:
Evento MouseDown.
Evento Click.
Evento MouseClick.
Evento MouseUp.
A seguir está a ordem dos eventos gerados por um duplo clique de um botão do mouse:
Evento MouseDown.
Evento Click.
Evento MouseClick.
Evento MouseUp.
Evento MouseDown.
Evento DoubleClick.(Isto pode variar, dependendo de se o controle em questão tem o bit de estilo StandardDoubleClick definido como true.Para mais informações sobre como definir um bit de ControlStyles, veja o método SetStyle.)
Evento MouseDoubleClick.
Evento MouseUp.
Para um código exemplo que mostra a ordem dos eventos de clique do mouse, consulte Como: Manipular eventos de entrada do usuário in Windows Forms Controls.
Controles Individuais
Os controles a seguir não seguem o comportamento padrão de clique do mouse:
Controles Button, CheckBox, ComboBox e RadioButton
.gif "Observação")
Observação:Para o ComboBox controle, o evento detalhados posteriormente ocorre caso o usuário clica no campo de edição, o botão, ou em um item dentro da lista.
clicar com o botão esquerdo do mouse: Click, MouseClick
clicar com o botão direito do mouse: Nenhum evento de clicar disparado
clicar duas vezes à esquerda: Click, MouseClick; Click, MouseClick
clicar duas vezes à direita: Nenhum evento de clicar disparado
Controles TextBox, RichTextBox, ListBox, MaskedTextBox e CheckedListBox
Observação:O comportamento de eventos detalhado ocorre posteriormente Quando o usuário clica em qualquer lugar dentro desses controles.
clicar com o botão esquerdo do mouse: Click, MouseClick
clicar com o botão direito do mouse: Nenhum evento de clicar disparado
clicar duas vezes à esquerda: Click, MouseClick, DoubleClick, MouseDoubleClick
clicar duas vezes à direita: Nenhum evento de clicar disparado
Controle ListView
Observação:O comportamento de eventos detalhado ocorre posteriormente somente quando o usuário clica nos itens a Controle ListViewNenhum evento de clique é gerando para clique em qualquer outro lugar do controle.Além dos eventos descritos mais adiante, existem os eventos BeforeLabelEdit e AfterLabelEdit, que podem ser de seu interesse se você quiser usar validação no controle ListView.
clicar com o botão esquerdo do mouse: Click, MouseClick
clicar com o botão direito do mouse: Click, MouseClick
clicar duas vezes à esquerda: Click, MouseClick; DoubleClick, MouseDoubleClick
clicar duas vezes à direita: Click, MouseClick; DoubleClick, MouseDoubleClick
Controle TreeView
Observação:O comportamento de eventos detalhado ocorre posteriormente somente quando o usuário clica nos itens próprios ou à direita dos itens a Controle TreeViewNenhum evento de clique é gerando para clique em qualquer outro lugar do controle.Além dos descritos mais adiante, existem os eventos BeforeCheck, BeforeSelect, BeforeLabelEdit, AfterSelect, AfterCheck e AfterLabelEdit, que podem ser de seu interesse se você quiser usar validação no controle TreeView.
clicar com o botão esquerdo do mouse: Click, MouseClick
clicar com o botão direito do mouse: Click, MouseClick
clicar duas vezes à esquerda: Click, MouseClick; DoubleClick, MouseDoubleClick
clicar duas vezes à direita: Click, MouseClick; DoubleClick, MouseDoubleClick
Comportamento de Pintura dos Controles Alternados
Controles alternados, como os que derivam da classe ButtonBase, tem o seguinte comportamento de pintura distinto em combinação com os eventos de clique do mouse:
O usuário pressiona o botão do mouse.
O controle se pinta no estado pressionado.
O evento MouseDown é gerado.
O usuário solta o botão do mouse.
O controle se pinta no estado solto.
O evento Click é gerado.
O evento MouseClick é gerado.
O evento MouseUp é gerado.
Observação:Se o usuário move o ponteiro fora do controle alternância enquanto o mouse botão do mouse está pressionado (por exemplo, mover o mouse fora o Button controlar enquanto estiver pressionado), o controle de alternância será pintar o elevado estado e somente o MouseUp evento ocorre. Os eventos Click ou MouseClick não ocorrerão nesta situação.