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()도 참조하십시오 .

[protected delete] QWheelEvent::QWheelEvent(QWheelEvent &&)

QWheelEvent 의 인스턴스를 move-construct로 생성합니다. 이 함수는 삭제되었습니다.

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 가 생성됩니다.

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

[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).

[protected delete] QWheelEvent &QWheelEvent::operator=(QWheelEvent &&)

other 를 이 QWheelEvent 인스턴스에 이동-할당합니다. 이 함수는 삭제됩니다.

[noexcept protected default] QWheelEvent &QWheelEvent::operator=(const QWheelEvent &other)

other 를 이 QWheelEvent 인스턴스에 복사 할당합니다.