ladybird/Libraries/LibCore/CObject.h
Andreas Kling fcc3745b02 LibCore+LibGUI+WindowServer: Make events bubble up through ancestors
With this patch, CEvents no longer stop at the target object, but will
bubble up the ancestor chain as long as CEvent::is_accepted() is false.

To the set accepted flag, call CEvent::accept().
To clear the accepted flag, call CEvent::ignore().

Events start out in the accepted state, so if you want them to bubble
up, you have to call ignore() on them.

Using this mechanism, we now ignore non-tabbing keydown events in
GWidget, causing them to bubble up through the widget's ancestors. :^)
2019-09-20 20:37:31 +02:00

129 lines
3.2 KiB
C++

#pragma once
#include <AK/String.h>
#include <AK/Function.h>
#include <AK/IntrusiveList.h>
#include <AK/StdLibExtras.h>
#include <AK/Vector.h>
#include <AK/Weakable.h>
namespace AK {
class JsonObject;
}
class CEvent;
class CChildEvent;
class CCustomEvent;
class CTimerEvent;
#define C_OBJECT(klass) \
public: \
virtual const char* class_name() const override { return #klass; }
class CObject : public Weakable<CObject> {
// NOTE: No C_OBJECT macro for CObject itself.
public:
IntrusiveListNode m_all_objects_list_node;
virtual ~CObject();
virtual const char* class_name() const = 0;
virtual void event(CEvent&);
const String& name() const { return m_name; }
void set_name(const StringView& name) { m_name = name; }
Vector<CObject*>& children() { return m_children; }
const Vector<CObject*>& children() const { return m_children; }
template<typename Callback>
void for_each_child(Callback callback)
{
for (auto* child : m_children) {
if (callback(*child) == IterationDecision::Break)
return;
}
}
template<typename T, typename Callback>
void for_each_child_of_type(Callback callback);
bool is_ancestor_of(const CObject&) const;
CObject* parent() { return m_parent; }
const CObject* parent() const { return m_parent; }
void start_timer(int ms);
void stop_timer();
bool has_timer() const { return m_timer_id; }
void add_child(CObject&);
void remove_child(CObject&);
void delete_later();
void dump_tree(int indent = 0);
void deferred_invoke(Function<void(CObject&)>);
bool is_widget() const { return m_widget; }
virtual bool is_window() const { return false; }
virtual void save_to(AK::JsonObject&);
static IntrusiveList<CObject, &CObject::m_all_objects_list_node>& all_objects();
void dispatch_event(CEvent&, CObject* stay_within = nullptr);
protected:
explicit CObject(CObject* parent = nullptr, bool is_widget = false);
virtual void timer_event(CTimerEvent&);
virtual void custom_event(CCustomEvent&);
// NOTE: You may get child events for children that are not yet fully constructed!
virtual void child_event(CChildEvent&);
private:
CObject* m_parent { nullptr };
String m_name;
int m_timer_id { 0 };
bool m_widget { false };
Vector<CObject*> m_children;
};
template<typename T>
inline bool is(const CObject&) { return false; }
template<>
inline bool is<CObject>(const CObject&) { return true; }
template<typename T>
inline T& to(CObject& object)
{
ASSERT(is<typename RemoveConst<T>::Type>(object));
return static_cast<T&>(object);
}
template<typename T>
inline const T& to(const CObject& object)
{
ASSERT(is<typename RemoveConst<T>::Type>(object));
return static_cast<const T&>(object);
}
template<typename T, typename Callback>
inline void CObject::for_each_child_of_type(Callback callback)
{
for_each_child([&](auto& child) {
if (is<T>(child))
return callback(to<T>(child));
return IterationDecision::Continue;
});
}
inline const LogStream& operator<<(const LogStream& stream, const CObject& object)
{
return stream << object.class_name() << '{' << &object << '}';
}