MouseArea QML Type

이 속성은 마우스 커서의 좌표를 유지합니다.

hoverEnabled 속성이 거짓인 경우 이 속성은 버튼을 누르고 있는 동안에만 유효하며 마우스를 영역 밖으로 이동하더라도 버튼을 누르고 있는 동안에는 유효합니다.

기본적으로 이 속성은 거짓입니다.

hoverEnabled 가 참이면 이 속성은 다음과 같은 경우에 유효합니다:

• 버튼을 누르지 않았지만 마우스가 MouseArea 영역 내에 있는 경우(containsMouse 은 참입니다).
• 버튼을 누른 후 마우스가 영역 밖으로 이동했더라도 버튼을 누르고 있는 경우.

좌표는 MouseArea 을 기준으로 합니다.

이 속성은 마우스 영역이 반응하는 마우스 버튼을 보유합니다.

MouseArea 이 여러 버튼에 반응하도록 지정하려면 Qt::MouseButtons 플래그 값을 "|"(또는) 연산자를 사용하여 결합합니다:

MouseArea { acceptedButtons: Qt.LeftButton | Qt.RightButton }

가능한 모든 마우스 버튼을 허용하도록 지정하려면 특수 값 'Qt.AllButtons'를 사용할 수 있습니다:

MouseArea { acceptedButtons: Qt.AllButtons }

기본값은 Qt.LeftButton 입니다.

이 속성은 마우스가 현재 마우스 영역 안에 있는지 여부를 유지합니다.

이것은 pressed && containsMouse 과 동등한 편의 속성으로서, 현재 acceptedButtons 중 어느 것이 눌려 있고 마우스가 현재 MouseArea 안에 있는지 여부를 유지합니다.

이 속성은 마우스가 해당 범위 내에 있는 동안 항목을 강조 표시할 때 특히 유용합니다.

pressed 및 containsMouse도 참조하세요 .

이 속성은 이 마우스 영역의 커서 모양을 유지합니다. 마우스 커서를 표시하지 않는 플랫폼에서는 이 속성이 효과가 없을 수 있습니다.

사용 가능한 커서 모양은 다음과 같습니다:

• Qt.ArrowCursor
• Qt.UpArrowCursor
• Qt.CrossCursor
• Qt.WaitCursor
• Qt.IBeamCursor
• Qt.SizeVerCursor
• Qt.SizeHorCursor
• Qt.SizeBDiagCursor
• Qt.SizeFDiagCursor
• Qt.SizeAllCursor
• Qt.BlankCursor
• Qt.SplitVCursor
• Qt.SplitHCursor
• Qt.PointingHandCursor
• Qt.ForbiddenCursor
• Qt.WhatsThisCursor
• Qt.BusyCursor
• Qt.OpenHandCursor
• Qt.ClosedHandCursor
• Qt.DragCopyCursor
• Qt.DragMoveCursor
• Qt.DragLinkCursor

마우스 이벤트에 반응하지 않고 영역에 대한 마우스 커서 모양만 설정하려면 acceptedButtons 을 없음으로 설정합니다:

MouseArea { cursorShape: Qt.IBeamCursor; acceptedButtons: Qt.NoButton }

기본값은 Qt.ArrowCursor 입니다.

Qt::CursorShape 를참조하세요 .

drag 는 항목을 드래그할 수 있게 만드는 편리한 방법을 제공합니다.

• drag.target 드래그할 항목의 ID를 지정합니다.
• drag.active 대상 항목이 현재 드래그 중인지 여부를 지정합니다.
• drag.axis 드래그가 가로로(Drag.XAxis), 세로로(Drag.YAxis) 또는 둘 다(Drag.XAndYAxis) 수행될 수 있는지 여부를 지정합니다.
• drag.minimum 와 drag.maximum 는 해당 축을 따라 대상을 끌 수 있는 거리를 제한합니다.

다음 예제에서는 X축을 따라 끌 수 있는 Rectangle 을 표시합니다. 직사각형을 오른쪽으로 끌면 직사각형의 불투명도가 감소합니다.

Rectangle {
    id: container
    width: 600; height: 200

    Rectangle {
        id: rect
        width: 50; height: 50
        color: "red"
        opacity: (600.0 - rect.x) / 600

        MouseArea {
            anchors.fill: parent
            drag.target: rect
            drag.axis: Drag.XAxis
            drag.minimumX: 0
            drag.maximumX: container.width - rect.width
        }
    }
}

