The Nebula Device 3: CoreGraphics::DisplayEventHandler Class Reference

The Nebula Device 3

CoreGraphics::DisplayEventHandler Class Reference

#include <displayeventhandler.h>

Inheritance diagram for CoreGraphics::DisplayEventHandler:

Core::RefCounted CoreGraphics::ThreadSafeDisplayEventHandler Win32::Win32InputDisplayEventHandler


Detailed Description

A display event handler object is notified by the DisplayDevice about noteworthy window events, for instance when the mouse is moved, the window is minimized, and so on. To get notified about those events, derive a class from DisplayEventHandler and attach to the display device via DisplayDevice::AttachEventHandler().

(C) 2007 Radon Labs GmbH

Public Member Functions

 DisplayEventHandler ()
 constructor
virtual ~DisplayEventHandler ()
 destructor
virtual void OnAttach ()
 called when the event handler is attached to the DisplayDevice
virtual void OnRemove ()
 called when the event handler is removed from the DisplayDevice
virtual bool PutEvent (const DisplayEvent &event)
 called by DisplayDevice when an event happens
int GetRefCount () const
 get the current refcount
void AddRef ()
 increment refcount by one
void Release ()
 decrement refcount and destroy object if refcount is zero
bool IsInstanceOf (const Rtti &rtti) const
 return true if this object is instance of given class
bool IsInstanceOf (const Util::String &className) const
 return true if this object is instance of given class by string
bool IsInstanceOf (const Util::FourCC &classFourCC) const
 return true if this object is instance of given class by fourcc
bool IsA (const Rtti &rtti) const
 return true if this object is instance of given class, or a derived class
bool IsA (const Util::String &rttiName) const
 return true if this object is instance of given class, or a derived class, by string
bool IsA (const Util::FourCC &rttiFourCC) const
 return true if this object is instance of given class, or a derived class, by fourcc
const Util::StringGetClassName () const
 get the class name
Util::FourCC GetClassFourCC () const
 get the class FourCC code

Static Public Member Functions

static void DumpRefCountingLeaks ()
 dump refcounting leaks, call at end of application (NEBULA3_DEBUG builds only!)

Protected Member Functions

virtual bool HandleEvent (const DisplayEvent &event)
 called when an event should be processed, override this method in your subclass

Member Function Documentation

bool CoreGraphics::DisplayEventHandler::PutEvent ( const DisplayEvent e  )  [virtual]

called by DisplayDevice when an event happens

This method is called by the DisplayDevice when an event happens. The default behaviour of this class is to call the HandleEvent() method directly. Subclasses of DisplayEventHandler may choose to implement a different behaviour.

Reimplemented in CoreGraphics::ThreadSafeDisplayEventHandler.

bool CoreGraphics::DisplayEventHandler::HandleEvent ( const DisplayEvent e  )  [protected, virtual]

called when an event should be processed, override this method in your subclass

Handle a display event. This method is usually called by PutEvent(), but subclasses of DisplayEventHandler may choose to implement a different behaviour. Override this method in your subclass to process the incoming event.

Reimplemented in CoreGraphics::ThreadSafeDisplayEventHandler, and Win32::Win32InputDisplayEventHandler.

int Core::RefCounted::GetRefCount (  )  const [inline, inherited]

get the current refcount

Return the current refcount of the object.

void Core::RefCounted::AddRef (  )  [inline, inherited]

increment refcount by one

Increment the refcount of the object.

void Core::RefCounted::Release (  )  [inline, inherited]

decrement refcount and destroy object if refcount is zero

Decrement the refcount and destroy object if refcount is zero.

const Util::String & Core::RefCounted::GetClassName (  )  const [inline, inherited]

get the class name

Get the class name of the object.

Util::FourCC Core::RefCounted::GetClassFourCC (  )  const [inline, inherited]

get the class FourCC code

Get the class FourCC of the object.

void Core::RefCounted::DumpRefCountingLeaks (  )  [static, inherited]

dump refcounting leaks, call at end of application (NEBULA3_DEBUG builds only!)

This method should be called as the very last before an application exits.