Class TWsEvent

class TWsEvent;

Description

Window server event.

All events generated by the window server, except redraw events and priority key events, are delivered to the client in a TWsEvent. The client obtains the TWsEvent by calling RWsSession::GetEvent(). The type of data contained in the TWsEvent depends on the type of event. The client can inquire the event type using Type(), and then retrieve the appropriate type of data.

Members

Defined in TWsEvent:
EWsEventDataSize, ErrorMessage(), EventData(), Handle(), Int(), Key(), ModifiersChanged(), Pointer(), SetHandle(), SetTimeNow(), SetType(), Time(), Type(), VisibilityChanged(), VisibilityChanged(), anonymous

inline TPointerEvent *Pointer() const;

Description

Gets the pointer event.

This function can be used to get information about the pointer event if Type() returns an event of type EEventPointer. or EEventDragDrop.

Return value

TPointerEvent * Structure containing pointer event data.

inline TKeyEvent *Key() const;

Description

Gets the key event.

This function can be used to get information about the key event if Type() returns an event of type EEventKey, EEventKeyUp or EEventKeyDown.

Return value

TKeyEvent * Structure containing key event data

inline TModifiersChangedEvent *ModifiersChanged() const;

Description

Gets information about the modifier changed event.

This function can be used to get information about the modifier changed event if Type() returns an event of type EEventModifiersChanged.

Return value

TModifiersChangedEvent * Structure containing modifier changed event data

inline TWsVisibilityChangedEvent *VisibilityChanged();

Description

Gets information about the visibility changed event.

This function can be used to get information about the visibility changed event if Type() returns an event of type EEventVisibilityChanged.

Return value

TWsVisibilityChangedEvent * Structure containing visibility changed event data

inline const TWsVisibilityChangedEvent *VisibilityChanged() const;

Description

Gets information about the visibility changed event.

This function can be used to get information about the visibility changed event if Type() returns an event of type EEventVisibilityChanged.

Return value

const TWsVisibilityChangedEvent * Structure containing visibility changed event data

inline TWsErrorMessage *ErrorMessage() const;

Description

Gets an error event.

This function can be used to get information about the error event if Type() returns an event of type EEventErrorMessage.

Return value

TWsErrorMessage * The error event.

inline TUint8 *EventData() const;

Description

Gets information about the event.

This function gives you direct access to the event data as a whole. The event can be a key or pointer event or it could be a new special event that only you and another application know about. You are limited to EWsEventDataSize bytes worth of data.

Return value

TUint8 * A pointer to the event data.

inline TInt Type() const;

Description

Gets the type of event that occurred.

Return value

TInt The event type. Event types are defined in TEventCode.

inline TUint Handle() const;

Description

Gets the window handle.

This is the handle that was passed to the window's Construct() function: typically it will be a pointer to the client-side object owning the window, providing access to its member functions.

Return value

TUint The window handle.

inline TTime Time() const;

Description

Gets the time when the event occurred.

Return value

TTime The time when the event occurred.

inline void SetType(TInt aType);

Description

Sets the event type.

Parameters

TInt aType The event type. Event types are defined in TEventCode.

inline void SetHandle(TUint aHandle);

Description

Sets the event handle.

This is the client handle of the window that is being sent the event.

Parameters

TUint aHandle The event handle.

inline void SetTimeNow();

Description

Sets the event time to the current time.

inline TInt *Int() const;

Description

Gets the event data as a TInt.

Return value

TInt *

n/a

Description

Event data size.

EWsEventDataSize The size of a TPointerEvent. This is the maximum number of bytes of data that can be returned by EventData(). Note: this value is 24 bytes.