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 вверх, если колесико Delta мыши является положительным, и перемещает вниз, TextBox если колесико Delta мыши отрицательное. Объект 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	Возвращает или задает объект RoutedEvent, связанный с этим экземпляром RoutedEventArgs. (Унаследовано от RoutedEventArgs)
Source	Получает или задает ссылку на объект, создавший событие. (Унаследовано от RoutedEventArgs)
StylusDevice	Получает устройство пера, связанное с этим событием. (Унаследовано от MouseEventArgs)
Timestamp	Получает время, когда произошло данное событие. (Унаследовано от InputEventArgs)
XButton1	Получает текущее состояние первой расширенной кнопки мыши. (Унаследовано от MouseEventArgs)
XButton2	Получает текущее состояние второй расширенной кнопки мыши. (Унаследовано от MouseEventArgs)

Методы

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

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

• MouseWheelDeltaForOneLine