QPinchGesture 類

The QPinchGesture 類描述由用戶做齣的捏閤手勢。 更多...

頭: #include <QPinchGesture>
qmake: QT += widgets
Since: Qt 4.6
繼承: QGesture

公共類型

enum ChangeFlag { ScaleFactorChanged, RotationAngleChanged, CenterPointChanged }
flags ChangeFlags

特性

公共函數

virtual ~QPinchGesture ()
QPointF centerPoint () const
QPinchGesture::ChangeFlags changeFlags () const
QPointF lastCenterPoint () const
qreal lastRotationAngle () const
qreal lastScaleFactor () const
qreal rotationAngle () const
qreal scaleFactor () const
void setCenterPoint (const QPointF & value )
void setChangeFlags (QPinchGesture::ChangeFlags value )
void setLastCenterPoint (const QPointF & value )
void setLastRotationAngle (qreal value )
void setLastScaleFactor (qreal value )
void setRotationAngle (qreal value )
void setScaleFactor (qreal value )
void setStartCenterPoint (const QPointF & value )
void setTotalChangeFlags (QPinchGesture::ChangeFlags value )
void setTotalRotationAngle (qreal value )
void setTotalScaleFactor (qreal value )
QPointF startCenterPoint () const
QPinchGesture::ChangeFlags totalChangeFlags () const
qreal totalRotationAngle () const
qreal totalScaleFactor () const

靜態公共成員

const QMetaObject staticMetaObject

額外繼承成員

詳細描述

The QPinchGesture 類描述由用戶做齣的捏閤手勢。

捏閤手勢是用戶觸摸輸入形式,用戶通常采用拇指和手指觸摸輸入設備中的 2 點,在將它們移近在一起 (或進一步分開) 以改變用戶界麵的比例縮放因子、縮放或細節級彆之前。

Qt 中手勢處理的概述和在應用程序中使用手勢的有關信息,見 Widget 和圖形視圖中的手勢 文檔。

代替重復應用相同捏閤手勢,用戶可以繼續在一個地方觸摸輸入設備,然後在新點應用第 2 次觸摸,繼續手勢。當這齣現時,將繼續把手勢事件交付給目標對象,包含實例化的 QPinchGesture Qt::GestureUpdated 狀態。

另請參閱 QPanGesture and QSwipeGesture .

成員類型文檔編製

enum QPinchGesture:: ChangeFlag
flags QPinchGesture:: ChangeFlags

此枚舉描述手勢對象可以齣現的特性改變。

常量 描述
QPinchGesture::ScaleFactorChanged 0x1 比例縮放因子的保持通過 scaleFactor 改變。
QPinchGesture::RotationAngleChanged 0x2 鏇轉角度的保持通過 rotationAngle 改變。
QPinchGesture::CenterPointChanged 0x4 中心點的保持通過 centerPoint 改變。

ChangeFlags 類型是 typedef 對於 QFlags <ChangeFlag>。它存儲 ChangeFlag 值的 OR 組閤。

另請參閱 changeFlags and totalChangeFlags .

特性文檔編製

centerPoint : QPointF

此特性保持當前中心點

中心點是手勢中 2 輸入點之間的中點。

訪問函數:

QPointF centerPoint () const
void setCenterPoint (const QPointF & value )

另請參閱 startCenterPoint and lastCenterPoint .

changeFlags : ChangeFlags

此特性保持當前步驟改變的手勢特性

此特性指示其它手勢特性已改變,由於先前手勢事件包括此手勢的有關信息。可以使用此信息以確定需要更新用戶界麵的哪方麵。

訪問函數:

QPinchGesture::ChangeFlags changeFlags () const
void setChangeFlags (QPinchGesture::ChangeFlags value )

另請參閱 totalChangeFlags , scaleFactor , rotationAngle ,和 centerPoint .

lastCenterPoint : QPointF

此特性保持此手勢記錄中心點的最後位置

訪問函數:

QPointF lastCenterPoint () const
void setLastCenterPoint (const QPointF & value )

另請參閱 centerPoint and startCenterPoint .

lastRotationAngle : qreal

此特性保持手勢運動涵蓋的最後報告角度

最後鏇轉角度是報告角度如在 rotationAngle 特性,當該手勢交付先前手勢事件時。

訪問函數:

qreal lastRotationAngle () const
void setLastRotationAngle (qreal value )

另請參閱 rotationAngle and totalRotationAngle .

lastScaleFactor : qreal

此特性保持此手勢記錄的最後比例縮放因子

最後比例縮放因子包含報告比例縮放因子在 scaleFactor 特性,當先前手勢事件包括此手勢的有關信息時。

若先前沒有交付具有此手勢有關信息的事件 (即:此手勢對象包含手勢第一次移動的有關信息),則此特性包含 0。

訪問函數:

qreal lastScaleFactor () const
void setLastScaleFactor (qreal value )

另請參閱 scaleFactor and totalScaleFactor .

rotationAngle : qreal

此特性保持手勢運動涵蓋的角度

訪問函數:

qreal rotationAngle () const
void setRotationAngle (qreal value )

另請參閱 totalRotationAngle and lastRotationAngle .

scaleFactor : qreal

此特性保持當前比例縮放因子

比例縮放因子度量觸摸設備中用戶 2 輸入之間距離關聯的比例縮放因子。

訪問函數:

qreal scaleFactor () const
void setScaleFactor (qreal value )

另請參閱 totalScaleFactor and lastScaleFactor .

startCenterPoint : QPointF

此特性保持中心點的起始位置

訪問函數:

QPointF startCenterPoint () const
void setStartCenterPoint (const QPointF & value )

另請參閱 centerPoint and lastCenterPoint .

totalChangeFlags : ChangeFlags

此特性保持已改變的手勢特性

此特性指示其它哪些特性已改變,因為手勢已開始。可以使用此信息以確定需要更新用戶界麵的哪個方麵。

訪問函數:

QPinchGesture::ChangeFlags totalChangeFlags () const
void setTotalChangeFlags (QPinchGesture::ChangeFlags value )

另請參閱 changeFlags , scaleFactor , rotationAngle ,和 centerPoint .

totalRotationAngle : qreal

此特性保持手勢涵蓋的總角度

此總角度度量手勢覆蓋的完整角度。通常,這等於的值保持通過 rotationAngle 特性,除如上文描述的用戶通過移除和重新定位某一觸摸點以履行多次鏇轉的情況外。在此情況下,總角度將是手勢多階段鏇轉角度的和。

訪問函數:

qreal totalRotationAngle () const
void setTotalRotationAngle (qreal value )

另請參閱 rotationAngle and lastRotationAngle .

totalScaleFactor : qreal

此特性保持總比例縮放因子

總比例縮放因子度量比例縮放因子從原始值到當前比例縮放因子的總變化。

訪問函數:

qreal totalScaleFactor () const
void setTotalScaleFactor (qreal value )

另請參閱 scaleFactor and lastScaleFactor .

成員函數文檔編製

[虛擬] QPinchGesture:: ~QPinchGesture ()

析構函數。