virtual void            CWidgetListener::OnKeyPress           (CObject *inSender, int inShiftStates, UInt16 &ioKey);

Called when a key has been pressed on inSender.

virtual void            CWidgetListener::OnKeyRelease         (CObject *inSender, int inShiftStates, UInt16 inKey);

Called when a key has been released on inSender.

virtual void            CWidgetListener::OnMouseEnter         (CObject *inSender);

Called when the mouse enters in inSender.

virtual void            CWidgetListener::OnMouseExit          (CObject *inSender);

Called when the mouse exists from inSender.

virtual void            CWidgetListener::OnMouseDown          (CObject *inSender, int inShiftStates, TPoint inRelativePoint);

Called when a mouse button is pressed on inSender.

virtual void            CWidgetListener::OnMouseUp            (CObject *inSender, int inShiftStates, TPoint inRelativePoint);

Called when a mouse button is released on inSender.

virtual void            CWidgetListener::OnMouseMove          (CObject *inSender, int inShiftStates, TPoint inRelativePoint);

Called when mouse is moved over inSender.

virtual void            CWidgetListener::OnDragStart          (CObject *&ioSender, TPoint &ioRelativePoint,                                                                CPixbuf *&ioPixbuf);

Called when a drag is started on ioSender that could be the GtkOL widget itself or any of its draggable non windowed owned controls if any.  You may change the ioSender parameter to reflect wich control will effectively be managed by the dnd gtkol engine, the relative point to set your personnal pointer's hot spot on the pre-allocated drag representation of the control that you can change as well or delete and set to null if so.

virtual void            CWidgetListener::OnDragOver           (CObject *inDragged, CObject *inReceiver, CObject *inTargeted,                                                                TPoint inRelativePoint, Bool &ioAccept);

Called on inDragged when inDragged is moved over inReceiver; the gtkol inTargeted control reflects wich control would own the inDragged control if a drop occured, may equal the inReceiver parameter or its parent layout if inReceiver is not a drop site itself; inRelativePoint is relative to the inReceiver widget or inReceiver parent widget if not a widget itself.

virtual void            CWidgetListener::OnDragDrop           (CObject *inDragged, CObject *inReceiver, CObject *&ioTargeted,                                                                SInt16 &ioIndex, TPoint inRelativePoint, Bool &ioDoDrop);

Called on inDragged when inDragged is dropped on inReceiver; the gtkol ioTargeted control reflects wich control would own the inDragged control if the ioDoDrop parameter is set to true and the expected gtkol hierarchy rules are respected, may equal the inReceiver parameter or its parent layout if inReceiver is not a drop site itself; the ioIndex parameter specifies the index placement of the inDragged control in its new owner if droped on; inRelativePoint is relative to the inReceiver widget or inReceiver parent widget if not a widget itself.

virtual void            CWidgetListener::OnDragStop           (CObject *inSender);

Called when drag motion of inSender is ending.

virtual void            CWidgetListener::OnEventAfter         (CObject *inSender, GdkEvent *inGdkEvent);

Called after the specified GDK event has been handled on inSender.

virtual void            CWidgetListener::OnPaint              (CObject *inSender, CGraphics &ioGraphics);

called when inSender is about to be painted on graphics specified invalidated bounds

CWidget API details

CWidget::CWidget                 (CComponent *inOwner, const CWidgetListener *inListener=NULL);

CWidget constructor. This level does nothing but setting the following members default values :
m_GtkWidget               (NULL),
m_PerformContainerProcess (true),
m_PerformSignalConnection (true),
m_SerializeShown          (true),
m_SerializeEnabled        (true)

virtual CWidget::~CWidget        ();

CWidget destructor performs a "last chance" call on the CWidget::DestroyWidget (this) function; this function should not be handled at this point, if so, it may introduce some dangerous behaviour; derived classes call CWidget::DestroyWidget in their specific destructors to keep entire memory stacks available while deletion.

static Bool             CWidget::CreateWidget             (CWidget *This);

Internally used : the derived definitions call the CWidget::CreateWidget function (typically in their constructors) in order to correctly manage the process of associating the gtkol widget instance to the to be allocated gtk widget; it calls the virtual CWidget::PerformWidgetInstanciate and virtual CWidget::PerformWidgetInitialize of the specified instance and performs the gtk container process assignement if any (see CContainer abstraction). This function is based on the m_PerformContainerProcess and m_PerformSignalConnection values of the specific instance that sets it for its specific need before calling the process.

static Bool             CWidget::DestroyWidget            (CWidget *This);

Internally used : this function is called in order to destroy the associated gtk widget of the specified instance; CWidget::DestroyWidget performs recursive calls in order to properly delete the children gtk instances too and preserve the gui coherence.

virtual GtkWidget *     CWidget::PerformWidgetInstanciate () =0;

Internally used : this function should be defined in derived definition; it has to instanciate and return the gtk widget that is to be assoaciated to the gtkol widget instance; it is automatically called by CWidget::CreateWidget.

virtual void            CWidget::PerformWidgetInitialize  () =0;

Internally used : this function is called by CWidget::CreateWidget and must perform all of the gtkol and gtk widget initialization such as specific signals connection, widget display and so on.

static CWidget *        CWidget::GetGtkolWidget           (const GtkWidget *);

Get the gtkol instance associated to the specified gtk widget, null if any.

static CWidget *        CWidget::GetGtkolWidget           (const GdkWindow *);

Get the gtkol instance associated to the specified gdk window, null if any.

GtkWidget *             CWidget::GetGtkWidget             () const;

Get the gtk widget handled by the gtkol caller instance.

virtual const CMetaClass * CWidget::ListenerMustBe        () const;

Gtkol widget listener affectation; checks that inListener is derived from CWidgetListener. 

virtual Bool            CWidget::CheckSetOwner            (const CComponent *inCandidate) const;

Checks if the specified component could be assigned as an owner of the caller instance. A gtkol container may be restricted to only one child handling, so this version adds a check for the potential inCandidate container empty state acknowledgment by requesting the children number left it may handle.

virtual Bool            CWidget::SetOwner                 (CComponent *inOwner, const SInt16 inIndex=-1);

Sets the widget's owner, handles the gui container affectation process if it has to do so (see CContainer abstraction).

virtual CMetaClasses    CWidget::OwnerMustBe              () const;

Returns the default expected owner type of the caller instance by specifying __metaclasses(CWidget).

virtual CMetaClasses    CWidget::ChildMustBe              () const;

Returns the default expected children type of the caller instance by specifying __metaclasses(CWidget).

virtual void            CWidget::SetBounds                (const TBounds &inBounds);

Set the bounds of the widget, because the widget position depends on its container managed placement, only the size section of the bounds is handled at this level; specific overwritten definitions may handle the placement section anyway.