MouseButtonEventArgs Classe

Definição

Espaço de Nomes:
System.Windows.Input
Assemblagem:
PresentationCore.dll

Fornece dados para eventos relacionados com botões do rato.

public ref class MouseButtonEventArgs : System::Windows::Input::MouseEventArgs
public class MouseButtonEventArgs : System.Windows.Input.MouseEventArgs
type MouseButtonEventArgs = class
    inherit MouseEventArgs
Public Class MouseButtonEventArgs
Inherits MouseEventArgs
Herança
Object
EventArgs
RoutedEventArgs
InputEventArgs
MouseEventArgs
MouseButtonEventArgs

Exemplos

O exemplo seguinte cria um manipulador de eventos com botão do rato que altera a cor do objeto que levantou o evento. A cor escolhida depende do botão do rato que foi pressionado. A ChangedButton propriedade é verificada para determinar qual botão foi pressionado.

private void MouseButtonDownHandler(object sender, MouseButtonEventArgs e)
{
    Control src = e.Source as Control;

    if (src != null)
    {
        switch (e.ChangedButton)
        {
            case MouseButton.Left:
                src.Background = Brushes.Green;
                break;
            case MouseButton.Middle:
                src.Background = Brushes.Red;
                break;
            case MouseButton.Right:
                src.Background = Brushes.Yellow;
                break;
            case MouseButton.XButton1:
                src.Background = Brushes.Brown;
                break;
            case MouseButton.XButton2:
                src.Background = Brushes.Purple;
                break;
            default:
                break;
        }
    }
}

Private Sub MouseButtonDownHandler(ByVal sender As Object, ByVal e As MouseButtonEventArgs)
    Dim src As Control = TryCast(e.Source, Control)

    If src IsNot Nothing Then
        Select Case e.ChangedButton
            Case MouseButton.Left
                src.Background = Brushes.Green
            Case MouseButton.Middle
                src.Background = Brushes.Red
            Case MouseButton.Right
                src.Background = Brushes.Yellow
            Case MouseButton.XButton1
                src.Background = Brushes.Brown
            Case MouseButton.XButton2
                src.Background = Brushes.Purple
            Case Else
        End Select
    End If
End Sub

Observações

MouseButtonEventArgsé usado com os seguintes eventos: MouseDown, MouseUp, MouseLeftButtonDown, MouseLeftButtonUpMouseRightButtonDown, , MouseRightButtonUp, e os respetivos eventos de tunelamento.

A Mouse classe fornece propriedades e métodos adicionais para determinar o estado do rato.

Construtores

Name Description
MouseButtonEventArgs(MouseDevice, Int32, MouseButton, StylusDevice)

Inicializa uma nova instância da MouseButtonEventArgs classe usando os especificados MouseDevice, timestamp, MouseButton, e StylusDevice. .
MouseButtonEventArgs(MouseDevice, Int32, MouseButton)

Inicializa uma nova instância da MouseButtonEventArgs classe usando o carimbo temporal especificado MouseDevicee MouseButton.

Propriedades

Name Description
ButtonState

Obtém o estado do botão associado ao evento.
ChangedButton

Recebe o botão associado ao evento.
ClickCount

Mostra o número de vezes que o botão foi carregado.
Device

Recebe o dispositivo de entrada que iniciou este evento.

(Herdado de InputEventArgs)
Handled

Recebe ou define um valor que indica o estado atual do tratamento do evento para um evento encaminhado enquanto percorre a rota.

(Herdado de RoutedEventArgs)
LeftButton

Obtém o estado atual do botão esquerdo do rato.

(Herdado de MouseEventArgs)
MiddleButton

Recebe o estado atual do botão do meio do rato.

(Herdado de MouseEventArgs)
MouseDevice

Recebe o dispositivo rato associado a este evento.

(Herdado de MouseEventArgs)
OriginalSource

Obtém a fonte original de reporte determinada por testes puros de sucesso, antes de qualquer possível Source ajuste por parte de uma turma-mãe.

(Herdado de RoutedEventArgs)
RightButton

Obtém o estado atual do botão direito do rato.

(Herdado de MouseEventArgs)
RoutedEvent

Obtém ou define o associado RoutedEvent a esta RoutedEventArgs instância.

(Herdado de RoutedEventArgs)
Source

Obtém ou define uma referência ao objeto que originou o evento.

(Herdado de RoutedEventArgs)
StylusDevice

Recebe o dispositivo de stylus associado a este evento.

(Herdado de MouseEventArgs)
Timestamp

Obtém a hora em que este evento aconteceu.

(Herdado de InputEventArgs)
XButton1

Obtém o estado atual do primeiro botão estendido do rato.

(Herdado de MouseEventArgs)
XButton2

Recebe o estado do segundo botão estendido do rato.

(Herdado de MouseEventArgs)

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetPosition(IInputElement)

Devolve a posição do ponteiro do rato em relação ao elemento especificado.

(Herdado de MouseEventArgs)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InvokeEventHandler(Delegate, Object)

Invoca os gestores de eventos de forma específica para cada tipo, o que pode aumentar a eficiência do sistema de eventos.
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
OnSetSource(Object)

Quando sobrescrito numa classe derivada, fornece um ponto de entrada de callback por notificação sempre que o valor da Source propriedade de uma instância muda.

(Herdado de RoutedEventArgs)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também