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. 이 고, 그렇지 마우스 휠 델타가 마우스 휠 움직임에 연결 된 모든 UI 업데이트 되지 않을 정도로 작은 경우에 대 한 처리기를 호출할 수 있습니다.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

RoutedEventArgs 인스턴스와 연결된 RoutedEvent를 가져오거나 설정합니다.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()

현재 개체를 나타내는 string을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

적용 대상

추가 정보