이 페이지에서

MouseEvent QML Type (Uncreatable)

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

Import Statement: import QtQuick

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

속성

상세 설명

마우스의 위치는 x 및 y 속성을 통해 확인할 수 있습니다. 이벤트를 발생시킨 버튼은 button 속성을 통해 확인할 수 있습니다.

MouseArea도 참조하십시오 .

속성 문서

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)보다 오래 누르고 있는 경우 이 속성은 true입니다.

x : real [read-only]

y : real [read-only]

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

© 2026 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.