MouseEvent QML Type

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

Import Statement: import QtQuick

속성

자세한 설명

마우스 위치는 xy 속성을 통해 확인할 수 있습니다. 이벤트를 일으킨 버튼은 button 속성을 통해 확인할 수 있습니다.

MouseArea참조하세요 .

속성 문서

x : real [read-only]

y : real [read-only]

이 속성은 마우스 이벤트가 제공한 위치의 좌표를 보유합니다.


accepted : bool

accepted 을 true로 설정하면 마우스 이벤트가 이 항목 아래의 항목으로 전파되지 않습니다.

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


button : enumeration [read-only]

이 속성은 이벤트를 발생시킨 버튼을 보유합니다. 다음 중 하나가 될 수 있습니다:


buttons : int [read-only]

이 속성은 이벤트가 생성될 때 눌린 마우스 버튼을 저장합니다. 마우스 이동 이벤트의 경우 눌려진 모든 버튼을 저장합니다. 마우스 누르기 및 더블 클릭 이벤트의 경우 이벤트의 원인이 된 버튼을 포함합니다. 마우스 놓기 이벤트의 경우 이벤트를 일으킨 버튼은 제외됩니다.

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


flags : int [read-only]

이 프로퍼티에는 마우스 이벤트에 대한 추가 정보를 제공하는 플래그가 포함됩니다.

  • Qt.MouseEventCreatedDoubleClick - Qt가 이 이벤트에서 더블 클릭 이벤트를 생성했음을 나타냅니다. 이 플래그는 결과인 더블 클릭 이벤트가 아니라 버튼 누름에서 발생한 이벤트에 설정됩니다.

modifiers : int [read-only]

이 프로퍼티는 이벤트 발생 직전에 존재했던 키보드 수정자 플래그를 보유합니다.

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

예를 들어 Shift 키 + 마우스 왼쪽 버튼 클릭에 반응합니다:

MouseArea {
    onClicked: (mouse)=> {
        if ((mouse.button == Qt.LeftButton) && (mouse.modifiers & Qt.ShiftModifier))
            doSomething();
    }
}

wasHeld : bool [read-only]

이 속성은 마우스 버튼을 임계값(800ms)보다 길게 누르고 있는 경우에 해당합니다.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.