MouseEventArgs Classe

Definição

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Fornece dados para eventos roteados relacionados ao mouse que não envolvem especificamente os botões do mouse ou a roda do mouse, por exemplo MouseMove.

public ref class MouseEventArgs : System::Windows::Input::InputEventArgs

public class MouseEventArgs : System.Windows.Input.InputEventArgs

type MouseEventArgs = class
    inherit InputEventArgs

Public Class MouseEventArgs
Inherits InputEventArgs

Herança

Object

EventArgs

RoutedEventArgs

InputEventArgs

MouseEventArgs

Derivado

System.Windows.Input.MouseButtonEventArgs

System.Windows.Input.MouseWheelEventArgs

System.Windows.Input.QueryCursorEventArgs

Comentários

Essa classe de dados de evento é usada com os seguintes eventos anexados.

• Mouse.GotMouseCapture

• Mouse.LostMouseCapture

• Mouse.MouseEnter

• Mouse.MouseLeave

• Mouse.MouseMove

• Mouse.PreviewMouseMove

Essa classe de dados de evento é usada com os seguintes eventos roteado. Esses eventos roteados encaminham os eventos anexados listados anteriormente para torná-los mais acessíveis ao modelo de elemento geral no WPF.

• UIElement.MouseEnter

• UIElement.MouseLeave

• UIElement.MouseMove

• UIElement.PreviewMouseMove

• ContentElement.MouseEnter

• ContentElement.MouseLeave

• ContentElement.MouseMove

• ContentElement.PreviewMouseMove

Os eventos anexados e os eventos roteados do elemento base compartilham seus dados de evento e as versões de borbulha e túnel dos eventos roteados também compartilham dados de eventos. Isso pode afetar as características tratadas do evento à medida que ele percorre a rota do evento. Para obter detalhes, consulte Visão geral da entrada.

Além das RoutedEventArgs propriedades relevantes para todos os eventos roteado, as propriedades mais interessantes que MouseEventArgs você pode usar em uma MouseEventHandler implementação são várias propriedades que expõem o estado atual do botão (como LeftButton) e MouseDevice). MouseDeviceé útil especialmente porque você pode marcar Captured nele.

Observe que os eventos que lidam especificamente com eventos de botão do mouse usam uma classe de dados de evento diferente, MouseButtonEventArgs. As propriedades do botão do mouse estão disponíveis MouseEventArgs no caso de haver modos de entrada ou interações que envolvam os botões, mesmo que você esteja tratando um evento que não seja de botão.

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

Construtores

MouseEventArgs(MouseDevice, Int32)	Inicializa uma nova instância da classe MouseEventArgs usando o MouseDevice especificado e o carimbo de data/hora.
MouseEventArgs(MouseDevice, Int32, StylusDevice)	Inicializa uma nova instância da classe MouseEventArgs usando o MouseDevice, o carimbo de data/hora e o StylusDevice especificados.

Propriedades

Device	Obtém o dispositivo de entrada que iniciou esse evento. (Herdado de InputEventArgs)
Handled	Obtém ou define um valor que indica o estado atual de manipulação de eventos para um evento roteado enquanto ele trafega na rota. (Herdado de RoutedEventArgs)
LeftButton	Obtém o estado atual do botão esquerdo do mouse.
MiddleButton	Obtém o estado atual do botão do meio do mouse.
MouseDevice	Obtém o dispositivo de mouse associado a este evento.
OriginalSource	Obtém a origem de relatório original conforme determinada pelo teste de clique puro, antes de qualquer ajuste possível da Source por parte de uma classe pai. (Herdado de RoutedEventArgs)
RightButton	Obtém o estado atual do botão direito do mouse.
RoutedEvent	Obtém ou define o RoutedEvent associado a esta instância do RoutedEventArgs. (Herdado de RoutedEventArgs)
Source	Obtém ou define uma referência ao objeto que ativou o evento. (Herdado de RoutedEventArgs)
StylusDevice	Obtém o dispositivo de caneta associado a este evento.
Timestamp	Obtém a hora em que esse evento ocorreu. (Herdado de InputEventArgs)
XButton1	Obtém o estado atual do primeiro botão de mouse estendido.
XButton2	Obtém o estado do segundo botão do mouse estendido.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetPosition(IInputElement)	Retorna a posição do ponteiro do mouse em relação a um elemento especificado.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InvokeEventHandler(Delegate, Object)	Invoca manipuladores de eventos em uma forma específica de tipo, o que pode aumentar a eficiência do sistema de eventos.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnSetSource(Object)	Quando substituído em uma classe derivada, fornece um ponto de entrada de retorno de chamada de notificação sempre que o valor da propriedade Source de uma instância muda. (Herdado de RoutedEventArgs)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• MouseEventHandler