MouseButtonEventArgs 類別

定義

命名空間:

System.Windows.Input

組件:

PresentationCore.dll

提供滑鼠按鈕相關事件的資料。

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

繼承

Object

EventArgs

RoutedEventArgs

InputEventArgs

MouseEventArgs

MouseButtonEventArgs

範例

以下範例建立一個滑鼠按鈕事件處理程序，會改變引發事件的物件顏色。 顏色選擇取決於所按的滑鼠按鈕。 會檢查該 ChangedButton 屬性以判斷按下了哪個按鈕。

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

備註

MouseButtonEventArgs與以下事件一同使用：MouseDown、、MouseUp、MouseLeftButtonDownMouseLeftButtonUpMouseRightButtonDownMouseRightButtonUp以及相應的隧道事件。

該 Mouse 類別提供額外的屬性與方法來判定滑鼠狀態。

建構函式

名稱	Description
MouseButtonEventArgs(MouseDevice, Int32, MouseButton, StylusDevice)	透過指定的 MouseDevice、 時間戳MouseButton記 、 、 StylusDevice來初始化類別的新MouseButtonEventArgs實例。 。
MouseButtonEventArgs(MouseDevice, Int32, MouseButton)	透過使用指定的 MouseDevice、 時間戳MouseButton和 來初始化類別的新MouseButtonEventArgs實例。

屬性

名稱	Description
ButtonState	取得與事件相關的按鈕狀態。
ChangedButton	拿到與事件相關的按鈕。
ClickCount	會顯示按鈕被點擊的次數。
Device	取得觸發此事件的輸入裝置。 (繼承來源 InputEventArgs)
Handled	取得或設定一個值，表示路由事件在路徑上處理事件的當前狀態。 (繼承來源 RoutedEventArgs)
LeftButton	會顯示滑鼠左鍵的當前狀態。 (繼承來源 MouseEventArgs)
MiddleButton	會顯示滑鼠中鍵的當前狀態。 (繼承來源 MouseEventArgs)
MouseDevice	取得與此事件相關的滑鼠裝置。 (繼承來源 MouseEventArgs)
OriginalSource	取得原始報告來源，這是根據純命中測試確定的，且不會 Source 被父類別可能調整。 (繼承來源 RoutedEventArgs)
RightButton	會顯示右鍵的狀態。 (繼承來源 MouseEventArgs)
RoutedEvent	取得或設定與此RoutedEventArgs實例相關的 。RoutedEvent (繼承來源 RoutedEventArgs)
Source	取得或設定一個指向引發事件的物件的參考。 (繼承來源 RoutedEventArgs)
StylusDevice	取得與此事件相關的觸控筆裝置。 (繼承來源 MouseEventArgs)
Timestamp	取得事件發生的時間點。 (繼承來源 InputEventArgs)
XButton1	會顯示第一個延長滑鼠按鈕的狀態。 (繼承來源 MouseEventArgs)
XButton2	會顯示第二個延長滑鼠按鈕的狀態。 (繼承來源 MouseEventArgs)

方法

名稱	Description
GetPosition(IInputElement)	回傳滑鼠指標相對於指定元素的位置。 (繼承來源 MouseEventArgs)
InvokeEventHandler(Delegate, Object)	以特定類型的方式呼叫事件處理程序，能提升事件系統效率。
OnSetSource(Object)	當在衍生類別中覆寫時，當實例屬性的值 Source 改變時，會提供一個通知回調入口點。 (繼承來源 RoutedEventArgs)

另請參閱

• MouseButtonEventHandler
• MouseEventArgs
• MouseEventHandler
• MouseButtonState
• MouseAction
• Mouse