/* * 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. */ #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace GUI { REGISTER_WIDGET(Button) REGISTER_WIDGET(CheckBox) REGISTER_WIDGET(GroupBox) REGISTER_WIDGET(Label) REGISTER_WIDGET(RadioButton) REGISTER_WIDGET(ScrollBar) REGISTER_WIDGET(Slider) REGISTER_WIDGET(SpinBox) REGISTER_WIDGET(TextBox) REGISTER_WIDGET(Widget) static HashMap& widget_classes() { static HashMap* map; if (!map) map = new HashMap; return *map; } WidgetClassRegistration::WidgetClassRegistration(const String& class_name, Function()> factory) : m_class_name(class_name) , m_factory(move(factory)) { widget_classes().set(class_name, this); } WidgetClassRegistration::~WidgetClassRegistration() { } void WidgetClassRegistration::for_each(Function callback) { for (auto& it : widget_classes()) { callback(*it.value); } } const WidgetClassRegistration* WidgetClassRegistration::find(const String& class_name) { return widget_classes().get(class_name).value_or(nullptr); } Widget::Widget() : Core::Object(nullptr, true) , m_background_role(Gfx::ColorRole::Window) , m_foreground_role(Gfx::ColorRole::WindowText) , m_font(Gfx::Font::default_font()) , m_palette(Application::the().palette().impl()) { } Widget::~Widget() { } void Widget::child_event(Core::ChildEvent& event) { if (event.type() == Event::ChildAdded) { if (event.child() && Core::is(*event.child()) && layout()) { if (event.insertion_before_child() && event.insertion_before_child()->is_widget()) layout()->insert_widget_before(Core::to(*event.child()), Core::to(*event.insertion_before_child())); else layout()->add_widget(Core::to(*event.child())); } if (window() && event.child() && Core::is(*event.child())) window()->did_add_widget({}, Core::to(*event.child())); } if (event.type() == Event::ChildRemoved) { if (layout()) { if (event.child() && Core::is(*event.child())) layout()->remove_widget(Core::to(*event.child())); else invalidate_layout(); } if (window() && event.child() && Core::is(*event.child())) window()->did_remove_widget({}, Core::to(*event.child())); update(); } return Core::Object::child_event(event); } void Widget::set_relative_rect(const Gfx::Rect& a_rect) { // Get rid of negative width/height values. Gfx::Rect rect = { a_rect.x(), a_rect.y(), max(a_rect.width(), 0), max(a_rect.height(), 0) }; if (rect == m_relative_rect) return; auto old_rect = m_relative_rect; bool size_changed = m_relative_rect.size() != rect.size(); m_relative_rect = rect; if (size_changed) { ResizeEvent resize_event(m_relative_rect.size(), rect.size()); event(resize_event); } if (auto* parent = parent_widget()) parent->update(old_rect); update(); } void Widget::event(Core::Event& event) { if (!is_enabled()) { switch (event.type()) { case Event::MouseUp: case Event::MouseDown: case Event::MouseMove: case Event::MouseWheel: case Event::MouseDoubleClick: case Event::KeyUp: case Event::KeyDown: return; default: break; } } switch (event.type()) { case Event::Paint: return handle_paint_event(static_cast(event)); case Event::Resize: return handle_resize_event(static_cast(event)); case Event::FocusIn: return focusin_event(event); case Event::FocusOut: return focusout_event(event); case Event::Show: return show_event(static_cast(event)); case Event::Hide: return hide_event(static_cast(event)); case Event::KeyDown: return keydown_event(static_cast(event)); case Event::KeyUp: return keyup_event(static_cast(event)); case Event::MouseMove: return mousemove_event(static_cast(event)); case Event::MouseDown: return handle_mousedown_event(static_cast(event)); case Event::MouseDoubleClick: return handle_mousedoubleclick_event(static_cast(event)); case Event::MouseUp: return handle_mouseup_event(static_cast(event)); case Event::MouseWheel: return mousewheel_event(static_cast(event)); case Event::DragMove: return drag_move_event(static_cast(event)); case Event::Drop: return drop_event(static_cast(event)); case Event::ThemeChange: return theme_change_event(static_cast(event)); case Event::Enter: return handle_enter_event(event); case Event::Leave: return handle_leave_event(event); case Event::EnabledChange: return change_event(static_cast(event)); default: return Core::Object::event(event); } } void Widget::handle_paint_event(PaintEvent& event) { ASSERT(is_visible()); if (fill_with_background_color()) { Painter painter(*this); painter.fill_rect(event.rect(), palette().color(background_role())); } paint_event(event); for_each_child_widget([&](auto& child) { if (!child.is_visible()) return IterationDecision::Continue; if (child.relative_rect().intersects(event.rect())) { PaintEvent local_event(event.rect().intersected(child.relative_rect()).translated(-child.relative_position())); child.dispatch_event(local_event, this); } return IterationDecision::Continue; }); second_paint_event(event); if (is_being_inspected()) { Painter painter(*this); painter.draw_rect(rect(), Color::Magenta); } if (Application::the().focus_debugging_enabled()) { if (is_focused()) { Painter painter(*this); painter.draw_rect(rect(), Color::Cyan); } } } void Widget::set_layout(NonnullRefPtr layout) { if (m_layout) { m_layout->notify_disowned({}, *this); m_layout->remove_from_parent(); } m_layout = move(layout); if (m_layout) { add_child(*m_layout); m_layout->notify_adopted({}, *this); do_layout(); } else { update(); } } void Widget::do_layout() { for_each_child_widget([&](auto& child) { child.do_layout(); return IterationDecision::Continue; }); custom_layout(); if (!m_layout) return; m_layout->run(*this); did_layout(); update(); } void Widget::notify_layout_changed(Badge) { invalidate_layout(); } void Widget::handle_resize_event(ResizeEvent& event) { resize_event(event); do_layout(); } void Widget::handle_mouseup_event(MouseEvent& event) { mouseup_event(event); } void Widget::handle_mousedown_event(MouseEvent& event) { if (accepts_focus()) set_focus(true); mousedown_event(event); if (event.button() == MouseButton::Right) { ContextMenuEvent c_event(event.position(), screen_relative_rect().location().translated(event.position())); context_menu_event(c_event); } } void Widget::handle_mousedoubleclick_event(MouseEvent& event) { doubleclick_event(event); } void Widget::handle_enter_event(Core::Event& event) { if (has_tooltip()) Application::the().show_tooltip(m_tooltip, screen_relative_rect().center().translated(0, height() / 2)); enter_event(event); } void Widget::handle_leave_event(Core::Event& event) { Application::the().hide_tooltip(); leave_event(event); } void Widget::doubleclick_event(MouseEvent&) { } void Widget::resize_event(ResizeEvent&) { } void Widget::paint_event(PaintEvent&) { } void Widget::second_paint_event(PaintEvent&) { } void Widget::show_event(ShowEvent&) { } void Widget::hide_event(HideEvent&) { } void Widget::keydown_event(KeyEvent& event) { if (!event.alt() && !event.ctrl() && !event.logo() && event.key() == KeyCode::Key_Tab) { if (event.shift()) focus_previous_widget(); else focus_next_widget(); event.accept(); return; } event.ignore(); } void Widget::keyup_event(KeyEvent&) { } void Widget::mousedown_event(MouseEvent&) { } void Widget::mouseup_event(MouseEvent&) { } void Widget::mousemove_event(MouseEvent&) { } void Widget::mousewheel_event(MouseEvent&) { } void Widget::context_menu_event(ContextMenuEvent&) { } void Widget::focusin_event(Core::Event&) { } void Widget::focusout_event(Core::Event&) { } void Widget::enter_event(Core::Event&) { } void Widget::leave_event(Core::Event&) { } void Widget::change_event(Event&) { } void Widget::drag_move_event(DragEvent& event) { dbg() << class_name() << "{" << this << "} DRAG MOVE position: " << event.position() << ", data_type: '" << event.data_type() << "'"; event.ignore(); } void Widget::drop_event(DropEvent& event) { dbg() << class_name() << "{" << this << "} DROP position: " << event.position() << ", text: '" << event.text() << "'"; event.ignore(); } void Widget::theme_change_event(ThemeChangeEvent&) { } void Widget::update() { if (rect().is_empty()) return; update(rect()); } void Widget::update(const Gfx::Rect& rect) { if (!is_visible()) return; if (!updates_enabled()) return; Window* window = m_window; Widget* parent = parent_widget(); while (parent) { if (!parent->updates_enabled()) return; window = parent->m_window; parent = parent->parent_widget(); } if (window) window->update(rect.translated(window_relative_rect().location())); } Gfx::Rect Widget::window_relative_rect() const { auto rect = relative_rect(); for (auto* parent = parent_widget(); parent; parent = parent->parent_widget()) { rect.move_by(parent->relative_position()); } return rect; } Gfx::Rect Widget::screen_relative_rect() const { return window_relative_rect().translated(window()->position()); } Widget* Widget::child_at(const Gfx::Point& point) const { for (int i = children().size() - 1; i >= 0; --i) { if (!Core::is(children()[i])) continue; auto& child = Core::to(children()[i]); if (!child.is_visible()) continue; if (child.content_rect().contains(point)) return const_cast(&child); } return nullptr; } Widget::HitTestResult Widget::hit_test(const Gfx::Point& position, ShouldRespectGreediness should_respect_greediness) { if (should_respect_greediness == ShouldRespectGreediness::Yes && is_greedy_for_hits()) return { this, position }; if (auto* child = child_at(position)) return child->hit_test(position - child->relative_position()); return { this, position }; } void Widget::set_window(Window* window) { if (m_window == window) return; m_window = window; } bool Widget::is_focused() const { auto* win = window(); if (!win) return false; if (!win->is_active()) return false; return win->focused_widget() == this; } void Widget::set_focus(bool focus) { auto* win = window(); if (!win) return; if (focus) { win->set_focused_widget(this); } else { if (win->focused_widget() == this) win->set_focused_widget(nullptr); } } void Widget::set_font(const Gfx::Font* font) { if (m_font.ptr() == font) return; if (!font) m_font = Gfx::Font::default_font(); else m_font = *font; did_change_font(); update(); } void Widget::set_global_cursor_tracking(bool enabled) { auto* win = window(); if (!win) return; win->set_global_cursor_tracking_widget(enabled ? this : nullptr); } bool Widget::global_cursor_tracking() const { auto* win = window(); if (!win) return false; return win->global_cursor_tracking_widget() == this; } void Widget::set_preferred_size(const Gfx::Size& size) { if (m_preferred_size == size) return; m_preferred_size = size; invalidate_layout(); } void Widget::set_size_policy(Orientation orientation, SizePolicy policy) { if (orientation == Orientation::Horizontal) set_size_policy(policy, m_vertical_size_policy); else set_size_policy(m_horizontal_size_policy, policy); } void Widget::set_size_policy(SizePolicy horizontal_policy, SizePolicy vertical_policy) { if (m_horizontal_size_policy == horizontal_policy && m_vertical_size_policy == vertical_policy) return; m_horizontal_size_policy = horizontal_policy; m_vertical_size_policy = vertical_policy; invalidate_layout(); } void Widget::invalidate_layout() { if (window()) window()->schedule_relayout(); } void Widget::set_visible(bool visible) { if (visible == m_visible) return; m_visible = visible; if (auto* parent = parent_widget()) parent->invalidate_layout(); if (m_visible) update(); if (m_visible) { ShowEvent e; event(e); } else { HideEvent e; event(e); } } bool Widget::spans_entire_window_horizontally() const { auto* w = window(); if (!w) return false; auto* main_widget = w->main_widget(); if (!main_widget) return false; if (main_widget == this) return true; auto wrr = window_relative_rect(); return wrr.left() == main_widget->rect().left() && wrr.right() == main_widget->rect().right(); } void Widget::set_enabled(bool enabled) { if (m_enabled == enabled) return; m_enabled = enabled; for_each_child_widget([enabled](auto& child) { child.set_enabled(enabled); return IterationDecision::Continue; }); Event e(Event::EnabledChange); event(e); update(); } void Widget::move_to_front() { auto* parent = parent_widget(); if (!parent) return; if (parent->children().size() == 1) return; parent->children().remove_first_matching([this](auto& entry) { return entry == this; }); parent->children().append(*this); parent->update(); } void Widget::move_to_back() { auto* parent = parent_widget(); if (!parent) return; if (parent->children().size() == 1) return; parent->children().remove_first_matching([this](auto& entry) { return entry == this; }); parent->children().prepend(*this); parent->update(); } bool Widget::is_frontmost() const { auto* parent = parent_widget(); if (!parent) return true; return &parent->children().last() == this; } bool Widget::is_backmost() const { auto* parent = parent_widget(); if (!parent) return true; return &parent->children().first() == this; } Action* Widget::action_for_key_event(const KeyEvent& event) { Shortcut shortcut(event.modifiers(), (KeyCode)event.key()); Action* found_action = nullptr; for_each_child_of_type([&](auto& action) { if (action.shortcut() == shortcut) { found_action = &action; return IterationDecision::Break; } return IterationDecision::Continue; }); return found_action; } void Widget::set_updates_enabled(bool enabled) { if (m_updates_enabled == enabled) return; m_updates_enabled = enabled; if (enabled) update(); } void Widget::focus_previous_widget() { auto focusable_widgets = window()->focusable_widgets(); for (int i = focusable_widgets.size() - 1; i >= 0; --i) { if (focusable_widgets[i] != this) continue; if (i > 0) focusable_widgets[i - 1]->set_focus(true); else focusable_widgets.last()->set_focus(true); } } void Widget::focus_next_widget() { auto focusable_widgets = window()->focusable_widgets(); for (size_t i = 0; i < focusable_widgets.size(); ++i) { if (focusable_widgets[i] != this) continue; if (i < focusable_widgets.size() - 1) focusable_widgets[i + 1]->set_focus(true); else focusable_widgets.first()->set_focus(true); } } void Widget::set_backcolor(const StringView& color_string) { auto color = Color::from_string(color_string); if (!color.has_value()) return; set_background_color(color.value()); } void Widget::set_forecolor(const StringView& color_string) { auto color = Color::from_string(color_string); if (!color.has_value()) return; set_foreground_color(color.value()); } void Widget::save_to(AK::JsonObject& json) { json.set("relative_rect", relative_rect().to_string()); json.set("fill_with_background_color", fill_with_background_color()); json.set("tooltip", tooltip()); json.set("visible", is_visible()); json.set("focused", is_focused()); json.set("enabled", is_enabled()); json.set("background_color", background_color().to_string()); json.set("foreground_color", foreground_color().to_string()); json.set("preferred_size", preferred_size().to_string()); json.set("size_policy", String::format("[%s,%s]", to_string(horizontal_size_policy()), to_string(vertical_size_policy()))); Core::Object::save_to(json); } bool Widget::set_property(const StringView& name, const JsonValue& value) { if (name == "fill_with_background_color") { set_fill_with_background_color(value.to_bool()); return true; } if (name == "tooltip") { set_tooltip(value.to_string()); return true; } if (name == "enable") { set_enabled(value.to_bool()); return true; } if (name == "focused") { set_focus(value.to_bool()); return true; } if (name == "visible") { set_visible(value.to_bool()); return true; } return Core::Object::set_property(name, value); } Vector Widget::child_widgets() const { Vector widgets; widgets.ensure_capacity(children().size()); for (auto& child : const_cast(this)->children()) { if (child.is_widget()) widgets.append(static_cast(&child)); } return widgets; } void Widget::set_palette(const Palette& palette) { m_palette = palette.impl(); } void Widget::set_background_role(ColorRole role) { m_background_role = role; } void Widget::set_foreground_role(ColorRole role) { m_foreground_role = role; } Gfx::Palette Widget::palette() const { return Gfx::Palette(*m_palette); } void Widget::did_begin_inspection() { update(); } void Widget::did_end_inspection() { update(); } void Widget::set_content_margins(const Margins& margins) { if (m_content_margins == margins) return; m_content_margins = margins; invalidate_layout(); } Gfx::Rect Widget::content_rect() const { auto rect = relative_rect(); rect.move_by(m_content_margins.left(), m_content_margins.top()); rect.set_width(rect.width() - (m_content_margins.left() + m_content_margins.right())); rect.set_height(rect.height() - (m_content_margins.top() + m_content_margins.bottom())); return rect; } }