WheelEvent QML Type

이 프로퍼티는 휠 이벤트에서 제공한 위치 좌표를 보유합니다.

QWheelEvent::position()도 참조하세요 .

accepted 을 true 으로 설정하면 휠 이벤트가 수신 항목 또는 핸들러 아래의 항목으로 전파되지 않습니다.

일반적으로 항목이 휠 이벤트에 반응하는 경우 스택 순서에서 더 낮은 항목도 동일한 이벤트에 반응하지 않도록 허용해야 합니다.

QWheelEvent::accepted 를참조하세요 .

이 속성은 휠이 회전한 상대적인 양을 8분의 1도 단위로 보유합니다. 이 속성의 x 및 y 좌표는 각각 가로 및 세로 방향의 델타를 보유합니다.

양수 값은 휠이 위/오른쪽으로 회전했음을 나타내고 음수 값은 휠이 아래/왼쪽으로 회전했음을 나타냅니다.

대부분의 마우스 유형은 15 도의 단계로 작동하며, 이 경우 델타 값은 120 의 배수, 즉 120 units * 1/8 = 15 degrees 입니다.

QWheelEvent::angleDelta()도 참조하세요 .

이 프로퍼티는 휠 이벤트가 생성될 때 눌린 마우스 버튼을 보유합니다.

여기에는 비트 단위의 조합이 포함됩니다:

• Qt.LeftButton
• Qt.RightButton
• Qt.MiddleButton

QWheelEvent::buttons()참조 .

이벤트와 함께 전달된 델타 값이 반전되었는지 여부를 반환합니다.

일반적으로 수직 휠은 휠의 위쪽이 휠을 조작하는 손에서 멀어지면 델타 값이 양수인 WheelEvent 를 생성합니다. 마찬가지로 수평으로 휠을 움직일 때 휠의 상단이 왼쪽으로 이동하면 델타 값이 양수인 QWheelEvent 이 생성됩니다.

그러나 일부 플랫폼에서는 위에서 설명한 것과 동일한 작업을 수행하면 음의 델타 값을 생성하도록 구성할 수 있습니다(크기는 같지만). 예를 들어, 시스템 설정에 관계없이 항목의 이동 또는 회전을 휠의 방향과 동기화하는 것이 적절한 QML 컴포넌트(예: 텀블러 또는 슬라이더)에서는 휠 이벤트 핸들러가 반전 속성을 사용하여 angleDelta 또는 pixelDelta 값을 무효화할지 여부를 결정할 수 있습니다.

QWheelEvent::inverted()도 참조하세요 .

이 속성은 이벤트가 발생하기 직전에 존재했던 키보드 수정자 플래그를 보유합니다.

비트 단위의 조합을 포함합니다:

• Qt.NoModifier - 수정자 키를 누르지 않았습니다.
• Qt.ShiftModifier - 키보드의 Shift 키를 눌렀습니다.
• Qt.ControlModifier - 키보드의 Ctrl 키를 눌렀습니다.
• Qt.AltModifier - 키보드의 Alt 키를 눌렀습니다.
• Qt.MetaModifier - 키보드의 메타 키를 누릅니다.
• Qt.KeypadModifier - 키패드 버튼을 누릅니다.

예를 들어 휠 이벤트 중에 Control 키를 눌렀을 때 반응합니다:

WheelHandler {
    onWheel: (wheel)=> {
        if (wheel.modifiers & Qt.ControlModifier) {
            adjustZoom(wheel.angleDelta.y / 120);
        }
    }
}

QWheelEvent::modifiers()도 참조하세요 .

이 속성은 화면 픽셀 단위의 델타를 보유하며, macOS와 같이 고해상도( trackpads)를 지원하는 플랫폼에서 사용할 수 있습니다. 이 프로퍼티의 x 및 y 좌표는 각각 가로 및 세로 방향으로 델타를 유지합니다. 이 값은 화면에서 콘텐츠를 스크롤하는 데 직접 사용할 수 있습니다.

high-resolution trackpad 을 지원하지 않는 플랫폼의 경우 pixelDelta 는 항상 (0,0) 이며, angleDelta 을 대신 사용해야 합니다.

QWheelEvent::pixelDelta()도 참조하세요 .