The QScrollerProperties class stores the settings for a QScroller . 更多...
| 頭： | #include <QScrollerProperties> |
| qmake: | QT += widgets |
| Since: | Qt 4.8 |
| enum | FrameRates { Fps60, Fps30, Fps20, Standard } |
| enum | OvershootPolicy { OvershootWhenScrollable, OvershootAlwaysOff, OvershootAlwaysOn } |
| enum | ScrollMetric { MousePressEventDelay, DragStartDistance, DragVelocitySmoothingFactor, AxisLockThreshold, ..., ScrollMetricCount } |
| QScrollerProperties () | |
| QScrollerProperties (const QScrollerProperties & sp ) | |
| virtual | ~QScrollerProperties () |
| QVariant | scrollMetric (ScrollMetric metric ) const |
| void | setScrollMetric (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 () |
The QScrollerProperties class stores the settings for a QScroller .
The QScrollerProperties class stores the parameters used by QScroller .
默認設置從屬平颱，以便 Qt 模擬動感捲動平颱行為。
As a convention the QScrollerProperties are in physical units (meter, seconds) and are converted by QScroller 使用當前 DPI。
另請參閱 QScroller .
此枚舉描述當拖拽 (或滾動) 時使用的可用幀速率。
| 常量 | 值 | 描述 |
|---|---|---|
QScrollerProperties::Fps60
|
1
|
60 幀每秒 |
QScrollerProperties::Fps30
|
2
|
30 幀每秒 |
QScrollerProperties::Fps20
|
3
|
20 幀每秒 |
QScrollerProperties::Standard
|
0
|
默認值為 60 幀每秒 (相當於 QAbstractAnimation ). |
此枚舉描述各種過衝模式。
| 常量 | 值 | 描述 |
|---|---|---|
QScrollerProperties::OvershootWhenScrollable
|
0
|
過衝是可能的，當內容可捲動時。這是默認。 |
QScrollerProperties::OvershootAlwaysOff
|
1
|
從不啓用過衝，甚至在內容可捲動時。 |
QScrollerProperties::OvershootAlwaysOn
|
2
|
始終啓用過衝，甚至在內容不可捲動時。 |
此枚舉包含不同捲動規格類型。當沒有另外指示時 setScrollMetric 函數期望 QVariant 為 qreal 類型。
見 QScroller 文檔編製，瞭解不同值背後概念的進一步細節。
| 常量 | 值 | 描述 |
|---|---|---|
QScrollerProperties::MousePressEventDelay
|
0
|
這是鼠標按下事件的延遲時間，當開始輕彈手勢按
[s]
。若手勢的觸發在該時間內，則不嚮滾動對象發送鼠標按下 (或釋放)。若手勢的觸發在該延遲之後，則延遲鼠標按下加僞釋放事件在全局位置
QPoint(-QWIDGETSIZE_MAX, -QWIDGETSIZE_MAX)
被發送。若手勢被取消，則交付延遲鼠標按下加真釋放事件兩者。
|
QScrollerProperties::DragStartDistance
|
1
|
這是觸摸點 (或鼠標點) 需要移動的最小距離，先於觸發輕彈手勢按
m
.
|
QScrollerProperties::DragVelocitySmoothingFactor
|
2
|
描述最終捲動速度包括新拖拽速度的程度值。此值的範圍應該介於
0
and
1
。值越低，拖拽速度的應用越平滑。
|
QScrollerProperties::AxisLockThreshold
|
3
|
將移動限製在一條軸，若移動在圍繞軸的角度內。閾值範圍必須介於
0
to
1
.
|
QScrollerProperties::ScrollingCurve
|
4
|
The QEasingCurve 使用，在用戶初啓輕彈後降低捲動速度時。請注意，這是位置緩和麯綫， not 速度：默認為 QEasingCurve::OutQuad ，導緻速度綫性下降 (一階導數) 和常量減速 (二階導數)。 |
QScrollerProperties::DecelerationFactor
|
5
|
此因子影響捲動器減速到 0 要花費多長時間。實際值從屬選取的 ScrollingCurve。對於大多數類型，值範圍應介於
0.1
to
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
|
This is the distance that the user must drag the area beween two snap points in order to snap it to the next position.
0.33
意味著捲動必須達到 2 捕捉點之間距離的 1/3 纔能捕捉下一。比率必須介於
0
and
1
.
|
QScrollerProperties::SnapTime
|
12
|
This is the time factor for the scrolling curve. A lower value means that the scrolling will take longer. The scrolling distance is independet of this value. |
QScrollerProperties::OvershootDragResistanceFactor
|
13
|
此值是鼠標拖拽和實際滾動區域移動 (在過衝期間) 之間的因子。因子必須介於
0
and
1
.
|
QScrollerProperties::OvershootDragDistanceFactor
|
14
|
這是拖拽時過衝移動的最大距離。實際過衝距離是通過將此值乘以捲動對象的視口大小來計算的。因子必須介於
0
and
1
.
|
QScrollerProperties::OvershootScrollDistanceFactor
|
15
|
這是捲動時過衝移動的最大距離。實際過衝距離是通過將此值乘以捲動對象的視口大小來計算的。因子必須介於
0
and
1
.
|
QScrollerProperties::OvershootScrollTime
|
16
|
這是時間按
seconds
用於播放完整過衝動畫。
|
QScrollerProperties::HorizontalOvershootPolicy
|
17
|
這是水平超調策略 (見 OvershootPolicy ). |
QScrollerProperties::VerticalOvershootPolicy
|
18
|
這是水平超調策略 (見 OvershootPolicy ). |
QScrollerProperties::FrameRate
|
19
|
這是拖拽 (或捲動) 時應使用的幀速率。 QScroller 使用 QAbstractAnimation 內部計時器將所有捲動操作同步到可能同時處於活動狀態的其它動畫。若每秒 60 幀的標準值太快，可以采用此設置降低它，同時仍是同步與 QAbstractAnimation 。請注意，僅當值為 FrameRates 枚舉允許在這裏。 |
QScrollerProperties::ScrollMetricCount
|
20
|
這始終是最後條目。 |
構造新滾動條特性。
構造副本為 sp .
[虛擬]
QScrollerProperties::
~QScrollerProperties
()
銷毀捲動器特性。
查詢 metric 值對於捲動器特性。
另請參閱 setScrollMetric () 和 ScrollMetric .
[static]
void
QScrollerProperties::
setDefaultScrollerProperties
(const
QScrollerProperties
&
sp
)
設置捲動器特性對於所有新的 QScrollerProperties 對象到 sp .
使用此函數來覆蓋由默認構造函數，返迴的平颱默認特性。若隻想改變單個捲動器的捲動特性，使用 QScroller::setScrollerProperties ()
注意： 調用此函數不改變內容對於已存在的 QScrollerProperties 對象。
另請參閱 unsetDefaultScrollerProperties ().
設置特定值對於 metric ScrollerMetric 到 value .
另請參閱 scrollMetric () 和 ScrollMetric .
[static]
void
QScrollerProperties::
unsetDefaultScrollerProperties
()
將默認構造函數返迴的捲動器特性，設置迴平颱默認特性。
另請參閱 setDefaultScrollerProperties ().
返迴
true
若這些捲動器特性不同於
sp
；否則返迴
false
.
賦值 sp 給這些捲動器特性並返迴這些捲動器特性的引用。
返迴
true
若這些捲動器特性等於
sp
；否則返迴
false
.