WheelEvent QML Type (Uncreatable)

마우스 휠 이벤트에 대한 정보를 제공합니다. 더 보기...

참고: 이 타입은 생성할 수 없는 타입입니다. QML에서 인스턴스화할 수 없습니다.

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• accepted : bool
• angleDelta : point
• buttons : int
• inverted : bool
• modifiers : int
• pixelDelta : point
• x : real
• y : real

상세 설명

마우스의 위치는 x 및 y 속성을 통해 확인할 수 있습니다.

WheelHandler 및 MouseArea항목도 참조하십시오 .

속성 설명서

accepted : bool

accepted 를 true 로 설정하면, 휠 이벤트가 수신 항목이나 핸들러 아래에 있는 항목들로 전파되는 것을 방지할 수 있습니다.

일반적으로, 항목이 휠 이벤트에 반응하는 경우, 스태킹 순서상 더 아래에 있는 항목들이 동일한 이벤트에 반응하지 않도록 해당 이벤트를 수락해야 합니다.

QWheelEvent::accepted도 참조하십시오 .

angleDelta : point [read-only]

이 속성은 휠이 회전된 상대적 각도를 8분의 1도 단위로 저장합니다. 이 속성의 x 및 y 좌표는 각각 수평 및 수직 방향의 각도 변화를 나타냅니다.

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

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

QWheelEvent::angleDelta()도 참조하십시오 .

buttons : int [read-only]

이 속성은 휠 이벤트가 발생했을 때 눌려 있던 마우스 버튼을 저장합니다.

이 속성은 다음 항목들의 비트 단위 조합을 포함합니다:

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

QWheelEvent::buttons()도 참조하십시오 .

inverted : bool [read-only]

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

일반적으로 수직 휠의 경우, 휠 상단이 조작하는 손에서 멀어지는 방향으로 회전하면 양의 델타 값을 가진 WheelEvent 가 생성됩니다. 마찬가지로, 수평 휠의 경우 휠 상단이 왼쪽으로 이동하면 양의 델타 값을 가진 QWheelEvent 가 생성됩니다.

그러나 일부 플랫폼에서는 이 설정을 변경할 수 있으므로, 위에서 설명한 것과 동일한 조작이 음의 델타 값(단, 크기는 동일)을 생성할 수도 있습니다. 예를 들어, 시스템 설정과 관계없이 항목의 이동이나 회전을 휠의 방향과 동기화하는 것이 적절한 QML 컴포넌트(텀블러나 슬라이더 등)의 경우, 휠 이벤트 핸들러는 inverted 속성을 사용하여 angleDelta 또는 pixelDelta 값을 반전시킬지 여부를 결정할 수 있습니다.

QWheelEvent::inverted()도 참조하십시오 .

modifiers : int [read-only]

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

이 속성은 다음 항목들의 비트 단위 조합을 포함합니다:

• Qt.NoModifier - 수정 키가 누르지 않은 상태.
• Qt.ShiftModifier - 키보드의 Shift 키가 눌려 있음.
• Qt.ControlModifier - 키보드의 Ctrl 키가 눌려 있는 상태.
• Qt.AltModifier - 키보드의 Alt 키가 눌려 있음.
• Qt.MetaModifier - 키보드의 Meta 키가 눌려 있습니다.
• Qt.KeypadModifier - 숫자 키패드 버튼이 눌렸습니다.

예를 들어, 휠 이벤트 발생 중에 Control 키가 눌린 경우에 반응하려면:

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

QWheelEvent::modifiers()도 참조하십시오 .

pixelDelta : point [read-only]

이 속성은 화면 픽셀 단위의 변위량을 저장하며, macOS와 같이 고해상도 trackpads 를 지원하는 플랫폼에서 사용할 수 있습니다. 이 속성의 x 및 y 좌표는 각각 가로 및 세로 방향의 변위량을 나타냅니다. 이 값을 직접 사용하여 화면상의 콘텐츠를 스크롤할 수 있습니다.

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

QWheelEvent::pixelDelta()도 참조하십시오 .

이 속성들은 휠 이벤트에서 제공된 위치의 좌표를 저장합니다.

QWheelEvent::position()도 참조하십시오 .