#include <advancedpointerevent.h>
| class TAdvancedPointerEvent : public TPointerEvent |
| Public Attributes | |
|---|---|
| TUint8 | iPointerNumber |
| TInt32 | iPosZ |
| TInt | iSpare1 |
| TInt | iSpare2 |
| struct TAdvancedPointerEvent::@80::@81 | ints |
| struct TAdvancedPointerEvent::@80::@82 | multiPos3D |
| Public Member Enumerations | |
|---|---|
| enum | anonymous { EDefaultPointerNumber, EMaximumWServNumberOfPointers } |
| Public Member Functions | |
|---|---|
| TAdvancedPointerEvent() | |
| TAdvancedPointerEvent(const TAdvancedPointerEvent &) | |
| TInt | PointerNumber() |
| TPoint3D | Position3D() |
| TPoint3D | PositionAndPressure3D() |
| TInt | Pressure() |
| TPoint3D | Pressure3D() |
| TInt | Proximity() |
| TInt | ProximityAndPressure() |
| IMPORT_C TAdvancedPointerEvent & | operator=(const TAdvancedPointerEvent &) |
| Inherited Attributes | |
|---|---|
| TPointerEvent::iModifiers | |
| TPointerEvent::iParentPosition | |
| TPointerEvent::iPosition | |
| TPointerEvent::iType | |
| Inherited Enumerations | |
|---|---|
| TPointerEvent:TType | |
Subclass of TPointerEvent created in order to maintain binary compatibility while extending TPointerEvent with new data: (1) pointer number of the pointer whose state change is described by the event, (2) proximity of the pointer to the screen's surface, (3) pressure applied by the pointer to the screen.
These new attributes will be present only on devices that support them, otherwise they will be set to 0.
See also: TPointerEvent TPointerEvent::AdvancedPointerEvent() TPointerEvent::IsAdvancedPointerEvent() TWsEvent::Pointer()
| TAdvancedPointerEvent | ( | ) | [inline] |
Default Constructor for TAdvancedPointerEvent
| IMPORT_C | TAdvancedPointerEvent | ( | const TAdvancedPointerEvent & | aPointerEvent | ) |
| TInt | PointerNumber | ( | ) | const [inline] |
Gets the pointer number of the pointer whose state change is described by this event.
from this time it may be re-used to identify another pointer coming into range.
On a particular device, the pointer number is always an integer in the range 0 to HALData::EPointerNumberOfPointers - 1. If the device doesn't provide value for this attribute, it is assumed to be 1.
Please note that in order to receive events from multiple pointers in a window, the method RWindowBase::EnableAdvancedPointers() has to be called for this window's instance before it is activated. Otherwise this window will only receive TPointerEvents from one emulated pointer, which will always have pointer number 0.
See also: RWindowBase::EnableAdvancedPointers() HALData::EPointerNumberOfPointers
Returns: Pointer number of the pointer whose state change is described by this event.
| TPoint3D | Position3D | ( | ) | const [inline] |
See also: TAdvancedPointerEvent::Proximity()
Returns: Pointer's X and Y coordinates plus pointer's proximity to the screen as Z coordinate. Please note that returned Z coordinate will be always negative or 0.
| TPoint3D | PositionAndPressure3D | ( | ) | const [inline] |
Returns: Pointer's X and Y coordinates plus combined proximity and pressure as Z coordinate.
| TInt | Pressure | ( | ) | const [inline] |
Gets the pressure applied by the pointer to the screen. Pressure units may vary between devices and may be non-linear. Returned value will be a positive integer as the maximum supported pressure range in Symbian OS is from 0 to KMaxTInt. HALData attributes provide more information about pressure support on particular device.
On platforms without pointer pressure support, pressure is always assumed to be 0.
See also: TAdvancedPointerEvent::Pressure3D() TAdvancedPointerEvent::ProximityAndPressure() HALData::EPointer3DMaxPressure HALData::EPointer3DPressureStep
Returns: Pressure applied by the pointer to the screen.
| TPoint3D | Pressure3D | ( | ) | const [inline] |
See also: TAdvancedPointerEvent::Pressure()
Returns: Pointer's X and Y coordinates plus pressure applied by the pointer to the screen as Z coordinate.
| TInt | Proximity | ( | ) | const [inline] |
Gets the proximity of the pointer to the screen's surface. Proximity units may vary between devices and may be non-linear. Returned value will be a negative integer as the maximum supported proximity range in Symbian OS is from KMinTInt to 0, where KMinTInt means the highest proximity that Symbian OS can support and 0 means touching the screen. HALData attributes provide more information about proximity support on particular device.
On platforms without pointer proximity support, proximity is always assumed to be 0.
See also: TAdvancedPointerEvent::Position3D() TAdvancedPointerEvent::ProximityAndPressure() HALData::EPointer3DMaxProximity HALData::EPointer3DProximityStep
Returns: Proximity of the pointer to the screen's surface.
| TInt | ProximityAndPressure | ( | ) | const [inline] |
Gets pressure applied by the pointer to the screen and proximity of the pointer to the screen as one value. This is possible because the pointer is never in proximity to the screen and pressing the screen at the same time.
See also: TAdvancedPointerEvent::Proximity() TAdvancedPointerEvent::Pressure() TAdvancedPointerEvent::PositionAndPressure3D()
Returns: The value of proximity if the pointer is in proximity to the screen; proximity is always represented as negative TInt. The value of pressure if the pointer is touching the screen; pressure is always represented as positive TInt.
| IMPORT_C TAdvancedPointerEvent & | operator= | ( | const TAdvancedPointerEvent & | aPointerEvent | ) |