QScrollerProperties Class
QScrollerProperties 클래스는 QScroller 의 설정을 저장합니다. 더 보기...
| 헤더: | #include <QScrollerProperties> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
공개 유형
| enum | FrameRates { Fps60, Fps30, Fps20, Standard } |
| enum | OvershootPolicy { OvershootWhenScrollable, OvershootAlwaysOff, OvershootAlwaysOn } |
| enum | ScrollMetric { MousePressEventDelay, DragStartDistance, DragVelocitySmoothingFactor, AxisLockThreshold, ScrollingCurve, …, ScrollMetricCount } |
공개 함수
| QScrollerProperties() | |
| QScrollerProperties(const QScrollerProperties &sp) | |
| virtual | ~QScrollerProperties() |
| QVariant | scrollMetric(QScrollerProperties::ScrollMetric metric) const |
| void | setScrollMetric(QScrollerProperties::ScrollMetric metric, const QVariant &value) |
| bool | operator!=(const QScrollerProperties &sp) const |
| QScrollerProperties & | operator=(const QScrollerProperties &sp) |
| bool | operator==(const QScrollerProperties &sp) const |
정적 공용 멤버
| void | setDefaultScrollerProperties(const QScrollerProperties &sp) |
| void | unsetDefaultScrollerProperties() |
상세 설명
QScrollerProperties 클래스는 QScroller 에서 사용하는 매개 변수를 저장합니다.
기본 설정은 플랫폼에 따라 다르며, Qt는 키네틱 스크롤링에 대해 플랫폼의 동작을 에뮬레이션합니다.
관례에 따라 QScrollerProperties는 물리적 단위(미터, 초)로 표시되며, QScroller 에서 현재 DPI를 사용하여 변환합니다.
QScroller도 참조하십시오 .
멤버 유형 문서
enum QScrollerProperties::FrameRates
이 열거형은 드래그하거나 스크롤할 때 사용할 수 있는 프레임 속도를 나타냅니다.
| 상수 | 값 | 설명 |
|---|---|---|
QScrollerProperties::Fps60 | 1 | 초당 60 프레임 |
QScrollerProperties::Fps30 | 2 | 초당 30 프레임 |
QScrollerProperties::Fps20 | 3 | 초당 20 프레임 |
QScrollerProperties::Standard | 0 | 기본값은 초당 60프레임입니다( QAbstractAnimation 에 해당). |
enum QScrollerProperties::OvershootPolicy
이 열거형은 오버슈팅의 다양한 모드를 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QScrollerProperties::OvershootWhenScrollable | 0 | 콘텐츠를 스크롤할 수 있는 경우 오버슈팅이 가능합니다. 이것이 기본값입니다. |
QScrollerProperties::OvershootAlwaysOff | 1 | 콘텐츠를 스크롤할 수 있는 경우에도 오버슈팅은 절대 활성화되지 않습니다. |
QScrollerProperties::OvershootAlwaysOn | 2 | 콘텐츠가 스크롤 가능하지 않은 경우에도 오버슈팅은 항상 활성화됩니다. |
enum QScrollerProperties::ScrollMetric
이 열거형에는 다양한 스크롤 메트릭 유형이 포함되어 있습니다. 별도로 명시되지 않는 한, ` setScrollMetric ` 함수는 `qreal` 형식의 ` QVariant `을 매개변수로 받습니다.
각 값이 나타내는 개념에 대한 자세한 내용은 QScroller 문서를 참조하십시오.
| 상수 | 값 | 설명 |
|---|---|---|
QScrollerProperties::MousePressEventDelay | 0 | 이는 [s] 에서 플릭 제스처를 시작할 때 마우스 클릭 이벤트가 지연되는 시간입니다. 해당 시간 내에 제스처가 트리거되면, 스크롤 대상 객체에는 마우스 클릭이나 릴리스 이벤트가 전송되지 않습니다. 지연 시간 이후에 제스처가 트리거되면, 지연된 마우스 클릭과 전역 위치 QPoint(-QWIDGETSIZE_MAX, -QWIDGETSIZE_MAX) 에서 발생한 모의 해제 이벤트가 전송됩니다. 제스처가 취소되면, 지연된 마우스 클릭과 실제 해제 이벤트가 모두 전달됩니다. |
QScrollerProperties::DragStartDistance | 1 | 이는 m 에서 플릭 제스처가 트리거되기 전에 터치 또는 마우스 포인터가 이동해야 하는 최소 거리입니다. |
QScrollerProperties::DragVelocitySmoothingFactor | 2 | 최종 스크롤 속도에 새로운 드래그 속도가 어느 정도 반영될지를 나타내는 값입니다. 이 값은 0 과 1 사이의 범위여야 합니다. 값이 낮을수록 드래그 속도에 더 많은 스무딩이 적용됩니다. |
QScrollerProperties::AxisLockThreshold | 3 | 이동 방향이 특정 축을 중심으로 한 각도 범위 내에 있을 경우, 이동을 해당 축 하나로 제한합니다. 임계값은 0 에서 1 사이의 범위여야 합니다. |
QScrollerProperties::ScrollingCurve | 4 | 사용자가 플릭 동작을 시작한 후 스크롤 속도를 감속할 때 사용되는 QEasingCurve 입니다. 이는 속도가 아닌 위치에 대한 이징 곡선이라는 점에 유의하십시오. 기본값은 QEasingCurve::OutQuad 이며, 이 경우 속도(1차 도함수)는 선형으로 감소하고 감속도(2차 도함수)는 일정하게 유지됩니다. |
QScrollerProperties::DecelerationFactor | 5 | 이 계수는 스크롤러가 속도를 0으로 감속하는 데 걸리는 시간에 영향을 미칩니다. 실제 값은 선택한 ScrollingCurve에 따라 달라집니다. 대부분의 유형에서 이 값은 0.1 에서 2.0 |
QScrollerProperties::MinimumVelocity | 6 | m/s 에서 터치를 종료하거나 마우스를 뗀 후 스크롤을 시작하는 데 필요한 최소 속도입니다. |
QScrollerProperties::MaximumVelocity | 7 | m/s 에서 도달할 수 있는 최대 속도입니다. |
QScrollerProperties::MaximumClickThroughVelocity | 8 | m/s 에서 클릭 스루 시 허용되는 최대 스크롤 속도입니다. 즉, 현재 (천천히) 스크롤 중인 객체를 클릭하면 스크롤이 중지될 뿐만 아니라 클릭 이벤트가 UI 컨트롤로 전달됩니다. 이는 지수형 스크롤 곡선을 사용할 때 유용합니다. |
QScrollerProperties::AcceleratingFlickMaximumTime | 9 | 이 값은 seconds 에서 플릭 제스처가 가속 플릭으로 인식되기까지 걸릴 수 있는 최대 시간입니다. 0으로 설정하면 해당 제스처가 감지되지 않습니다. "가속 플릭"이란 이미 스크롤 중인 객체에서 실행되는 플릭 제스처를 말합니다. 이러한 경우, 스크롤 속도를 가속시키기 위해 스크롤 속도에 AcceleratingFlickSpeedupFactor 값을 곱합니다. |
QScrollerProperties::AcceleratingFlickSpeedupFactor | 10 | 가속 플릭이 감지되면 현재 속도에 이 수치가 곱해집니다. 값은 ` >= 1`이어야 합니다. |
QScrollerProperties::SnapPositionRatio | 11 | 이는 사용자가 두 스냅 포인트 사이의 영역을 다음 위치로 스냅시키기 위해 드래그해야 하는 거리입니다. 0.33 는 스크롤이 두 스냅 포인트 사이 거리의 1/3만 도달해도 다음 스냅 포인트로 스냅된다는 것을 의미합니다. 이 비율은 0 과 1 사이여야 합니다. |
QScrollerProperties::SnapTime | 12 | 이는 스크롤 곡선에 적용되는 시간 계수입니다. 값이 낮을수록 스크롤에 더 오랜 시간이 소요됩니다. 스크롤 거리는 이 값과 무관합니다. |
QScrollerProperties::OvershootDragResistanceFactor | 13 | 이 값은 마우스 드래그와 실제 스크롤 영역 이동(오버슈트 중) 간의 배율입니다. 이 배율은 0 과 1 사이여야 합니다. |
QScrollerProperties::OvershootDragDistanceFactor | 14 | 이 값은 드래그 중 오버슈트 이동의 최대 거리입니다. 실제 오버슈트 거리는 이 값에 스크롤되는 객체의 뷰포트 크기를 곱하여 계산됩니다. 이 계수는 0 와 1 사이여야 합니다. |
QScrollerProperties::OvershootScrollDistanceFactor | 15 | 이 값은 스크롤 시 오버슈트 이동의 최대 거리입니다. 실제 오버슈트 거리는 이 값에 스크롤되는 객체의 뷰포트 크기를 곱하여 계산됩니다. 이 계수는 0 과 1 사이의 값이어야 합니다. |
QScrollerProperties::OvershootScrollTime | 16 | 이 값은 오버슈트 애니메이션 전체를 재생하는 데 소요되는 시간( seconds )입니다. |
QScrollerProperties::HorizontalOvershootPolicy | 17 | 이것은 수평 오버슈트 정책입니다( OvershootPolicy 참조). |
QScrollerProperties::VerticalOvershootPolicy | 18 | 이것은 수평 오버슈팅 정책입니다( OvershootPolicy 참조). |
QScrollerProperties::FrameRate | 19 | 이것은 드래그하거나 스크롤할 때 사용해야 하는 프레임 속도입니다. QScroller 는 내부적으로 QAbstractAnimation 타이머를 사용하여 모든 스크롤 작업을 동시에 활성화될 수 있는 다른 애니메이션과 동기화합니다. 초당 60 프레임이라는 표준 값이 너무 빠르다면, 이 설정을 통해 속도를 낮출 수 있으며, 여전히 QAbstractAnimation 과 동기화 상태를 유지할 수 있습니다. 여기에서는 FrameRates 열거형의 값만 사용할 수 있다는 점에 유의하십시오. |
QScrollerProperties::ScrollMetricCount | 20 | 이 항목은 항상 마지막에 위치합니다. |
멤버 함수 문서
QScrollerProperties::QScrollerProperties()
새로운 스크롤러 속성을 생성합니다.
QScrollerProperties::QScrollerProperties(const QScrollerProperties &sp)
sp 의 복사본을 생성합니다.
[virtual noexcept] QScrollerProperties::~QScrollerProperties()
스크롤러 속성을 제거합니다.
QVariant QScrollerProperties::scrollMetric(QScrollerProperties::ScrollMetric metric) const
스크롤러 속성의 ‘ metric ’ 값을 조회합니다.
setScrollMetric() 및 ScrollMetric도 참조하십시오 .
[static] void QScrollerProperties::setDefaultScrollerProperties(const QScrollerProperties &sp)
모든 새로운 ` QScrollerProperties ` 객체의 스크롤러 속성을 ` sp`로 설정합니다.
이 함수를 사용하여 기본 생성자가 반환하는 플랫폼 기본 속성을 재정의할 수 있습니다. 단일 스크롤러의 속성만 변경하려면 ` QScroller::setScrollerProperties()`를 사용하십시오.
참고: 이 함수를호출해도 이미 존재하는 ` QScrollerProperties ` 객체의 내용은 변경되지 않습니다.
unsetDefaultScrollerProperties()도 참조하십시오 .
void QScrollerProperties::setScrollMetric(QScrollerProperties::ScrollMetric metric, const QVariant &value)
metric 의 ScrollerMetric 값을 value 로 설정합니다.
scrollMetric() 및 ScrollMetric도 참조하십시오 .
[static] void QScrollerProperties::unsetDefaultScrollerProperties()
기본 생성자가 반환한 스크롤러 속성을 플랫폼의 기본 속성으로 다시 설정합니다.
setDefaultScrollerProperties()도 참조하십시오 .
bool QScrollerProperties::operator!=(const QScrollerProperties &sp) const
이 스크롤러 속성이 sp 와 다를 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.
QScrollerProperties &QScrollerProperties::operator=(const QScrollerProperties &sp)
sp 를 이 스크롤러 속성에 할당하고, 이 스크롤러 속성에 대한 참조를 반환합니다.
bool QScrollerProperties::operator==(const QScrollerProperties &sp) const
이 스크롤러 속성들이 ` sp`와 일치하면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.
© 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.
