QWheelEvent Class

멤버 함수 문서

QWheelEvent::QWheelEvent(const QPointF &pos, const QPointF &globalPos, QPoint pixelDelta, QPoint angleDelta, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, Qt::ScrollPhase phase, bool inverted, Qt::MouseEventSource source = Qt::MouseEventNotSynthesized, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())

휠 이벤트 객체를 생성합니다.

pos 은 창 내에서 마우스 커서의 위치를 제공합니다. 전역 좌표의 위치는 globalPos 로 지정됩니다.

pixelDelta 는 화면에서 픽셀 단위의 스크롤 거리를 포함하고 angleDelta 는 휠 회전 각도를 포함합니다. pixelDelta 은 선택 사항이며 null일 수 있습니다.

이벤트 발생 시 마우스 및 키보드 상태는 buttons 및 modifiers 에 의해 지정됩니다.

이벤트의 스크롤 단계는 phase 에 의해 지정되며 source 은 이것이 진짜 이벤트인지 인위적인(합성된) 이벤트인지를 나타냅니다.

시스템이 이벤트와 함께 전달되는 델타 값을 반전하도록 구성된 경우(예: macOS의 터치패드 자연 스크롤) inverted 은 true 이어야 합니다. 그렇지 않으면 inverted 입니다. false

휠 이벤트가 발생한 장치는 device 로 지정됩니다.

position(), globalPosition(), angleDelta(), pixelDelta(), phase(), inverted(), device()도 참조하세요 .

QPoint QWheelEvent::angleDelta() const

휠이 회전한 상대적인 양을 8분의 1도 단위로 반환합니다. 양수 값은 휠이 사용자로부터 앞으로 회전했음을 나타내고 음수 값은 휠이 사용자 쪽으로 뒤로 회전했음을 나타냅니다. angleDelta().y() 은 이전 이벤트 이후 일반적인 수직 마우스 휠이 회전한 각도를 제공합니다. angleDelta().x() 은 마우스에 수평 휠이 있는 경우 수평 마우스 휠이 회전한 각도를 제공하고 그렇지 않으면 0으로 유지됩니다. 일부 마우스는 사용자가 휠을 기울여 수평 스크롤을 수행할 수 있으며, 일부 터치패드는 수평 스크롤 제스처를 지원하므로 angleDelta().x() 에도 표시됩니다.

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

그러나 일부 마우스는 휠의 해상도가 더 미세하여 120단위(15도 미만)보다 작은 델타 값을 전송합니다. 이러한 가능성을 지원하기 위해 120 값에 도달할 때까지 이벤트의 델타 값을 누적적으로 더한 다음 위젯을 스크롤하거나 각 휠 이벤트에 대한 응답으로 위젯을 부분적으로 스크롤할 수 있습니다. 하지만 보다 네이티브한 느낌을 제공하려면 pixelDelta()를 사용할 수 있는 플랫폼에서 사용하는 것이 좋습니다.

예시:

void MyWidget::wheelEvent(QWheelEvent *event)
{
    QPoint numPixels = event->pixelDelta();
    QPoint numDegrees = event->angleDelta() / 8;

    if (!numPixels.isNull()) {
        scrollWithPixels(numPixels);
    } else if (!numDegrees.isNull()) {
        QPoint numSteps = numDegrees / 15;
        scrollWithDegrees(numSteps);
    }

    event->accept();
}

• 스크롤이 곧 시작되지만 거리가 아직 변경되지 않은 경우(Qt::ScrollBegin),
• 또는 스크롤이 종료되었고 거리가 더 이상 변경되지 않은 경우(Qt::ScrollEnd).

pixelDelta()도 참조하세요 .

bool QWheelEvent::inverted() const

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

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

그러나 일부 플랫폼에서는 위에서 설명한 것과 동일한 작업을 수행하면 음의 델타 값이 생성되도록 구성할 수 있습니다(크기는 동일). 반전 속성을 사용하면 휠 이벤트 소비자는 시스템 설정에 관계없이 특정 위젯에 대해서만 항상 휠의 방향을 따르도록 선택할 수 있습니다. (예를 들어 사용자가 시각적 텀블러가 회전하는 것과 같은 방향으로 휠을 회전하는 경우를 들 수 있습니다. 또 다른 사용 사례는 슬라이더 핸들이 시스템 구성에 관계없이 터치패드에서 손가락의 이동 방향을 따르도록 만드는 것입니다.)

[override virtual] bool QWheelEvent::isBeginEvent() const

재구현합니다: QSinglePointEvent::isBeginEvent() const.

이 이벤트의 phase()가 Qt::ScrollBegin 인 경우 true 를 반환합니다.

[override virtual] bool QWheelEvent::isEndEvent() const

재구현합니다: QSinglePointEvent::isEndEvent() const.

이 이벤트의 phase()가 Qt::ScrollEnd 인 경우 true 를 반환합니다.

[override virtual] bool QWheelEvent::isUpdateEvent() const

재구현합니다: QSinglePointEvent::isUpdateEvent() const.

이 이벤트의 phase()가 Qt::ScrollUpdate 또는 Qt::ScrollMomentum 인 경우 true 를 반환합니다.

Qt::ScrollPhase QWheelEvent::phase() const

이 휠 이벤트의 스크롤 단계를 반환합니다.

QPoint QWheelEvent::pixelDelta() const

화면의 스크롤 거리를 픽셀 단위로 반환합니다. 이 값은 macOS와 같이 고해상도 픽셀 기반 델타 값을 지원하는 플랫폼에서 제공됩니다. 이 값은 화면에서 콘텐츠를 스크롤할 때 직접 사용해야 합니다.

예시:

void MyWidget::wheelEvent(QWheelEvent *event)
{
    QPoint numPixels = event->pixelDelta();
    QPoint numDegrees = event->angleDelta() / 8;

    if (!numPixels.isNull()) {
        scrollWithPixels(numPixels);
    } else if (!numDegrees.isNull()) {
        QPoint numSteps = numDegrees / 15;
        scrollWithDegrees(numSteps);
    }

    event->accept();
}

• 스크롤이 곧 시작되지만 거리가 아직 변경되지 않은 경우(Qt::ScrollBegin),
• 또는 스크롤이 끝났고 거리가 더 이상 변경되지 않은 경우(Qt::ScrollEnd).