MouseWheelEventArgs Класс

Определение

Пространство имен:

System.Windows.Input

Сборка:

PresentationCore.dll

Предоставляет данные для различных событий, которые сообщают об изменении значения разностного колесика мыши устройства мыши.

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

Наследование

Object

EventArgs

RoutedEventArgs

InputEventArgs

MouseEventArgs

MouseWheelEventArgs

Примеры

Следующий пример перемещается вверх, если колесико мыши положительное TextBox и перемещается TextBox вниз, если колесико DeltaDelta мыши отрицательное. Присоединен TextBox к объекту 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

Комментарии

MouseWheelEventArgs используется со следующими событиями:

• UIElement.MouseWheel

• ContentElement.MouseWheel

• Mouse.MouseWheel (присоединенное событие)

• UIElement.PreviewMouseWheel

• ContentElement.PreviewMouseWheel

• Mouse.PreviewMouseWheel (присоединенное событие)

Свойство Delta положительно, если колесико мыши перемещается вверх или вперед (от пользователя) или отрицательно, если колесико мыши перемещается вниз или назад (к пользователю).

Это событие поднимается даже для небольших движений колесика мыши. Для некоторых сценариев необходимо реализовать обработчики, которые трогают небольшие разностные колеса мыши, проверяя, превышает ли разностное значение определенного порогового значения. В противном случае обработчик может вызываться в тех случаях, когда разность колесика мыши была настолько мала, что любой пользовательский интерфейс, связанный с движением колесика мыши, не будет обновляться. Точно так же, как вы реализуете пороговое поведение в обработчике и что такое пороговое значение должно быть полностью конкретным для реализации.

Конструкторы

Имя	Описание
MouseWheelEventArgs(MouseDevice, Int32, Int32)	Инициализирует новый экземпляр класса MouseWheelEventArgs.

Свойства

Имя	Описание
Delta	Возвращает значение, указывающее, что колесико мыши изменилось.
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)

Методы

Имя	Описание
GetPosition(IInputElement)	Возвращает позицию указателя мыши относительно указанного элемента. (Унаследовано от MouseEventArgs)
InvokeEventHandler(Delegate, Object)	Вызывает обработчики событий в определенном типе, что может повысить эффективность системы событий.
OnSetSource(Object)	При переопределении в производном классе предоставляет точку входа обратного вызова уведомления при изменении значения Source свойства экземпляра. (Унаследовано от RoutedEventArgs)

См. также раздел

• MouseWheelDeltaForOneLine