QScroller Class

멤버 함수 문서

[static] QList<QScroller *> QScroller::activeScrollers()

현재 활성화된 모든 ` QScroller ` 객체의 목록을 반환합니다. 활성화된 ` QScroller ` 객체는 ` state()`에 포함되어 있으며, ` QScroller::Inactive` 상태가 아닙니다. 이 함수는 사용자 정의 제스처 인식기를 작성할 때 유용합니다.

[slot] void QScroller::ensureVisible(const QRectF &rect, qreal xmargin, qreal ymargin)

rect 에 정의된 사각형이 뷰포트 내에 보이도록 스크롤이 시작되며, 사각형 주변에는 xmargin 및 ymargin 에서 픽셀 단위로 지정된 추가 여백이 적용됩니다.

직사각형과 여백을 뷰포트 내에 모두 담을 수 없는 경우, rect 의 내용이 최대한 많이 보이도록 스크롤됩니다.

스크롤 속도는 플랫폼에서 정의한 시간 경과 후 지정된 위치에 도달하도록 계산됩니다.

이 함수는 scrollTo()를 호출하여 실제 스크롤을 수행합니다.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        scroller, qOverload(&QScroller::ensureVisible));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        scroller, [receiver = scroller](const QRectF &rect, qreal xmargin, qreal ymargin) { receiver->ensureVisible(rect, xmargin, ymargin); });

scrollTo()도 참조하십시오 .

[slot] void QScroller::ensureVisible(const QRectF &rect, qreal xmargin, qreal ymargin, int scrollTime)

이 버전은 scrollTime 밀리초 만에 목적지 위치에 도달합니다.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        scroller, qOverload(&QScroller::ensureVisible));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        scroller, [receiver = scroller](const QRectF &rect, qreal xmargin, qreal ymargin, int scrollTime) { receiver->ensureVisible(rect, xmargin, ymargin, scrollTime); });

QPointF QScroller::finalPosition() const

현재 스크롤 이동에 대한 예상 최종 위치를 반환합니다. 스크롤러 상태가 Scrolling이 아닌 경우 현재 위치를 반환합니다. 스크롤러 상태가 Inactive인 경우 결과는 정의되지 않습니다.

목표 위치는 픽셀 단위입니다.

pixelPerMeter() 및 scrollTo()도 참조하십시오 .

[static] Qt::GestureType QScroller::grabGesture(QObject *target, QScroller::ScrollerGestureType scrollGestureType = TouchGesture)

사용자 정의 스크롤 제스처 인식기를 등록하고, 이를 ` target `에 할당하여 결과 제스처 유형을 반환합니다. ` scrollGestureType `가 ` TouchGesture `로 설정된 경우, 제스처는 터치 이벤트 발생 시 트리거됩니다. ` LeftMouseButtonGesture`, ` RightMouseButtonGesture ` 또는 ` MiddleMouseButtonGesture ` 중 하나로 설정된 경우, 해당 버튼의 마우스 이벤트 발생 시 트리거됩니다.

단일 객체에서 동시에 활성화될 수 있는 스크롤 제스처는 하나뿐입니다. 동일한 객체에서 이 함수를 두 번 호출하면, 새로운 제스처를 등록하기 전에 기존 제스처의 등록을 해제합니다.

ungrabGesture() 및 grabbedGesture()도 참조하십시오 .

[static] Qt::GestureType QScroller::grabbedGesture(QObject *target)

target 에 대해 현재 캡처된 제스처 유형을 반환하거나, 캡처된 제스처가 없는 경우 0을 반환합니다.

grabGesture() 및 ungrabGesture()도 참조하십시오 .

bool QScroller::handleInput(QScroller::Input input, const QPointF &position, qint64 timestamp = 0)

이 함수는 제스처 인식기가 스크롤러에 새로운 입력 이벤트를 알리는 데 사용됩니다. 스크롤러는 입력 이벤트와 연결된 스크롤러 속성에 따라 내부 ` state()`를 변경합니다. 스크롤러는 이벤트가 발생한 입력 장치의 종류를 구분하지 않습니다. 따라서 이 이벤트는 ` input ` 유형, ` position ` 및 밀리초 단위의 ` timestamp`로 분할되어야 합니다. ` position `는 대상의 좌표계에 맞춰져 있어야 합니다.

반환 값은 이벤트를 호출한 필터에서 직접 처리해야 하는 경우 ` true `이며, 이벤트를 컨트롤로 전달해야 하는 경우 ` false `입니다.

[static] bool QScroller::hasScroller(QObject *target)

target 에 대해 이미 QScroller 객체가 생성된 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

scroller()도 참조하십시오 .

QPointF QScroller::pixelPerMeter() const

스크롤된 위젯에 대한 ‘미터당 픽셀’ 측정값을 반환합니다.

QPointF 를 사용하여 x축과 y축에 대해 각각 별도의 값이 보고됩니다.

[slot] void QScroller::resendPrepareEvent()

이 함수는 ‘ QScrollPrepareEvent ’를 다시 전송합니다. resendPrepareEvent를 호출하면 스크롤러에서 ‘ QScrollPrepareEvent ’가 트리거됩니다. 이를 통해 수신자는 스크롤 중에 콘텐츠 위치와 크기를 재설정할 수 있습니다. 비활성(Inactive) 상태에서 이 함수를 호출하는 것은 무의미합니다. 스크롤이 시작되기 전에 prepare 이벤트가 다시 전송되기 때문입니다.

