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는 물리 단위(미터, 초)로 표시되며 현재 DPI를 사용하여 QScroller 로 변환됩니다.
QScroller 를참조하세요 .
멤버 유형 문서
enum QScrollerProperties::FrameRates
이 열거형은 드래그하거나 스크롤할 때 사용할 수 있는 프레임 속도를 설명합니다.
| Constant | 값 | 설명 |
|---|---|---|
QScrollerProperties::Fps60 | 1 | 초당 60프레임 |
QScrollerProperties::Fps30 | 2 | 초당 30프레임 |
QScrollerProperties::Fps20 | 3 | 초당 20프레임 |
QScrollerProperties::Standard | 0 | 기본값은 초당 60프레임입니다( QAbstractAnimation)에 해당). |
enum QScrollerProperties::OvershootPolicy
이 열거형은 오버슈팅의 다양한 모드를 설명합니다.
| Constant | 값 | 설명 |
|---|---|---|
QScrollerProperties::OvershootWhenScrollable | 0 | 콘텐츠가 스크롤 가능한 경우 오버슈팅이 가능합니다. 이것이 기본값입니다. |
QScrollerProperties::OvershootAlwaysOff | 1 | 콘텐츠가 스크롤 가능한 경우에도 오버슈팅이 활성화되지 않습니다. |
QScrollerProperties::OvershootAlwaysOn | 2 | 콘텐츠가 스크롤할 수 없는 경우에도 오버슈팅이 항상 활성화됩니다. |
enum QScrollerProperties::ScrollMetric
이 열거형에는 다양한 스크롤 메트릭 유형이 포함되어 있습니다. 달리 지정되지 않은 경우 setScrollMetric 함수는 qreal 유형의 QVariant 을 기대합니다.
다양한 값의 개념에 대한 자세한 내용은 QScroller 문서를 참조하세요.
| Constant | 값 | 설명 |
|---|---|---|
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 속도로 감속하는 데 걸리는 시간에 영향을 줍니다. 실제 값은 선택한 스크롤링 커브에 따라 달라집니다. 대부분의 유형에서 값은 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으로 설정하면 이러한 제스처가 감지되지 않습니다. '가속 플릭'은 이미 스크롤 중인 개체에서 실행되는 플릭 제스처입니다. 이러한 경우 스크롤 속도에 가속 플릭 속도 증가 계수를 곱하여 속도를 높입니다. |
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 을 반환합니다.
© 2025 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.