drag.filterChildren 을 true로 설정하면 드래그가 하위 마우스 영역을 재정의할 수 있습니다. 이렇게 하면 예를 들어 부모 MouseArea 가 드래그를 처리하고 자손은 클릭을 처리할 수 있습니다:

import QtQuick

Rectangle {
    width: 480
    height: 320
    Rectangle {
        x: 30; y: 30
        width: 300; height: 240
        color: "lightsteelblue"

        MouseArea {
            anchors.fill: parent
            drag.target: parent;
            drag.axis: "XAxis"
            drag.minimumX: 30
            drag.maximumX: 150
            drag.filterChildren: true

            Rectangle {
                color: "yellow"
                x: 50; y : 50
                width: 100; height: 100
                MouseArea {
                    anchors.fill: parent
                    onClicked: console.log("Clicked")
                }
            }
        }
    }
}

drag.threshold 드래그 작업이 시작되어야 하는 시점의 임계값을 픽셀 단위로 결정합니다. 기본적으로 이 값은 플랫폼 종속 값에 바인딩됩니다. 이 속성은 Qt Quick 2.2에서 추가되었습니다.

drag.smoothed 이 true 인 경우 드래그 작업이 시작된 후에만 대상이 이동합니다. false 으로 설정하면 대상이 현재 마우스 위치로 바로 이동합니다. 기본적으로 이 속성은 true 입니다. 이 속성은 Qt Quick 2.4에서 추가되었습니다.

Drag 첨부 속성 및 DropArea 을 참조하세요.

이 속성은 항목의 마우스 이벤트 수락 여부를 저장합니다.

기본적으로 이 속성은 true입니다.

이 속성은 호버 이벤트 처리 여부를 보유합니다.

기본적으로 마우스 이벤트는 버튼 이벤트에 대한 응답 또는 버튼을 눌렀을 때만 처리됩니다. 호버를 사용하면 마우스 버튼을 누르지 않아도 모든 마우스 이벤트를 처리할 수 있습니다.

이 프로퍼티는 containsMouse 프로퍼티와 onEntered, onExited 및 onPositionChanged 신호에 영향을 줍니다.

이 속성은 pressAndHold 이벤트가 발생하기까지의 경과 시간(밀리초)을 재정의합니다.

명시적으로 설정되지 않았거나 재설정된 후 값은 QStyleHints::mousePressAndHoldInterval 을 따릅니다.

일반적으로 애플리케이션 스타일 힌트를 사용하여 이 속성을 전역적으로 설정하는 것으로 충분합니다. 특정 마우스 영역에 대해 다양한 간격이 필요한 경우 이 속성을 사용해야 합니다.

pressAndHold 를참조하세요 .

이 속성은 현재 acceptedButtons 중 어느 것이 눌려 있는지 여부를 저장합니다.

이 속성은 현재 누르고 있는 마우스 버튼을 보유합니다.

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

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

아래 코드는 마우스 오른쪽 버튼을 눌렀을 때 "오른쪽"을 표시합니다:

Text {
    text: mouseArea.pressedButtons & Qt.RightButton ? "right" : ""
    horizontalAlignment: Text.AlignHCenter
    verticalAlignment: Text.AlignVCenter

    MouseArea {
        id: mouseArea
        anchors.fill: parent
        acceptedButtons: Qt.LeftButton | Qt.RightButton
    }
}

acceptedButtons 를참조하세요 .

이 속성은 마우스 이벤트가 이 MouseArea 에서 도용될 수 있는지 여부를 보유합니다.

Flickable과 같이 하위 마우스 이벤트를 필터링하는 항목 내에 MouseArea 이 있는 경우, 상위 항목에서 제스처(예: 플릭 제스처)를 인식하면 MouseArea 에서 마우스 이벤트가 도용될 수 있습니다. preventStealing을 true로 설정하면 어떤 항목도 마우스 이벤트를 훔치지 않습니다.

항목이 이벤트를 훔치기 시작한 후 preventStealing을 true로 설정하면 다음 프레스 이벤트가 발생할 때까지 아무런 영향을 미치지 않습니다.

기본적으로 이 속성은 false입니다.

이 속성은 구성된 마우스 이벤트가 이 MouseArea 와 겹치지만 시각적 스택 순서에서 더 낮은 다른 마우스 영역으로 자동으로 전파될지 여부를 보유합니다. 기본적으로 이 속성은 거짓입니다.

MouseArea 에는 여러 개의 컴포즈된 이벤트가 포함됩니다: clicked, doubleClicked 및 pressAndHold. 이들은 pressed 와 같은 기본 마우스 이벤트로 구성되며 기본 이벤트와 비교하여 다르게 전파될 수 있습니다.

