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 양수이면 위로 이동하고 마우스 휠 DeltaDelta 이 음수 TextBox 이면 아래로 이동하는 예제입니다. 에 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 마우스 휠을 위쪽 또는 앞으로 이동 하는 경우 (사용자에서 멀리) 또는 음수 마우스 휠을 아래로 또는 뒤로 이동 하는 경우 속성은 양수 (사용자 쪽으로).

이 이벤트는 작은 마우스 휠 움직임에 대해서도 발생합니다. 일부 시나리오에서는 델타가 특정 임계값을 초과하는지 확인하여 작은 마우스 휠 델타를 제한하는 처리기를 구현하는 것이 적절합니다. 그렇지 않으면 마우스 휠 델타가 너무 작아서 마우스 휠 이동에 연결된 UI가 업데이트되지 않는 경우 처리기를 호출할 수 있습니다. 처리기에서 임계값 동작을 구현하는 방법과 해당 임계값을 정확히 구현하는 방법은 전적으로 구현에 따라 다릅니다.

생성자

Name	Description
MouseWheelEventArgs(MouseDevice, Int32, Int32)	MouseWheelEventArgs 클래스의 새 인스턴스를 초기화합니다.

속성

Name	Description
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)

메서드

Name	Description
GetPosition(IInputElement)	지정한 요소를 기준으로 마우스 포인터의 위치를 반환합니다. (다음에서 상속됨 MouseEventArgs)
InvokeEventHandler(Delegate, Object)	이벤트 처리기를 형식별 방식으로 호출하여 이벤트 시스템 효율성을 높일 수 있습니다.
OnSetSource(Object)	파생 클래스에서 재정의되는 경우 인스턴스 속성의 Source 값이 변경될 때마다 알림 콜백 진입점을 제공합니다. (다음에서 상속됨 RoutedEventArgs)

추가 정보

• MouseWheelDeltaForOneLine