MouseWheelEventArgs Kelas

Definisi

Ruang nama:

System.Windows.Input

Rakitan:

PresentationCore.dll

Menyediakan data untuk berbagai peristiwa yang melaporkan perubahan pada nilai delta roda mouse dari perangkat mouse.

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

public class MouseWheelEventArgs : System.Windows.Input.MouseEventArgs

type MouseWheelEventArgs = class
    inherit MouseEventArgs

Public Class MouseWheelEventArgs
Inherits MouseEventArgs

Warisan

Object

EventArgs

RoutedEventArgs

InputEventArgs

MouseEventArgs

MouseWheelEventArgs

Contoh

Contoh berikut bergerak ke TextBox atas jika roda Delta mouse positif dan menggerakkan ke TextBox bawah jika roda Delta mouse negatif. TextBox dilampirkan ke Canvas.

// Moves the TextBox named box when the mouse wheel is rotated.
// The TextBox is on a Canvas named MainCanvas.
private void MouseWheelHandler(object sender, MouseWheelEventArgs e)
{
    // If the mouse wheel delta is positive, move the box up.
    if (e.Delta > 0)
    {
        if (Canvas.GetTop(box) >= 1)
        {
            Canvas.SetTop(box, Canvas.GetTop(box) - 1);
        }
    }

    // If the mouse wheel delta is negative, move the box down.
    if (e.Delta < 0)
    {
        if ((Canvas.GetTop(box) + box.Height) <= (MainCanvas.Height))
        {
            Canvas.SetTop(box, Canvas.GetTop(box) + 1);
        }
    }
}

' Moves the TextBox named box when the mouse wheel is rotated.
' The TextBox is on a Canvas named MainCanvas.
Private Sub MouseWheelHandler(ByVal sender As Object, ByVal e As MouseWheelEventArgs)
    ' If the mouse wheel delta is positive, move the box up.
    If e.Delta > 0 Then
        If Canvas.GetTop(box) >= 1 Then
            Canvas.SetTop(box, Canvas.GetTop(box) - 1)
        End If
    End If

    ' If the mouse wheel delta is negative, move the box down.
    If e.Delta < 0 Then
        If (Canvas.GetTop(box) + box.Height) <= MainCanvas.Height Then
            Canvas.SetTop(box, Canvas.GetTop(box) + 1)
        End If
    End If

End Sub

Keterangan

MouseWheelEventArgs digunakan dengan peristiwa berikut:

• UIElement.MouseWheel

• ContentElement.MouseWheel

• Mouse.MouseWheel (kejadian terlampir)

• UIElement.PreviewMouseWheel

• ContentElement.PreviewMouseWheel

• Mouse.PreviewMouseWheel (kejadian terlampir)

Properti Delta positif jika roda mouse dipindahkan ke atas atau ke depan (menjauh dari pengguna) atau negatif jika roda mouse dipindahkan ke bawah atau mundur (ke arah pengguna).

Acara ini dinaikkan bahkan untuk gerakan roda mouse kecil. Untuk beberapa skenario, tepat untuk menerapkan handler yang membatasi delta roda mouse kecil dengan memeriksa apakah delta melebihi ambang tertentu. Jika tidak, Anda mungkin memanggil handler Anda untuk kasus di mana delta roda mouse sangat kecil sehingga UI apa pun yang terkait dengan gerakan roda mouse tidak akan diperbarui. Persis bagaimana Anda menerapkan perilaku ambang batas dalam handler dan ambang batas apa yang harus sepenuhnya spesifik untuk implementasi.

Konstruktor

MouseWheelEventArgs(MouseDevice, Int32, Int32)

Menginisialisasi instans baru kelas MouseWheelEventArgs.

Properti

Delta	Mendapatkan nilai yang menunjukkan jumlah roda mouse yang telah berubah.
Device	Mendapatkan perangkat input yang memulai kejadian ini. (Diperoleh dari InputEventArgs)
Handled	Mendapatkan atau menetapkan nilai yang menunjukkan status penanganan peristiwa saat ini untuk peristiwa yang dirutekan saat melakukan perjalanan rute. (Diperoleh dari RoutedEventArgs)
LeftButton	Mendapatkan status tombol kiri mouse saat ini. (Diperoleh dari MouseEventArgs)
MiddleButton	Mendapatkan status tombol mouse tengah saat ini. (Diperoleh dari MouseEventArgs)
MouseDevice	Mendapatkan perangkat mouse yang terkait dengan kejadian ini. (Diperoleh dari MouseEventArgs)
OriginalSource	Mendapatkan sumber pelaporan asli sebagaimana ditentukan oleh pengujian hit murni, sebelum kemungkinan Source penyesuaian oleh kelas induk. (Diperoleh dari RoutedEventArgs)
RightButton	Mendapatkan status tombol kanan mouse saat ini. (Diperoleh dari MouseEventArgs)
RoutedEvent	Mendapatkan atau mengatur yang RoutedEvent terkait dengan instans ini RoutedEventArgs . (Diperoleh dari RoutedEventArgs)
Source	Mendapatkan atau mengatur referensi ke objek yang memunculkan peristiwa. (Diperoleh dari RoutedEventArgs)
StylusDevice	Mendapatkan perangkat stylus yang terkait dengan kejadian ini. (Diperoleh dari MouseEventArgs)
Timestamp	Mendapatkan waktu ketika peristiwa ini terjadi. (Diperoleh dari InputEventArgs)
XButton1	Mendapatkan status saat ini dari tombol mouse yang diperluas pertama. (Diperoleh dari MouseEventArgs)
XButton2	Mendapatkan status tombol mouse kedua yang diperluas. (Diperoleh dari MouseEventArgs)

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetPosition(IInputElement)	Mengembalikan posisi penunjuk mouse relatif terhadap elemen yang ditentukan. (Diperoleh dari MouseEventArgs)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
InvokeEventHandler(Delegate, Object)	Memanggil penanganan aktivitas dengan cara khusus jenis, yang dapat meningkatkan efisiensi sistem peristiwa.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnSetSource(Object)	Saat ditimpa di kelas turunan, berikan titik masuk panggilan balik pemberitahuan setiap kali nilai Source properti instans berubah. (Diperoleh dari RoutedEventArgs)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• MouseWheelDeltaForOneLine