propagateComposedEvents를 true로 설정하면 컴포짓 이벤트가 씬의 같은 위치에 있는 다른 마우스 영역으로 자동으로 전파됩니다. 각 이벤트는 스택 순서대로 그 아래에 있는 다음 enabled MouseArea 으로 전파되며, MouseArea 이 이벤트를 수락할 때까지 시각적 계층 구조를 따라 전파됩니다. pressed 이벤트와 달리 컴포짓 이벤트는 핸들러가 없으면 자동으로 수락되지 않습니다.

예를 들어 아래는 파란색 Rectangle 을 포함하는 노란색 Rectangle 입니다. 파란색 직사각형은 시각적 스택 순서 계층 구조에서 가장 위에 있는 항목으로 노란색 직사각형 위에 시각적으로 렌더링됩니다. 파란색 직사각형은 모든 수신된 clicked 이벤트에 대해 propagateComposedEvents를 true로 설정하고 MouseEvent::accepted 도 false로 설정하므로, 이 직사각형이 수신하는 모든 clicked 이벤트는 그 아래 노란색 직사각형의 MouseArea 로 전파됩니다.

import QtQuick 2.0

Rectangle {
    color: "yellow"
    width: 100; height: 100

    MouseArea {
        anchors.fill: parent
        onClicked: console.log("clicked yellow")
    }

    Rectangle {
        color: "blue"
        width: 50; height: 50

        MouseArea {
            anchors.fill: parent
            propagateComposedEvents: true
            onClicked: (mouse)=> {
                console.log("clicked blue")
                mouse.accepted = false
            }
        }
    }
}

파란색 직사각형을 클릭하면 그 자식 MouseArea 의 onClicked 핸들러가 호출되고, 이벤트가 노란색 직사각형의 MouseArea 로 전파되어 자체 onClicked 핸들러가 호출됩니다.

이 프로퍼티는 겹치는 마우스 영역이 함께 구성된 이벤트를 처리하도록 하려는 경우의 사용 사례를 크게 간소화합니다. 예를 들어 MouseArea 하나는 clicked 신호를 처리하고 다른 하나는 pressAndHold 를 처리하도록 하거나, MouseArea 하나는 대부분 clicked 를 처리하지만 특정 조건이 충족될 때만 통과시키려는 경우입니다.

이 속성은 트랙패드의 두 손가락 플릭 제스처와 같이 마우스가 아닌 장치의 스크롤 제스처에 MouseArea 이 응답할지 여부를 제어합니다. false로 설정하면 휠이 있는 실제 마우스에서 휠 이벤트가 발생할 때만 wheel 신호가 발생하고 스크롤 제스처 이벤트는 이를 처리할 다른 항목으로 전달됩니다. 예를 들어, 사용자가 MouseArea 이 포함된 항목 위에 커서가 있는 동안 플릭 제스처를 수행하여 그 아래에 있는 플릭 가능 항목과 상호 작용하려고 할 수 있습니다. 이 속성을 false로 설정하면 PinchArea 이 마우스 휠이나 핀치 제스처를 처리하고 Flickable은 플릭 제스처를 처리합니다.

기본적으로 이 속성은 참입니다.

이 신호는 다른 항목이 마우스 이벤트 처리를 도용하여 마우스 이벤트가 취소된 경우에 발생합니다.

이 신호는 입력을 처리하는 MouseArea 이 두 개 이상 있거나 Flickable 안에 MouseArea 이 있을 때 유용합니다. 후자의 경우 onPressed 신호 핸들러에서 일부 로직을 실행한 다음 드래그를 시작하면 Flickable 이 MouseArea 에서 마우스 핸들링을 훔칩니다. 이러한 경우 MouseArea 이 Flickable 로 마우스 핸들링을 잃었을 때 로직을 재설정하려면 released 외에 canceled 을 처리해야 합니다.

이 신호는 클릭이 있을 때 발생합니다. 클릭은 MouseArea 안에서 누른 후 손을 떼는 것으로 정의됩니다(누른 후 MouseArea 밖으로 이동했다가 다시 안으로 이동한 후 손을 떼는 것도 클릭으로 간주됨).

mouse 매개변수는 클릭 릴리즈의 x 및 y 위치, 클릭이 유지되었는지 여부 등 클릭에 대한 정보를 제공합니다.

이 신호를 처리할 때 mouse 파라미터의 accepted 속성을 변경해도 propagateComposedEvents 속성이 true 이 아닌 한 아무런 영향을 미치지 않습니다.

