內容

• 公共類型
• 特性
• 公共函數
• 詳細描述

QPinchGesture 類

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

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

• 所有成員列錶，包括繼承成員

公共類型

enum	ChangeFlag { ScaleFactorChanged, RotationAngleChanged, CenterPointChanged }
flags	ChangeFlags

特性

centerPoint : QPointF changeFlags : ChangeFlags lastCenterPoint : QPointF lastRotationAngle : qreal lastScaleFactor : qreal rotationAngle : qreal

scaleFactor : qreal startCenterPoint : QPointF totalChangeFlags : ChangeFlags totalRotationAngle : qreal totalScaleFactor : qreal

• 5 特性繼承自 QGesture
• 1 特性繼承自 QObject

公共函數

	~QPinchGesture ()
QPointF	centerPoint () const
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 (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 (ChangeFlags value )
void	setTotalRotationAngle (qreal value )
void	setTotalScaleFactor (qreal value )
QPointF	startCenterPoint () const
ChangeFlags	totalChangeFlags () const
qreal	totalRotationAngle () const
qreal	totalScaleFactor () const

• 8 公共函數繼承自 QGesture
• 32 公共函數繼承自 QObject

額外繼承成員

• 1 公共槽繼承自 QObject
• 2 信號繼承自 QObject
• 11 靜態公共成員繼承自 QObject
• 9 保護函數繼承自 QObject

詳細描述

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

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

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

訪問函數：

ChangeFlags	changeFlags () const
void	setChangeFlags (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

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

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

訪問函數：

ChangeFlags	totalChangeFlags () const
void	setTotalChangeFlags (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 ()

析構函數。