Wt::Object Class Reference

#include <object.h>

Inheritance diagram for Wt::Object:

[legend]Collaboration diagram for Wt::Object:

[legend]List of all members.

Public Types
typedef std::list< Object * >	List
Public Member Functions
	Object (Object *parent=0, const std::string &name="Object::anon")
virtual	~Object ()
Object *	parent () const
const List &	children () const
List &	children ()
bool	isDescendant (const Object *p) const
virtual void	insertChild (Object *obj)
virtual void	removeChild (Object *obj)
void	reparent (Object *new_parent)
template<typename T>
void	deleteFirstChild ()
template<typename T>
void	deleteLastChild ()
template<typename T>
void	deleteAllChildren ()
Object *	topParent () const
	returns top level parent: it may return itself
const std::string &	name () const
void	installEventFilter (const Object *filterObj)
void	removeEventFilter (const Object *obj)
virtual bool	eventFilter (Object *, Event *)
int	startTimer (int interval)
void	killTimer (int id)
void	killTimers ()
virtual bool	event (Event *e)
	event handling
Public Attributes
Signal01< void, const Object * >	destroyed
	signals
Protected Member Functions
virtual void	childEvent (ChildEvent *)
	event handling specialization
virtual void	customEvent (CustomEvent *)
virtual void	timerEvent (TimerEvent *)
bool	filterEvent (Event *)
Private Types
typedef std::map< int, SDLTimer * >	SDLTimerPtrMap
Private Member Functions
SDLTimer *	timer (int id) const
	check if SDL timer still exists
Private Attributes
Object *	parent_
std::string	name_
List	children_
List	eventFilters_
SDLTimerPtrMap	timers_

---

Detailed Description

Definition at line 45 of file object.h.

---

Member Typedef Documentation

typedef std::list<Object*> Wt::Object::List

Definition at line 47 of file object.h.

typedef std::map<int, SDLTimer *> Wt::Object::SDLTimerPtrMap [private]

Definition at line 161 of file object.h.

---

Constructor & Destructor Documentation

Wt::Object::Object	(	Object *	parent = 0,
		const std::string &	name = "Object::anon"
	)

Definition at line 30 of file object.cpp.

References insertChild(), parent_, and trace.

                                                    :
        parent_(parent),
name_(name) {
    trace("obj") << "Creating " << this << std::endl;
    if (parent_)
        parent_->insertChild(this);
}

Here is the call graph for this function:

Wt::Object::~Object

(

)

[virtual]

Definition at line 38 of file object.cpp.

References Wt::Event::ChildRemoved, children_, destroyed, killTimers(), parent_, Wt::Application::postEvent(), removeChild(), Wt::Application::sendPostedEvents(), and trace.

                {
    trace("obj") << "Entering Destructor for " <<  this << std::endl;
    destroyed(this);
    // delete childs
    while (!children_.empty()) {
        Object *child = *children_.begin();
        trace("obj") << "Deleting child " << child << std::endl;
        delete child;
    }

    if (parent_)
        parent_->removeChild(this);

    // kill all pending timers
    killTimers();

    // this is to signal queue to not deliver any message to this object

    // from this point on it is not possible to deliver any SDLTimeEvent
    // in the SDL stack. We only have to take care the interval == 0 case.
    // Actually we don't have to do that either because rescheduling happens
    // on the same level with the timer event and we are not going to get
    // anymore of that after the next statement.
    Event *child_event = new ChildEvent(Event::ChildRemoved, this);
    Application::postEvent(0, child_event);
    trace("obj") << "Destroyed " <<  this << std::endl;
    Application::sendPostedEvents();
}

Here is the call graph for this function:

---

Member Function Documentation

virtual void Wt::Object::childEvent

(

ChildEvent *

)

[inline, protected, virtual]

event handling specialization

Reimplemented in Wt::Window::Frame.

Definition at line 146 of file object.h.

Referenced by event().

{}

List& Wt::Object::children

(

)

[inline]

Definition at line 61 of file object.h.

References children_.

                     {
        return children_;
    }

const List& Wt::Object::children

(

)

const [inline]

Definition at line 57 of file object.h.

References children_.

Referenced by Wt::RootWindow::blit_region_ex(), Wt::Widget::childAt(), deleteAllChildren(), deleteFirstChild(), deleteLastChild(), Wt::Widget::focusNextPrevChild(), Wt::Widget::fontChange(), Wt::Widget::lower(), Wt::postLayoutHintEventRecursively(), and Wt::Widget::raise().

                                 {
        return children_;
    }

virtual void Wt::Object::customEvent

(

CustomEvent *

)

[inline, protected, virtual]

Definition at line 147 of file object.h.

Referenced by event().

{}

template<typename T>

void Wt::Object::deleteAllChildren

(

)

[inline]

Definition at line 106 of file object.h.

References children().

                             {
        List::iterator it(children().begin());
        List::iterator end(children().end());

        while (it != end) {
            T *t = dynamic_cast<T *>(*it);
            // before iteration invalidation
            ++it;
            // this will invalidate the iterator
            if (t) {
                delete t;
            }
        }
    }

Here is the call graph for this function:

