/* * Copyright (c) 2018-2020, Andreas Kling * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * 1. Redistributions of source code must retain the above copyright notice, this * list of conditions and the following disclaimer. * * 2. Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ #pragma once #include #include #include #include #include #include #include #include #include #include #include #include #define REGISTER_WIDGET(namespace_, class_name) \ extern GUI::WidgetClassRegistration registration_##class_name; \ GUI::WidgetClassRegistration registration_##class_name(#namespace_ "::" #class_name, []() { return namespace_::class_name::construct(); }); namespace GUI { enum class SizePolicy { Fixed, Fill }; inline const char* to_string(SizePolicy policy) { switch (policy) { case SizePolicy::Fixed: return "SizePolicy::Fixed"; case SizePolicy::Fill: return "SizePolicy::Fill"; } return "SizePolicy::(Invalid)"; } enum class HorizontalDirection { Left, Right }; enum class VerticalDirection { Up, Down }; class WidgetClassRegistration { AK_MAKE_NONCOPYABLE(WidgetClassRegistration); AK_MAKE_NONMOVABLE(WidgetClassRegistration); public: WidgetClassRegistration(const String& class_name, Function()> factory); ~WidgetClassRegistration(); String class_name() const { return m_class_name; } NonnullRefPtr construct() const { return m_factory(); } static void for_each(Function); static const WidgetClassRegistration* find(const String& class_name); private: String m_class_name; Function()> m_factory; }; enum class FocusPolicy { NoFocus = 0, TabFocus = 0x1, ClickFocus = 0x2, StrongFocus = TabFocus | ClickFocus, }; class Widget : public Core::Object { C_OBJECT(Widget) public: virtual ~Widget() override; Layout* layout() { return m_layout.ptr(); } const Layout* layout() const { return m_layout.ptr(); } void set_layout(NonnullRefPtr); template inline T& set_layout(Args&&... args) { auto layout = T::construct(forward(args)...); set_layout(*layout); return layout; } SizePolicy horizontal_size_policy() const { return m_horizontal_size_policy; } SizePolicy vertical_size_policy() const { return m_vertical_size_policy; } SizePolicy size_policy(Orientation orientation) { return orientation == Orientation::Horizontal ? m_horizontal_size_policy : m_vertical_size_policy; } void set_size_policy(SizePolicy horizontal_policy, SizePolicy vertical_policy); void set_size_policy(Orientation, SizePolicy); void set_horizontal_size_policy(SizePolicy policy) { set_size_policy(policy, vertical_size_policy()); } void set_vertical_size_policy(SizePolicy policy) { set_size_policy(horizontal_size_policy(), policy); } Gfx::IntSize preferred_size() const { return m_preferred_size; } void set_preferred_size(const Gfx::IntSize&); void set_preferred_size(int width, int height) { set_preferred_size({ width, height }); } int preferred_width() const { return preferred_size().width(); } int preferred_height() const { return preferred_size().height(); } void set_preferred_width(int w) { set_preferred_size(w, preferred_height()); } void set_preferred_height(int h) { set_preferred_size(preferred_width(), h); } bool has_tooltip() const { return !m_tooltip.is_empty(); } String tooltip() const { return m_tooltip; } void set_tooltip(const StringView&); bool is_enabled() const { return m_enabled; } void set_enabled(bool); bool updates_enabled() const { return m_updates_enabled; } void set_updates_enabled(bool); virtual void event(Core::Event&) override; // This is called after children have been painted. virtual void second_paint_event(PaintEvent&); Gfx::IntRect relative_rect() const { return m_relative_rect; } Gfx::IntPoint relative_position() const { return m_relative_rect.location(); } Gfx::IntRect window_relative_rect() const; Gfx::IntRect screen_relative_rect() const; int x() const { return m_relative_rect.x(); } int y() const { return m_relative_rect.y(); } int width() const { return m_relative_rect.width(); } int height() const { return m_relative_rect.height(); } int length(Orientation orientation) const { return orientation == Orientation::Vertical ? height() : width(); } Gfx::IntRect rect() const { return { 0, 0, width(), height() }; } Gfx::IntSize size() const { return m_relative_rect.size(); } void update(); void update(const Gfx::IntRect&); bool is_focused() const; void set_focus(bool, FocusSource = FocusSource::Programmatic); // Returns true if this widget or one of its descendants is focused. bool has_focus_within() const; Widget* focus_proxy() { return m_focus_proxy; } const Widget* focus_proxy() const { return m_focus_proxy; } void set_focus_proxy(Widget*); void set_focus_policy(FocusPolicy policy); FocusPolicy focus_policy() const; enum class ShouldRespectGreediness { No = 0, Yes }; struct HitTestResult { Widget* widget { nullptr }; Gfx::IntPoint local_position; }; HitTestResult hit_test(const Gfx::IntPoint&, ShouldRespectGreediness = ShouldRespectGreediness::Yes); Widget* child_at(const Gfx::IntPoint&) const; void set_relative_rect(const Gfx::IntRect&); void set_relative_rect(int x, int y, int width, int height) { set_relative_rect({ x, y, width, height }); } void set_x(int x) { set_relative_rect(x, y(), width(), height()); } void set_y(int y) { set_relative_rect(x(), y, width(), height()); } void set_width(int width) { set_relative_rect(x(), y(), width, height()); } void set_height(int height) { set_relative_rect(x(), y(), width(), height); } void move_to(const Gfx::IntPoint& point) { set_relative_rect({ point, relative_rect().size() }); } void move_to(int x, int y) { move_to({ x, y }); } void resize(const Gfx::IntSize& size) { set_relative_rect({ relative_rect().location(), size }); } void resize(int width, int height) { resize({ width, height }); } void move_by(int x, int y) { move_by({ x, y }); } void move_by(const Gfx::IntPoint& delta) { set_relative_rect({ relative_position().translated(delta), size() }); } Gfx::ColorRole background_role() const { return m_background_role; } void set_background_role(Gfx::ColorRole); Gfx::ColorRole foreground_role() const { return m_foreground_role; } void set_foreground_role(Gfx::ColorRole); Color background_color() const { return m_background_color; } Color foreground_color() const { return m_foreground_color; } void set_background_color(Color color) { m_background_color = color; } void set_foreground_color(Color color) { m_foreground_color = color; } void set_backcolor(const StringView&); void set_forecolor(const StringView&); void set_autofill(bool b) { set_fill_with_background_color(b); } Window* window() { if (auto* pw = parent_widget()) return pw->window(); return m_window; } const Window* window() const { if (auto* pw = parent_widget()) return pw->window(); return m_window; } void set_window(Window*); Widget* parent_widget(); const Widget* parent_widget() const; void set_fill_with_background_color(bool b) { m_fill_with_background_color = b; } bool fill_with_background_color() const { return m_fill_with_background_color; } const Gfx::Font& font() const { return *m_font; } void set_font(const Gfx::Font*); void set_font(const Gfx::Font& font) { set_font(&font); } void set_global_cursor_tracking(bool); bool global_cursor_tracking() const; void notify_layout_changed(Badge); void invalidate_layout(); bool is_visible() const { return m_visible; } void set_visible(bool); bool spans_entire_window_horizontally() const; bool is_greedy_for_hits() const { return m_greedy_for_hits; } void set_greedy_for_hits(bool b) { m_greedy_for_hits = b; } void move_to_front(); void move_to_back(); bool is_frontmost() const; bool is_backmost() const; Action* action_for_key_event(const KeyEvent&); template void for_each_child_widget(Callback callback) { for_each_child([&](auto& child) { if (is(child)) return callback(downcast(child)); return IterationDecision::Continue; }); } Vector child_widgets() const; virtual bool is_radio_button() const { return false; } virtual bool is_abstract_button() const { return false; } void do_layout(); Gfx::Palette palette() const; void set_palette(const Gfx::Palette&); const Margins& content_margins() const { return m_content_margins; } void set_content_margins(const Margins&); Gfx::IntRect content_rect() const; void set_accepts_emoji_input(bool b) { m_accepts_emoji_input = b; } bool accepts_emoji_input() const { return m_accepts_emoji_input; } virtual Gfx::IntRect children_clip_rect() const; Gfx::StandardCursor override_cursor() const { return m_override_cursor; } void set_override_cursor(Gfx::StandardCursor); bool load_from_json(const StringView&); bool load_from_json(const JsonObject&); Widget* find_child_by_name(const String&); Widget* find_descendant_by_name(const String&); protected: Widget(); virtual void custom_layout() { } virtual void did_change_font() { } virtual void did_layout() { } virtual void paint_event(PaintEvent&); virtual void resize_event(ResizeEvent&); virtual void show_event(ShowEvent&); virtual void hide_event(HideEvent&); virtual void keydown_event(KeyEvent&); virtual void keyup_event(KeyEvent&); virtual void mousemove_event(MouseEvent&); virtual void mousedown_event(MouseEvent&); virtual void mouseup_event(MouseEvent&); virtual void mousewheel_event(MouseEvent&); virtual void doubleclick_event(MouseEvent&); virtual void context_menu_event(ContextMenuEvent&); virtual void focusin_event(FocusEvent&); virtual void focusout_event(FocusEvent&); virtual void enter_event(Core::Event&); virtual void leave_event(Core::Event&); virtual void child_event(Core::ChildEvent&) override; virtual void change_event(Event&); virtual void drag_move_event(DragEvent&); virtual void drop_event(DropEvent&); virtual void theme_change_event(ThemeChangeEvent&); virtual void did_begin_inspection() override; virtual void did_end_inspection() override; private: void handle_paint_event(PaintEvent&); void handle_resize_event(ResizeEvent&); void handle_mousedown_event(MouseEvent&); void handle_mousedoubleclick_event(MouseEvent&); void handle_mouseup_event(MouseEvent&); void handle_enter_event(Core::Event&); void handle_leave_event(Core::Event&); void focus_previous_widget(FocusSource); void focus_next_widget(FocusSource); void show_tooltip(); Window* m_window { nullptr }; RefPtr m_layout; Gfx::IntRect m_relative_rect; Gfx::ColorRole m_background_role; Gfx::ColorRole m_foreground_role; Color m_background_color; Color m_foreground_color; NonnullRefPtr m_font; String m_tooltip; SizePolicy m_horizontal_size_policy { SizePolicy::Fill }; SizePolicy m_vertical_size_policy { SizePolicy::Fill }; Gfx::IntSize m_preferred_size; Margins m_content_margins; bool m_fill_with_background_color { false }; bool m_visible { true }; bool m_greedy_for_hits { false }; bool m_enabled { true }; bool m_updates_enabled { true }; bool m_accepts_emoji_input { false }; NonnullRefPtr m_palette; WeakPtr m_focus_proxy; FocusPolicy m_focus_policy { FocusPolicy::NoFocus }; Gfx::StandardCursor m_override_cursor { Gfx::StandardCursor::None }; }; inline Widget* Widget::parent_widget() { if (parent() && is(*parent())) return &downcast(*parent()); return nullptr; } inline const Widget* Widget::parent_widget() const { if (parent() && is(*parent())) return &downcast(*parent()); return nullptr; } } AK_BEGIN_TYPE_TRAITS(GUI::Widget) static bool is_type(const Core::Object& object) { return object.is_widget(); } AK_END_TYPE_TRAITS()