[slot] void QScroller::scrollTo(const QPointF &pos)

pos 지점이 뷰포트의 왼쪽 상단 위치에 오도록 위젯을 스크롤하기 시작합니다.

유효 스크롤 영역 밖으로 스크롤할 때의 동작은 정의되지 않습니다. 이 경우 스크롤러가 목표 지점을 지나칠 수도 있고 그렇지 않을 수도 있습니다.

스크롤 속도는 플랫폼에서 정의한 시간 간격 후에 지정된 위치에 도달하도록 계산됩니다.

pos 는 뷰포트 좌표로 지정됩니다.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        scroller, qOverload(&QScroller::scrollTo));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        scroller, [receiver = scroller](const QPointF &pos) { receiver->scrollTo(pos); });

ensureVisible()도 참조하십시오 .

[slot] void QScroller::scrollTo(const QPointF &pos, int scrollTime)

이 버전은 scrollTime 밀리초 만에 목적지 위치에 도달할 것입니다.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        scroller, qOverload(&QScroller::scrollTo));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        scroller, [receiver = scroller](const QPointF &pos, int scrollTime) { receiver->scrollTo(pos, scrollTime); });

[static] QScroller *QScroller::scroller(QObject *target)

지정된 ` target`에 대한 스크롤러를 반환합니다. 해당 객체가 존재하는 한, 이 함수는 항상 동일한 ` QScroller ` 인스턴스를 반환합니다. ` target`에 대한 ` QScroller `가 존재하지 않는 경우, 암시적으로 하나 생성됩니다. 어떤 객체에 대해서도 ` QScroller `가 두 개 이상 활성화된 상태는 절대 발생하지 않습니다.

hasScroller() 및 target()도 참조하십시오 .

[static] const QScroller *QScroller::scroller(const QObject *target)

이 함수는 scroller()의 const 버전입니다.

[signal] void QScroller::scrollerPropertiesChanged(const QScrollerProperties &newProperties)

QScroller 스크롤러 속성이 변경될 때마다 이 신호를 발신합니다. newProperties 는 새로운 스크롤러 속성입니다.

scrollerProperties도 참조하십시오 .

void QScroller::setSnapPositionsX(const QList<qreal> &positions)

수평축의 스냅 위치를 ` positions` 목록으로 설정합니다. 이렇게 하면 이전에 설정된 모든 스냅 위치와 스냅 간격이 덮어쓰여집니다. 위치 목록을 비워두면 스냅 기능을 비활성화할 수 있습니다.

void QScroller::setSnapPositionsX(qreal first, qreal interval)

가로축의 스냅 위치를 일정한 간격으로 설정합니다. 첫 번째 스냅 위치는 first 입니다. 다음 스냅 위치는 first + interval 입니다. 이를 활용하여 목록 헤더를 구현할 수 있습니다. 이 설정은 이전에 설정된 모든 스냅 위치와 스냅 간격을 덮어씁니다. 간격을 0.0으로 설정하면 스냅 기능을 비활성화할 수 있습니다.

void QScroller::setSnapPositionsY(const QList<qreal> &positions)

수직축의 스냅 위치를 ` positions` 목록으로 설정합니다. 이렇게 하면 이전에 설정된 모든 스냅 위치와 스냅 간격이 덮어쓰게 됩니다. 빈 위치 목록을 설정하면 스냅 기능을 비활성화할 수 있습니다.

void QScroller::setSnapPositionsY(qreal first, qreal interval)

수직 축의 스냅 위치를 일정한 간격으로 설정합니다. 첫 번째 스냅 위치는 first 입니다. 다음 스냅 위치는 first + interval 입니다. 이렇게 하면 이전에 설정된 모든 스냅 위치와 스냅 간격이 덮어쓰게 됩니다. 간격을 0.0으로 설정하면 스냅 기능을 비활성화할 수 있습니다.

[signal] void QScroller::stateChanged(QScroller::State newState)

QScroller 상태가 변경될 때마다 이 신호를 발신합니다. ` newState `는 새로운 상태입니다.

state도 참조하십시오 .

void QScroller::stop()

스크롤러를 중지하고 상태를 ‘비활성’으로 재설정합니다.

QObject *QScroller::target() const

이 스크롤러의 대상 객체를 반환합니다.

hasScroller() 및 scroller()도 참조하십시오 .

[static] void QScroller::ungrabGesture(QObject *target)

target 에 대한 제스처를 해제합니다. 제스처가 잡혀 있지 않으면 아무 작업도 수행하지 않습니다.

grabGesture() 및 grabbedGesture()도 참조하십시오 .

QPointF QScroller::velocity() const

상태가 ‘Scrolling’ 또는 ‘Dragging’일 때, 현재 스크롤 속도를 초당 미터 단위로 반환합니다. 그 외의 경우에는 속도 값을 0으로 반환합니다.

QPointF 를 사용하여 x축과 y축의 속도를 각각 별도로 반환합니다.

pixelPerMeter()도 참조하십시오 .