template<typename T>

void Wt::Object::deleteFirstChild

(

)

[inline]

Definition at line 72 of file object.h.

References children().

                            {
        List::iterator it(children().begin());
        List::iterator end(children().end());

        while (it != end) {
            T *t = dynamic_cast<T *>(*it);
            // before iteration invalidation
            ++it;
            // this will invalidate the iterator
            if (t) {
                delete t;
                break;
            }
        }
    }

Here is the call graph for this function:

template<typename T>

void Wt::Object::deleteLastChild

(

)

[inline]

Definition at line 89 of file object.h.

References children().

                           {
        List::reverse_iterator it(children().rbegin());
        List::reverse_iterator end(children().rend());

        while (it != end) {
            T *t = dynamic_cast<T *>(*it);
            // before iteration invalidation
            ++it;
            // this will invalidate the iterator
            if (t) {
                delete t;
                break;
            }
        }
    }

Here is the call graph for this function:

bool Wt::Object::event

(

Event *

e

)

[virtual]

event handling

Reimplemented in Wt::Application, and Wt::Widget.

Definition at line 173 of file object.cpp.

References childEvent(), Wt::Event::ChildInserted, Wt::Event::ChildRemoved, customEvent(), filterEvent(), Wt::SDLTimer::scheduleNext(), timer(), Wt::Event::Timer, timerEvent(), Wt::Event::type(), and Wt::Event::User.

Referenced by Wt::Widget::event(), Wt::Application::notify(), and Wt::Application::postEvent().

                           {
    bool handled = true;

    if (filterEvent(e))
        return true;

    switch (e->type()) {
    case Event::Timer: {
            TimerEvent *te = static_cast<TimerEvent *>(e);
            int id = te->timerid();
            if (timer(id)) {
                timerEvent(te);
            }
            // if it is signle shot it may have been killed
            // during eventhandling
            SDLTimer *t = timer(id);
            if (t)
                t->scheduleNext();
        }
        break;
    case Event::ChildInserted:
    case Event::ChildRemoved:
        childEvent(static_cast<ChildEvent *>(e));
        break;
    default:
        if (e->type() >= Event::User) {
            customEvent(static_cast<CustomEvent *>(e));
        } else {
            handled = false;
        }
        break;
    }

    return handled;
}

Here is the call graph for this function:

virtual bool Wt::Object::eventFilter	(	Object *	,
		Event *
	)			[inline, virtual]

Reimplemented in Wt::Layout.

Definition at line 130 of file object.h.

Referenced by Wt::Layout::eventFilter().

                                                {
        return false;
    }

bool Wt::Object::filterEvent

(

Event *

)

[protected]

Definition at line 164 of file object.cpp.

References eventFilters_.

Referenced by event(), and Wt::Application::event().

                                 {
    for (List::iterator filter(eventFilters_.begin()),
            end(eventFilters_.end()); filter != end; ++filter) {
        if ((*filter)->eventFilter(this, e))
            return true;
    }
    return false;
}

void Wt::Object::insertChild

(

Object *

obj

)

[virtual]

Definition at line 81 of file object.cpp.

References Wt::Event::ChildInserted, children_, parent_, and Wt::Application::postEvent().

Referenced by Object(), and reparent().

                                    {
    children_.push_back(obj);
    obj->parent_ = this;
    Event *child_event = new ChildEvent(Event::ChildInserted, obj);
    Application::postEvent(this, child_event);
}

Here is the call graph for this function:

void Wt::Object::installEventFilter

(

const Object *

filterObj

)

Definition at line 124 of file object.cpp.

References destroyed, eventFilters_, and removeEventFilter().

Referenced by Wt::Widget::setLayout().

                                                       {
    // we have to deconstify here. We cannot deliver event to const objects
    Object *obj = const_cast<Object *>(filterObj);
    eventFilters_.push_back(obj);
    obj->destroyed.connect(sigc::slot1<void, const Object *>(
                               sigc::mem_fun(*this, &Object::removeEventFilter)));
}

Here is the call graph for this function:

bool Wt::Object::isDescendant

(

const Object *

p

)

const

Definition at line 67 of file object.cpp.

References parent().

Referenced by Wt::SDLInput::EventInfo::EventInfo(), and Wt::SDLInput::handleKeyEvent().

                                               {
    if (!p)
        return false;

    const Object *q = this;

    do {
        if (p == q)
            return true;
    } while ((q = q->parent()));

    return false;
}

Here is the call graph for this function:

void Wt::Object::killTimer

(

int

id

)

Definition at line 145 of file object.cpp.

References timers_.

Referenced by Wt::Timer::stop().

                             {
    delete timers_[id];
    timers_.erase(id);
}

void Wt::Object::killTimers

(

)

Definition at line 150 of file object.cpp.

References timers_.

Referenced by ~Object().

                        {
    uint n = timers_.size() + 1;
    for (uint i = 1; i < n; i++) {
        delete timers_[i];
    }
    timers_.clear();
}

const std::string& Wt::Object::name

(

)

const [inline]

Definition at line 124 of file object.h.

References name_.

