MouseWheelEventArgs Класс

Определение

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

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
Наследование

Примеры

Следующий пример перемещает 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 используется со следующими событиями:

Свойство 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)

Применяется к

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