이 신호는 더블 클릭(누른 후 놓았다가 다시 누르는 클릭)이 있을 때 발생합니다. mouse 매개변수는 클릭 릴리즈의 x 및 y 위치, 클릭이 유지되었는지 여부 등 클릭에 대한 정보를 제공합니다.

이 신호를 처리할 때 mouse 파라미터의 accepted 속성이 false로 설정되어 있으면 두 번째 클릭에 대해 눌렀다/놓았다/클릭 신호가 발생하고, 그렇지 않으면 신호가 억제됩니다. accepted 속성의 기본값은 참입니다.

이 신호는 마우스가 마우스 영역에 들어올 때 발생합니다.

기본적으로 이 신호는 현재 버튼을 누르고 있는 경우에만 발생합니다. 마우스 버튼을 누르지 않은 상태에서도 이 신호를 발생시키려면 hoverEnabled 을 true로 설정합니다.

hoverEnabled도 참조하세요 .

이 신호는 마우스가 마우스 영역을 벗어날 때 발생합니다.

기본적으로 이 신호는 현재 버튼을 누르고 있는 경우에만 발생합니다. 마우스 버튼을 누르지 않아도 이 신호를 내보내려면 hoverEnabled 을 true로 설정합니다.

아래 예는 mouseArea1 위에 mouseArea2 가 있는 두 마우스 영역 간의 일반적인 관계를 보여줍니다. 마우스를 mouseArea1 에서 mouseArea2 로 이동하면 mouseArea1 에서 exited 신호가 발생합니다.

Rectangle {
    width: 400; height: 400
    MouseArea {
        id: mouseArea1
        anchors.fill: parent
        hoverEnabled: true
    }
    MouseArea {
        id: mouseArea2
        width: 100; height: 100
        anchors.centerIn: parent
        hoverEnabled: true
    }
}

대신 두 마우스 영역에 부모-자식 관계를 부여하면 mouseArea1 에서 mouseArea2 로 마우스를 이동해도 mouseArea1 가 exited 를 방출하지 않습니다. 대신 둘 다 동시에 마우스오버된 것으로 간주됩니다.

hoverEnabled도 참조하세요 .

이 신호는 마우스 위치가 변경될 때 발생합니다.

mouse 매개변수는 마우스에 대한 정보(x 및 y 위치, 현재 누른 버튼 포함)를 제공합니다.

기본적으로 이 신호는 현재 버튼을 누른 경우에만 발생합니다. 마우스 버튼을 누르지 않은 상태에서도 이 신호를 보내려면 hoverEnabled 을 true로 설정합니다.

이 신호를 처리할 때 mouse 매개 변수의 accepted 속성을 변경해도 아무런 영향을 미치지 않습니다.

이 신호는 길게 누를 때(현재 800ms) 발생합니다. mouse 매개변수는 프레스의 x 및 y 위치, 어떤 버튼을 눌렀는지 등 프레스에 대한 정보를 제공합니다.

이 신호를 처리할 때 mouse 파라미터의 accepted 속성을 변경해도 propagateComposedEvents 속성이 true 이 아닌 한 아무런 영향을 미치지 않습니다.

이 신호는 버튼을 눌렀을 때 발생합니다. mouse 매개변수는 x 및 y 위치, 눌렀던 버튼 등 누름에 대한 정보를 제공합니다.

이 신호를 처리할 때 mouse 매개변수의 accepted 속성을 사용하여 MouseArea 이 누름을 처리할지 여부와 향후 마우스 이벤트를 모두 처리할지 여부를 제어합니다. 기본값은 이벤트를 수락하고 이 마우스 영역 아래의 다른 마우스 영역이 이벤트를 처리하지 못하도록 하는 것입니다. Accept를 false로 설정하면 다음 버튼을 누를 때까지 이 MouseArea 으로 더 이상의 이벤트가 전송되지 않습니다.

이 신호는 릴리스가 있을 때 전송됩니다. mouse 매개 변수는 클릭 릴리즈의 x 및 y 위치, 클릭이 유지되었는지 여부 등 클릭에 대한 정보를 제공합니다.

이 신호를 처리할 때 mouse 매개 변수의 accepted 속성을 변경해도 아무런 영향을 미치지 않습니다.

canceled도 참조하세요 .

이 신호는 마우스 휠 및 트랙패드 스크롤 제스처 모두에 대한 응답으로 발생합니다.

wheel 매개변수는 x 및 y 위치, 현재 누른 모든 버튼, 각도 델타 및 픽셀 델타를 포함한 휠 움직임에 대한 정보 등 이벤트에 대한 정보를 제공합니다.