Referenced by Wt::operator<<(), Wt::Application::parseArgs(), and Wt::PushButton::setButtonSize().

                                  {
        return name_;
    }

Object* Wt::Object::parent

(

)

const [inline]

Definition at line 53 of file object.h.

References parent_.

Referenced by Wt::Widget::event(), Wt::Widget::focusNextPrevChild(), Wt::Window::Frame::Frame(), Wt::Widget::is_hidden(), isDescendant(), Wt::Layout::isTopLevel(), Wt::Layout::Layout(), Wt::Widget::lower(), Wt::Layout::mainWidget(), Wt::operator<<(), Wt::Widget::paintEvent(), Wt::Widget::parentWidget(), Wt::Application::postEvent(), Wt::Widget::raise(), Wt::Widget::updateGeometry(), Wt::Widget::Widget(), Wt::Window::Window(), Wt::Layout::~Layout(), and Wt::Widget::~Widget().

                           {
        return parent_;
    };

void Wt::Object::removeChild

(

Object *

obj

)

[virtual]

Definition at line 88 of file object.cpp.

References Wt::Event::ChildRemoved, children_, parent_, and Wt::Application::postEvent().

Referenced by reparent(), and ~Object().

                                    {
    List::iterator end = children_.end();
    List::iterator p = find(children_.begin(), end, obj);

    if (p != end) {
        children_.erase(p);
        obj->parent_ = 0;
        Event *child_event = new ChildEvent(Event::ChildRemoved, obj);
        Application::postEvent(this, child_event);
    }
}

Here is the call graph for this function:

void Wt::Object::removeEventFilter

(

const Object *

obj

)

Definition at line 132 of file object.cpp.

References eventFilters_.

Referenced by installEventFilter().

                                                {
    List::iterator p, end(eventFilters_.end());
    p = find(eventFilters_.begin(), end, obj);
    if (p != end)
        eventFilters_.erase(p);
}

void Wt::Object::reparent

(

Object *

new_parent

)

Definition at line 100 of file object.cpp.

References insertChild(), parent_, removeChild(), and trace.

Referenced by Wt::Layout::addItem(), Wt::Widget::reparent(), and Wt::Widget::setLayout().

                                        {
    if (parent_ == new_parent)
        return;
    trace("obj") << "Reparenting " <<  this << std::endl;

    if (parent_) {
        trace("obj") << "   Leaving parent " <<  parent_ << std::endl;
        parent_->removeChild(this);
    }
    if (new_parent) {
        trace("obj") << "   Going to new parent " <<  new_parent << std::endl;
        new_parent->insertChild(this);
    }
    parent_ = new_parent;
}

Here is the call graph for this function:

int Wt::Object::startTimer

(

int

interval

)

Definition at line 139 of file object.cpp.

References timers_.

Referenced by Wt::Timer::start().

                                   {
    int id = timers_.size() + 1;
    timers_[id] = new SDLTimer(this, id, interval);
    return id;
}

SDLTimer * Wt::Object::timer

(

int

id

)

const [private]

check if SDL timer still exists

Definition at line 159 of file object.cpp.

References timers_.

Referenced by event().

                                    {
    SDLTimerPtrMap::const_iterator it = timers_.find(id);
    return (it != timers_.end() ? it->second : 0);
}

virtual void Wt::Object::timerEvent

(

TimerEvent *

)

[inline, protected, virtual]

Reimplemented in Wt::Timer.

Definition at line 148 of file object.h.

Referenced by event(), and Wt::Timer::timerEvent().

{}

Object * Wt::Object::topParent

(

)

const

returns top level parent: it may return itself

Definition at line 116 of file object.cpp.

References parent_.

Referenced by Wt::Widget::topParentWidget().

                                {
    const Object *p = this;
    while (p->parent_) {
        p = p->parent_;
    }
    return const_cast<Object *>(p);
}

---

Member Data Documentation

List Wt::Object::children_ [private]

Definition at line 155 of file object.h.

Referenced by children(), Wt::Widget::focusNextPrevChild(), insertChild(), removeChild(), and ~Object().

Signal01<void, const Object *> Wt::Object::destroyed

signals

Definition at line 139 of file object.h.

Referenced by Wt::Layout::addItem(), installEventFilter(), and ~Object().

List Wt::Object::eventFilters_ [private]

Definition at line 156 of file object.h.

Referenced by filterEvent(), installEventFilter(), and removeEventFilter().

std::string Wt::Object::name_ [private]

Definition at line 154 of file object.h.

Referenced by name().

Object* Wt::Object::parent_ [private]

Definition at line 153 of file object.h.

Referenced by insertChild(), Object(), parent(), removeChild(), reparent(), topParent(), and ~Object().

SDLTimerPtrMap Wt::Object::timers_ [private]

Definition at line 162 of file object.h.

Referenced by killTimer(), killTimers(), startTimer(), and timer().

---

The documentation for this class was generated from the following files:

• object.h
• object.cpp

---

Generated Fri Jul 28 19:30:24 2006.
Copyright © 1998-2003 by the respective authors.

This document is licensed under the terms of the GNU Free Documentation License and may be freely distributed under the conditions given by this license.