»
Symbian OS v9.3 »
Symbian OS reference »
C++ component reference »
Base E32_EKA2 »
TRawEvent
Location:
e32event.h
Link against: euser.lib
class TRawEvent;
Description
Represents a raw hardware event as generated by hardware drivers of a pointer device, a keyboard etc.
Raw hardware events are added to the kernel's event queue.
Members
Defined in TRawEvent:
DeviceNumber(), EActive, EButton1Down, EButton1Up, EButton2Down, EButton2Up, EButton3Down, EButton3Up, ECaseClose, ECaseOpen, EInactive, EKeyDown, EKeyRepeat, EKeyUp, ENone, EPointerMove, EPointerSwitchOn, ERedraw, ESwitchOff, ESwitchOn, EUpdateModifiers, IsTip(), Modifiers(), Pos(), Pos3D(), Rotation(), ScanCode(), Set(), Set(), Set(), Set(), Set(), SetDeviceNumber(), SetRotation(), SetTilt(), SetTip(), TRawEvent(), TType, Ticks(), Tilt(), Type(), alpha, iDeviceNumber, iSpare2, iTicks, iTip, iType, iU, modifiers, phi, pos, pos3D, scanCode, theta, x, y, z
Construction and destruction
inline TRawEvent();
Description
Default constructor
inline TType Type() const;
Description
Gets the event type
Return value
inline TInt DeviceNumber() const;
Description
Gets the device number (eg. screen number)
Return value
inline void SetDeviceNumber(TInt aDeviceNumber);
Description
Sets the device number (eg. screen number)
Parameters
TInt aDeviceNumber |
The device number |
|
IMPORT_C TPoint Pos() const;
Description
Gets the mouse or digitiser X-Y position.
Return value
IMPORT_C TInt ScanCode() const;
Description
Gets the scancode.
Return value
IMPORT_C TInt Modifiers() const;
Description
Gets the modifiers.
Return value
Panic codes
EUSER |
34 If the event does not represent a modifier key being pressed, i.e. if the event type is not TRawEvent::EUpdateModifiers |
|
See also:
IMPORT_C TPoint3D Pos3D() const;
Description
Gets the Cartesian coordinates of the 3D pointer end that is closer to the screen.
Return value
TPoint3D
|
The Cartesian coordinates of the point defined by the end of the 3D pointing device that is closer to the screen. |
|
IMPORT_C TAngle3D Tilt() const;
Description
Gets the angular spherical polar coordinates of the 3D pointer end that is closer to the screen.
Return value
TAngle3D
|
The angular spherical polar coordinates of the point defined by the end of the 3D pointing device that is closer to the screen. |
|
IMPORT_C TInt Rotation() const;
Description
Gets the rotation angle of 3D pointing device.
Some 3D pointing devices support information regarding the angle formed between the physical and magnetical poles, as obtaining when rotating the pen along its main axis.
Return value
TInt
|
The rotation angle of the 3D pointing device. |
|
inline TUint Ticks() const;
Description
Gets the tick count value associated with the event.
Note that the interval between tick counts is hardware dependent.
Return value
TUint
|
The tick count value |
|
inline TBool IsTip() const;
Description
Gets the information on which end of the pointing device is closer to the screen
Return value
TBool
|
A Boolean indicating which end of the pointing device is closer to the screen. |
|
inline void SetTip(TBool aTip);
Description
Sets the information on which end of the pointing device is closer to the screen
Parameters
TBool aTip |
A Boolean indicating which end of the pointing device is closer to the screen. |
|
IMPORT_C void Set(TType aType, TInt aScanCode);
Description
Sets the event up as a scancode event.
Parameters
TType aType |
The event type. |
TInt aScanCode |
The scancode. |
|
IMPORT_C void Set(TType aType, TInt aX, TInt aY);
Description
Sets the event up as a mouse/pen event.
Parameters
TType aType |
The event type. |
TInt aX |
The X position. |
TInt aY |
The Y position. |
|
IMPORT_C void Set(TType aType);
Description
Sets up an event without specific parameters.
Parameters
TType aType |
The event type. |
|
IMPORT_C void Set(TType aType, TInt aX, TInt aY, TInt aZ);
Description
Sets the event up as a 3D pointer linear move event.
Parameters
TType aType |
The event type. |
TInt aX |
The X position. |
TInt aY |
The Y position. |
TInt aZ |
The Z position (defaulst to 0 on 2D detection devices). |
|
IMPORT_C void Set(TType aType, TInt aX, TInt aY, TInt aZ, TInt aPhi, TInt aTheta, TInt aAlpha);
Description
Sets the event up as a 3D pointer linear move and tilt and rotation change event.
Parameters
TType aType |
The event type. |
TInt aX |
The X position (or TPhi polar coordinate). |
TInt aY |
The Y position (or Theta polar coordinate). |
TInt aZ |
The Z position (or rotation). |
TInt aPhi |
The Phi polar coordinate. |
TInt aTheta |
The Theta polar coordinate. |
TInt aAlpha |
The rotation angle. |
|
IMPORT_C void SetTilt(TType aType, TInt aPhi, TInt aTheta);
Description
Sets the event up as 3D pointer tilt change event.
Parameters
TType aType |
The event type. |
TInt aPhi |
The Phi coordinate. |
TInt aTheta |
The Theta coordinate. |
|
IMPORT_C void SetRotation(TType aType, TInt aAlpha);
Description
Sets the event up as 3D pointer rotation event.
Parameters
TType aType |
The event type. |
TInt aAlpha |
The rotation angle. |
|
TType
Description
Defines the event type.
ENone |
Represents an uninitialised event object. |
EPointerMove |
A pointer device (e.g. a pen) has moved. Only changes in Cartesian coordinates are tracked. |
EPointerSwitchOn |
A switch on event caused by a screen tap using a pointer device. |
EKeyDown |
Represents a keyboard key down event. |
EKeyUp |
Represents a keyboard key up event. |
ERedraw |
Represents a redraw event. Typically generated in an emulator environment in response to a host OS redraw event. |
ESwitchOn |
Represents a device switch on event. |
EActive |
|
EInactive |
|
EUpdateModifiers |
Represents a modifier key being pressed. |
EButton1Down |
Represents a button down event. This is typically used to represent a pointing device coming into contact with a touch sensitive screen. |
EButton1Up |
Represents a button up event. This is typically used to represent a pointing device being lifted away from a touch sensitive screen. |
EButton2Down |
Represents a button down event. This is typically used to represent a pointing device coming into contact with a touch sensitive screen. |
EButton2Up |
Represents a button up event. This is typically used to represent a pointing device being lifted away from a touch sensitive screen. |
EButton3Down |
Represents a button down event. This is typically used to represent a pointing device coming into contact with a touch sensitive screen. |
EButton3Up |
Represents a button up event. This is typically used to represent a pointing device being lifted away from a touch sensitive screen. |
ESwitchOff |
Represents a device switch off event. |
EKeyRepeat |
Represents a key being continually pressed event. |
ECaseOpen |
Represents a case open event. The meaning of a case is hardware specific. |
ECaseClose |
Represents a case close event. The meaning of a case is hardware specific. |
|
protected: TUint8 iType;
Description
protected: TUint8 iTip;
Description
Indicates whether the tip or head of pointing device is closer to screen.
protected: TUint8 iSpare2;
Description
protected: TUint8 iDeviceNumber;
Description
protected: TUint iTicks;
Description
protected: TInt x;
Description
protected: TInt y;
Description
protected: TRawEvent::@52::@53 pos;
Description
protected: TInt z;
Description
protected: TInt phi;
Description
protected: TInt theta;
Description
protected: TInt alpha;
Description
protected: TRawEvent::@52::@54 pos3D;
Description
protected: TInt scanCode;
Description
protected: TInt modifiers;
Description
protected: TRawEvent::@52 iU;
Description
![[Index]](../../../../_stock/btn_index_wt.gif){kind=small}
![[Spacer]](../../../../_stock/btn_spacer.gif){kind=small}
![[Previous]](../../../../_stock/btn_prev_wt.gif){kind=small}
![[Next]](../../../../_stock/btn_next_wt.gif){kind=small}
![[Top]](../../../../_stock/arrow_up_2.gif){kind=icon}
![[Previous]](../../../../_stock/btn_prev.gif){kind=small}
![[Top]](../../../../_stock/btn_top.gif)
![[Next]](../../../../_stock/btn_next.gif){kind=small}