#pragma once #include #include #include #include #include #include #include #include #include namespace AK { class JsonObject; } enum class TimerShouldFireWhenNotVisible { No = 0, Yes }; class CEvent; class CEventLoop; class CChildEvent; class CCustomEvent; class CTimerEvent; #define C_OBJECT(klass) \ public: \ virtual const char* class_name() const override { return #klass; } \ template \ static inline NonnullRefPtr construct(Args&&... args) \ { \ return adopt(*new klass(forward(args)...)); \ } #define C_OBJECT_ABSTRACT(klass) \ public: \ virtual const char* class_name() const override { return #klass; } class CObject : public RefCounted , public Weakable { // NOTE: No C_OBJECT macro for CObject itself. AK_MAKE_NONCOPYABLE(CObject) AK_MAKE_NONMOVABLE(CObject) 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; } NonnullRefPtrVector& children() { return m_children; } const NonnullRefPtrVector& children() const { return m_children; } template void for_each_child(Callback callback) { for (auto& child : m_children) { if (callback(child) == IterationDecision::Break) return; } } template 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, TimerShouldFireWhenNotVisible = TimerShouldFireWhenNotVisible::No); void stop_timer(); bool has_timer() const { return m_timer_id; } void add_child(CObject&); void insert_child_before(CObject& new_child, CObject& before_child); void remove_child(CObject&); void dump_tree(int indent = 0); void deferred_invoke(Function); bool is_widget() const { return m_widget; } virtual bool is_window() const { return false; } virtual void save_to(AK::JsonObject&); static IntrusiveList& all_objects(); void dispatch_event(CEvent&, CObject* stay_within = nullptr); void remove_from_parent() { if (m_parent) m_parent->remove_child(*this); } virtual bool is_visible_for_timer_purposes() const; 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 }; NonnullRefPtrVector m_children; }; template inline bool is(const CObject&) { return false; } template<> inline bool is(const CObject&) { return true; } template inline T& to(CObject& object) { ASSERT(is::Type>(object)); return static_cast(object); } template inline const T& to(const CObject& object) { ASSERT(is::Type>(object)); return static_cast(object); } template inline void CObject::for_each_child_of_type(Callback callback) { for_each_child([&](auto& child) { if (is(child)) return callback(to(child)); return IterationDecision::Continue; }); } inline const LogStream& operator<<(const LogStream& stream, const CObject& object) { return stream << object.class_name() << '{' << &object << '}'; }