|
|
              
MapPinchAreaThe MapPinchArea element provides basic Map pinch interaction. More... Inherits QtObject This type was introduced in Qt Location 5.0. Properties
Signals
Detailed DescriptionMapPinchArea elements are used as part of a Map, to provide for the pinch-to-zoom gesture used on touch displays. This is comparable to the activity of the PinchArea element. A MapPinchArea is automatically created with a new Map and available with the pinch property. This is the only way to create a MapPinchArea, and once created this way cannot be destroyed without its parent Map. The two most commonly used properties of the MapPinchArea are the enabled and activeGestures properties. Both of these must be set before a MapPinchArea will have any effect upon interaction with the Map. PerformanceThe MapPinchArea, when enabled, must process all incoming touch events in order to track the shape and size of the "pinch". The overhead added on touch events can be considered constant time. Example UsageThe following example enables the pinch gesture on a map. Map {
pinch.enabled: true
pinch.activeGestures: MapPinchArea.ZoomGesture
}
Property DocumentationThis read-only property holds whether a pinch gesture is active. This property holds the gestures that the pinch should control. By default the ZoomGesture is enabled.
For the extremist, one may OR flag the RotationGesture or TiltGesture but these come with absolutely no warranty or guarantees at the moment (may be removed, changed, moved around) Note: For the time being, only PinchArea.ZoomGesture is supported. This property holds whether the pinch gestures are enabled. Note: disabling pinch during active pinch does not have effect on the potentially active current pinch. This property holds the maximum zoom level change per pinch, essentially meant to be used for setting the zoom sensitivity. It is an indicative measure calculated from the dimensions of the map area, roughly corresponding how much zoom level could change with maximum pinch zoom. Default value is 2.0, maximum value is 10.0 This property holds the rotation factor for zoom, essentially meant to be used for setting the rotation sensitivity. It is an indicative measure; the default value 1.0 means the map roughly follows the fingers, whereas 2.0 means rotating twice as fast. Maximum value is 5.0. Signal DocumentationRaised when a pinch gesture is started. See also pinchUpdated and pinchFinished. Once a pinch has begun this event gets raised as the user moves her fingers across the map. See also pinchStarted and pinchFinished. |
