MouseWheelEventArgs Класс

Определение

Предоставляет данные для различных событий, сообщающих о перемещении колесика мыши.Provides data for various events that report changes to the mouse wheel delta value of a mouse device.

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 , если колесико мыши отрицательное.The following example moves a TextBox up if the mouse wheel Delta is positive and moves the TextBox down if the mouse wheel Delta is negative. Объект TextBox прикрепляется Canvasк.The TextBox is attached to a 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используется со следующими событиями:MouseWheelEventArgs is used with the following events:

Delta Свойство имеет положительное значение, если колесо мыши перемещается вверх или вниз (от пользователя) или отрицательным, если колесико мыши перемещается вниз или назад (в сторону пользователя).The Delta property is positive if the mouse wheel is moved upward or forward (away from the user) or negative if the mouse wheel is moved downward or backward (toward the user).

Это событие возникает даже при малых перемещениях колесика мыши.This event is raised even for small mouse wheel movements. В некоторых сценариях можно реализовать обработчики, которые регулируют небольшие изменения колесика мыши, проверяя, превышает ли разница определенное пороговое значение.For some scenarios, it is appropriate to implement handlers that throttle small mouse wheel deltas by checking whether the delta exceeds a certain threshold. В противном случае вы можете вызвать обработчик для случаев, когда Дельта колесика мыши было настолько маленьким, что любой пользовательский интерфейс, привязанный к перемещению колесика мыши, не будет обновляться.Otherwise, you might invoke your handler for cases where the mouse wheel delta was so small that any UI that is tied to the mouse wheel movement would not update. Точно так же, как вы реализуете пороговое поведение в обработчике, и что это пороговое значение должно быть полностью зависит от реализации.Exactly how you implement the threshold behavior in a handler and what that threshold should be is entirely implementation-specific.

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

MouseWheelEventArgs(MouseDevice, Int32, Int32)

Инициализирует новый экземпляр класса MouseWheelEventArgs.Initializes a new instance of the MouseWheelEventArgs class.

Свойства

Delta

Получает значение, указывающее на какую величину переместилось колесико мыши.Gets a value that indicates the amount that the mouse wheel has changed.

Device

Получает устройство ввода, инициировавшее это событие.Gets the input device that initiated this event.

(Унаследовано от InputEventArgs)
Handled

Получает или задает значение, обозначающее текущее состояние обработки перенаправленного события при перемещении по маршруту.Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.

(Унаследовано от RoutedEventArgs)
LeftButton

Получает текущее состояние левой кнопки мыши.Gets the current state of the left mouse button.

(Унаследовано от MouseEventArgs)
MiddleButton

Получает текущее состояние средней кнопки мыши.Gets the current state of the middle mouse button.

(Унаследовано от MouseEventArgs)
MouseDevice

Получает устройство мыши, связанное с этим событием.Gets the mouse device associated with this event.

(Унаследовано от MouseEventArgs)
OriginalSource

Возвращает исходный источник отчетов, определяемый чистой проверкой нажатия до какой-либо возможной корректировки Source родительским классом.Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class.

(Унаследовано от RoutedEventArgs)
RightButton

Получает текущее состояние правой кнопки мыши.Gets the current state of the right mouse button.

(Унаследовано от MouseEventArgs)
RoutedEvent

Возвращает или задает объект RoutedEvent, связанный с этим экземпляром RoutedEventArgs.Gets or sets the RoutedEvent associated with this RoutedEventArgs instance.

(Унаследовано от RoutedEventArgs)
Source

Получает или задает ссылку на объект, создавший событие.Gets or sets a reference to the object that raised the event.

(Унаследовано от RoutedEventArgs)
StylusDevice

Получает устройство пера, связанное с этим событием.Gets the stylus device associated with this event.

(Унаследовано от MouseEventArgs)
Timestamp

Получает время, когда произошло данное событие.Gets the time when this event occurred.

(Унаследовано от InputEventArgs)
XButton1

Получает текущее состояние первой расширенной кнопки мыши.Gets the current state of the first extended mouse button.

(Унаследовано от MouseEventArgs)
XButton2

Получает текущее состояние второй расширенной кнопки мыши.Gets the state of the second extended mouse button.

(Унаследовано от MouseEventArgs)

Методы

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetPosition(IInputElement)

Возвращает позицию указателя мыши относительно заданного элемента.Returns the position of the mouse pointer relative to the specified element.

(Унаследовано от MouseEventArgs)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
InvokeEventHandler(Delegate, Object)

Вызывает обработчики событий способом, зависящим от типа, что может повысить эффективность системы событий.Invokes event handlers in a type-specific way, which can increase event system efficiency.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnSetSource(Object)

При переопределении в производном классе предоставляет точку входа обратного вызова для уведомления в случае изменения значения свойства Source в экземпляре.When overridden in a derived class, provides a notification callback entry point whenever the value of the Source property of an instance changes.

(Унаследовано от RoutedEventArgs)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

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

Дополнительно