Widget.cpp 36 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244
  1. /*
  2. * Copyright (c) 2018-2020, Andreas Kling <kling@serenityos.org>
  3. * Copyright (c) 2022, the SerenityOS developers.
  4. *
  5. * SPDX-License-Identifier: BSD-2-Clause
  6. */
  7. #include <AK/Assertions.h>
  8. #include <AK/Debug.h>
  9. #include <AK/IterationDecision.h>
  10. #include <AK/JsonObject.h>
  11. #include <AK/NonnullRefPtr.h>
  12. #include <AK/RefPtr.h>
  13. #include <LibGUI/Action.h>
  14. #include <LibGUI/Application.h>
  15. #include <LibGUI/BoxLayout.h>
  16. #include <LibGUI/ConnectionToWindowServer.h>
  17. #include <LibGUI/Event.h>
  18. #include <LibGUI/GML/AST.h>
  19. #include <LibGUI/GML/Parser.h>
  20. #include <LibGUI/Layout.h>
  21. #include <LibGUI/Menu.h>
  22. #include <LibGUI/Painter.h>
  23. #include <LibGUI/TabWidget.h>
  24. #include <LibGUI/Widget.h>
  25. #include <LibGUI/Window.h>
  26. #include <LibGfx/Bitmap.h>
  27. #include <LibGfx/Font/Font.h>
  28. #include <LibGfx/Font/FontDatabase.h>
  29. #include <LibGfx/Palette.h>
  30. #include <LibGfx/SystemTheme.h>
  31. #include <unistd.h>
  32. REGISTER_CORE_OBJECT(GUI, Widget)
  33. namespace GUI {
  34. Widget::Widget()
  35. : Core::Object(nullptr)
  36. , m_background_role(Gfx::ColorRole::Window)
  37. , m_foreground_role(Gfx::ColorRole::WindowText)
  38. , m_font(Gfx::FontDatabase::default_font())
  39. , m_palette(Application::the()->palette().impl())
  40. {
  41. REGISTER_RECT_PROPERTY("relative_rect", relative_rect, set_relative_rect);
  42. REGISTER_BOOL_PROPERTY("fill_with_background_color", fill_with_background_color, set_fill_with_background_color);
  43. REGISTER_BOOL_PROPERTY("visible", is_visible, set_visible);
  44. REGISTER_BOOL_PROPERTY("focused", is_focused, set_focus);
  45. REGISTER_BOOL_PROPERTY("enabled", is_enabled, set_enabled);
  46. REGISTER_STRING_PROPERTY("tooltip", tooltip, set_tooltip);
  47. REGISTER_UI_SIZE_PROPERTY("min_size", min_size, set_min_size);
  48. REGISTER_READONLY_UI_SIZE_PROPERTY("effective_min_size", effective_min_size);
  49. REGISTER_UI_SIZE_PROPERTY("max_size", max_size, set_max_size);
  50. REGISTER_UI_SIZE_PROPERTY("preferred_size", preferred_size, set_preferred_size);
  51. REGISTER_READONLY_UI_SIZE_PROPERTY("effective_preferred_size", effective_preferred_size);
  52. REGISTER_INT_PROPERTY("width", width, set_width);
  53. REGISTER_UI_DIMENSION_PROPERTY("min_width", min_width, set_min_width);
  54. REGISTER_UI_DIMENSION_PROPERTY("max_width", max_width, set_max_width);
  55. REGISTER_UI_DIMENSION_PROPERTY("preferred_width", preferred_width, set_preferred_width);
  56. REGISTER_INT_PROPERTY("height", height, set_height);
  57. REGISTER_UI_DIMENSION_PROPERTY("min_height", min_height, set_min_height);
  58. REGISTER_UI_DIMENSION_PROPERTY("max_height", max_height, set_max_height);
  59. REGISTER_UI_DIMENSION_PROPERTY("preferred_height", preferred_height, set_preferred_height);
  60. REGISTER_INT_PROPERTY("fixed_width", dummy_fixed_width, set_fixed_width);
  61. REGISTER_INT_PROPERTY("fixed_height", dummy_fixed_height, set_fixed_height);
  62. REGISTER_SIZE_PROPERTY("fixed_size", dummy_fixed_size, set_fixed_size);
  63. REGISTER_BOOL_PROPERTY("shrink_to_fit", is_shrink_to_fit, set_shrink_to_fit);
  64. REGISTER_INT_PROPERTY("x", x, set_x);
  65. REGISTER_INT_PROPERTY("y", y, set_y);
  66. REGISTER_STRING_PROPERTY("font", m_font->family, set_font_family);
  67. REGISTER_INT_PROPERTY("font_size", m_font->presentation_size, set_font_size);
  68. REGISTER_FONT_WEIGHT_PROPERTY("font_weight", m_font->weight, set_font_weight);
  69. REGISTER_STRING_PROPERTY("title", title, set_title);
  70. register_property(
  71. "font_type", [this] { return m_font->is_fixed_width() ? "FixedWidth" : "Normal"; },
  72. [this](auto& value) {
  73. if (value.to_string() == "FixedWidth") {
  74. set_font_fixed_width(true);
  75. return true;
  76. }
  77. if (value.to_string() == "Normal") {
  78. set_font_fixed_width(false);
  79. return true;
  80. }
  81. return false;
  82. });
  83. register_property(
  84. "focus_policy", [this]() -> JsonValue {
  85. auto policy = focus_policy();
  86. if (policy == GUI::FocusPolicy::ClickFocus)
  87. return "ClickFocus";
  88. if (policy == GUI::FocusPolicy::NoFocus)
  89. return "NoFocus";
  90. if (policy == GUI::FocusPolicy::TabFocus)
  91. return "TabFocus";
  92. if (policy == GUI::FocusPolicy::StrongFocus)
  93. return "StrongFocus";
  94. return JsonValue(); },
  95. [this](auto& value) {
  96. if (!value.is_string())
  97. return false;
  98. if (value.as_string() == "ClickFocus") {
  99. set_focus_policy(GUI::FocusPolicy::ClickFocus);
  100. return true;
  101. }
  102. if (value.as_string() == "NoFocus") {
  103. set_focus_policy(GUI::FocusPolicy::NoFocus);
  104. return true;
  105. }
  106. if (value.as_string() == "TabFocus") {
  107. set_focus_policy(GUI::FocusPolicy::TabFocus);
  108. return true;
  109. }
  110. if (value.as_string() == "StrongFocus") {
  111. set_focus_policy(GUI::FocusPolicy::StrongFocus);
  112. return true;
  113. }
  114. return false;
  115. });
  116. register_property(
  117. "foreground_color", [this]() -> JsonValue { return palette().color(foreground_role()).to_string(); },
  118. [this](auto& value) {
  119. auto c = Color::from_string(value.to_string());
  120. if (c.has_value()) {
  121. auto _palette = palette();
  122. _palette.set_color(foreground_role(), c.value());
  123. set_palette(_palette);
  124. return true;
  125. }
  126. return false;
  127. });
  128. register_property(
  129. "background_color", [this]() -> JsonValue { return palette().color(background_role()).to_string(); },
  130. [this](auto& value) {
  131. auto c = Color::from_string(value.to_string());
  132. if (c.has_value()) {
  133. auto _palette = palette();
  134. _palette.set_color(background_role(), c.value());
  135. set_palette(_palette);
  136. return true;
  137. }
  138. return false;
  139. });
  140. register_property(
  141. "foreground_role", [this]() -> JsonValue { return Gfx::to_string(foreground_role()); },
  142. [this](auto& value) {
  143. if (!value.is_string())
  144. return false;
  145. auto str = value.as_string();
  146. if (str == "NoRole") {
  147. set_foreground_role(Gfx::ColorRole::NoRole);
  148. return true;
  149. }
  150. #undef __ENUMERATE_COLOR_ROLE
  151. #define __ENUMERATE_COLOR_ROLE(role) \
  152. else if (str == #role) \
  153. { \
  154. set_foreground_role(Gfx::ColorRole::role); \
  155. return true; \
  156. }
  157. ENUMERATE_COLOR_ROLES(__ENUMERATE_COLOR_ROLE)
  158. #undef __ENUMERATE_COLOR_ROLE
  159. return false;
  160. });
  161. register_property(
  162. "background_role", [this]() -> JsonValue { return Gfx::to_string(background_role()); },
  163. [this](auto& value) {
  164. if (!value.is_string())
  165. return false;
  166. auto str = value.as_string();
  167. if (str == "NoRole") {
  168. set_background_role(Gfx::ColorRole::NoRole);
  169. return true;
  170. }
  171. #undef __ENUMERATE_COLOR_ROLE
  172. #define __ENUMERATE_COLOR_ROLE(role) \
  173. else if (str == #role) \
  174. { \
  175. set_background_role(Gfx::ColorRole::role); \
  176. return true; \
  177. }
  178. ENUMERATE_COLOR_ROLES(__ENUMERATE_COLOR_ROLE)
  179. #undef __ENUMERATE_COLOR_ROLE
  180. return false;
  181. });
  182. }
  183. Widget::~Widget() = default;
  184. void Widget::layout_relevant_change_occured()
  185. {
  186. if (is_visible()) {
  187. if (auto* parent = parent_widget())
  188. parent->layout_relevant_change_occured();
  189. else if (window())
  190. window()->schedule_relayout();
  191. }
  192. }
  193. void Widget::child_event(Core::ChildEvent& event)
  194. {
  195. if (event.type() == Event::ChildAdded) {
  196. if (event.child() && is<Widget>(*event.child()) && layout()) {
  197. if (event.insertion_before_child() && is<Widget>(event.insertion_before_child()))
  198. layout()->insert_widget_before(verify_cast<Widget>(*event.child()), verify_cast<Widget>(*event.insertion_before_child()));
  199. else
  200. layout()->add_widget(verify_cast<Widget>(*event.child()));
  201. layout_relevant_change_occured();
  202. }
  203. if (window() && event.child() && is<Widget>(*event.child()))
  204. window()->did_add_widget({}, verify_cast<Widget>(*event.child()));
  205. }
  206. if (event.type() == Event::ChildRemoved) {
  207. if (layout()) {
  208. if (event.child() && is<Widget>(*event.child()))
  209. layout()->remove_widget(verify_cast<Widget>(*event.child()));
  210. layout_relevant_change_occured();
  211. }
  212. if (window() && event.child() && is<Widget>(*event.child()))
  213. window()->did_remove_widget({}, verify_cast<Widget>(*event.child()));
  214. update();
  215. }
  216. return Core::Object::child_event(event);
  217. }
  218. void Widget::set_relative_rect(Gfx::IntRect const& a_rect)
  219. {
  220. // Get rid of negative width/height values.
  221. Gfx::IntRect rect = {
  222. a_rect.x(),
  223. a_rect.y(),
  224. max(a_rect.width(), 0),
  225. max(a_rect.height(), 0)
  226. };
  227. if (rect == m_relative_rect)
  228. return;
  229. auto old_rect = m_relative_rect;
  230. bool size_changed = m_relative_rect.size() != rect.size();
  231. m_relative_rect = rect;
  232. if (size_changed) {
  233. ResizeEvent resize_event(rect.size());
  234. event(resize_event);
  235. }
  236. if (auto* parent = parent_widget())
  237. parent->update(old_rect);
  238. update();
  239. }
  240. void Widget::event(Core::Event& event)
  241. {
  242. if (!is_enabled()) {
  243. switch (event.type()) {
  244. case Event::MouseUp:
  245. case Event::MouseDown:
  246. case Event::MouseMove:
  247. case Event::MouseWheel:
  248. case Event::MouseDoubleClick:
  249. case Event::KeyUp:
  250. case Event::KeyDown:
  251. return;
  252. default:
  253. break;
  254. }
  255. }
  256. switch (event.type()) {
  257. case Event::Paint:
  258. return handle_paint_event(static_cast<PaintEvent&>(event));
  259. case Event::Resize:
  260. return handle_resize_event(static_cast<ResizeEvent&>(event));
  261. case Event::FocusIn:
  262. return focusin_event(static_cast<FocusEvent&>(event));
  263. case Event::FocusOut:
  264. return focusout_event(static_cast<FocusEvent&>(event));
  265. case Event::Show:
  266. return show_event(static_cast<ShowEvent&>(event));
  267. case Event::Hide:
  268. return hide_event(static_cast<HideEvent&>(event));
  269. case Event::KeyDown:
  270. return handle_keydown_event(static_cast<KeyEvent&>(event));
  271. case Event::KeyUp:
  272. return keyup_event(static_cast<KeyEvent&>(event));
  273. case Event::MouseMove:
  274. return mousemove_event(static_cast<MouseEvent&>(event));
  275. case Event::MouseDown:
  276. return handle_mousedown_event(static_cast<MouseEvent&>(event));
  277. case Event::MouseDoubleClick:
  278. return handle_mousedoubleclick_event(static_cast<MouseEvent&>(event));
  279. case Event::MouseUp:
  280. return handle_mouseup_event(static_cast<MouseEvent&>(event));
  281. case Event::MouseWheel:
  282. return mousewheel_event(static_cast<MouseEvent&>(event));
  283. case Event::DragEnter:
  284. return drag_enter_event(static_cast<DragEvent&>(event));
  285. case Event::DragMove:
  286. return drag_move_event(static_cast<DragEvent&>(event));
  287. case Event::DragLeave:
  288. return drag_leave_event(static_cast<Event&>(event));
  289. case Event::Drop:
  290. return drop_event(static_cast<DropEvent&>(event));
  291. case Event::ThemeChange:
  292. return theme_change_event(static_cast<ThemeChangeEvent&>(event));
  293. case Event::FontsChange:
  294. return fonts_change_event(static_cast<FontsChangeEvent&>(event));
  295. case Event::Enter:
  296. return handle_enter_event(event);
  297. case Event::Leave:
  298. return handle_leave_event(event);
  299. case Event::EnabledChange:
  300. return change_event(static_cast<Event&>(event));
  301. case Event::ContextMenu:
  302. return context_menu_event(static_cast<ContextMenuEvent&>(event));
  303. case Event::AppletAreaRectChange:
  304. return applet_area_rect_change_event(static_cast<AppletAreaRectChangeEvent&>(event));
  305. default:
  306. return Core::Object::event(event);
  307. }
  308. }
  309. void Widget::handle_keydown_event(KeyEvent& event)
  310. {
  311. keydown_event(event);
  312. if (event.key() == KeyCode::Key_Menu) {
  313. ContextMenuEvent c_event(window_relative_rect().bottom_right(), screen_relative_rect().bottom_right());
  314. dispatch_event(c_event);
  315. }
  316. }
  317. void Widget::handle_paint_event(PaintEvent& event)
  318. {
  319. VERIFY(is_visible());
  320. if (!rect().intersects(event.rect())) {
  321. // This widget is not inside the paint event rect.
  322. // Since widgets fully contain their children, we don't need to recurse further.
  323. return;
  324. }
  325. if (fill_with_background_color()) {
  326. Painter painter(*this);
  327. painter.fill_rect(event.rect(), palette().color(background_role()));
  328. }
  329. paint_event(event);
  330. auto children_clip_rect = this->children_clip_rect();
  331. for_each_child_widget([&](auto& child) {
  332. if (!child.is_visible())
  333. return IterationDecision::Continue;
  334. if (child.relative_rect().intersects(event.rect())) {
  335. PaintEvent local_event(event.rect().intersected(children_clip_rect).intersected(child.relative_rect()).translated(-child.relative_position()));
  336. child.dispatch_event(local_event, this);
  337. }
  338. return IterationDecision::Continue;
  339. });
  340. second_paint_event(event);
  341. auto* app = Application::the();
  342. if (app && app->dnd_debugging_enabled() && has_pending_drop()) {
  343. Painter painter(*this);
  344. painter.draw_rect(rect(), Color::Blue);
  345. }
  346. if (app && app->focus_debugging_enabled() && is_focused()) {
  347. Painter painter(*this);
  348. painter.draw_rect(rect(), Color::Cyan);
  349. }
  350. if (app && app->hover_debugging_enabled() && this == window()->hovered_widget()) {
  351. Painter painter(*this);
  352. painter.draw_rect(rect(), Color::Red);
  353. }
  354. if (is_being_inspected()) {
  355. Painter painter(*this);
  356. painter.draw_rect(rect(), Color::Magenta);
  357. }
  358. }
  359. void Widget::set_layout(NonnullRefPtr<Layout> layout)
  360. {
  361. if (m_layout) {
  362. m_layout->notify_disowned({}, *this);
  363. m_layout->remove_from_parent();
  364. }
  365. m_layout = move(layout);
  366. if (m_layout) {
  367. add_child(*m_layout);
  368. m_layout->notify_adopted({}, *this);
  369. do_layout();
  370. } else {
  371. update();
  372. }
  373. layout_relevant_change_occured();
  374. }
  375. void Widget::do_layout()
  376. {
  377. for_each_child_widget([&](auto& child) {
  378. child.do_layout();
  379. return IterationDecision::Continue;
  380. });
  381. custom_layout();
  382. if (!m_layout)
  383. return;
  384. m_layout->run(*this);
  385. did_layout();
  386. update();
  387. }
  388. void Widget::notify_layout_changed(Badge<Layout>)
  389. {
  390. invalidate_layout();
  391. }
  392. void Widget::handle_resize_event(ResizeEvent& event)
  393. {
  394. resize_event(event);
  395. do_layout();
  396. }
  397. void Widget::handle_mouseup_event(MouseEvent& event)
  398. {
  399. mouseup_event(event);
  400. }
  401. void Widget::handle_mousedown_event(MouseEvent& event)
  402. {
  403. if (has_flag(focus_policy(), FocusPolicy::ClickFocus))
  404. set_focus(true, FocusSource::Mouse);
  405. mousedown_event(event);
  406. if (event.button() == MouseButton::Secondary) {
  407. ContextMenuEvent c_event(event.position(), screen_relative_rect().location().translated(event.position()));
  408. dispatch_event(c_event);
  409. }
  410. }
  411. void Widget::handle_mousedoubleclick_event(MouseEvent& event)
  412. {
  413. doubleclick_event(event);
  414. }
  415. void Widget::handle_enter_event(Core::Event& event)
  416. {
  417. if (auto* window = this->window())
  418. window->update_cursor({});
  419. show_or_hide_tooltip();
  420. enter_event(event);
  421. }
  422. void Widget::handle_leave_event(Core::Event& event)
  423. {
  424. if (auto* window = this->window())
  425. window->update_cursor({});
  426. Application::the()->hide_tooltip();
  427. leave_event(event);
  428. }
  429. void Widget::doubleclick_event(MouseEvent&)
  430. {
  431. }
  432. void Widget::resize_event(ResizeEvent&)
  433. {
  434. }
  435. void Widget::paint_event(PaintEvent&)
  436. {
  437. }
  438. void Widget::second_paint_event(PaintEvent&)
  439. {
  440. }
  441. void Widget::show_event(ShowEvent&)
  442. {
  443. }
  444. void Widget::hide_event(HideEvent&)
  445. {
  446. }
  447. void Widget::keydown_event(KeyEvent& event)
  448. {
  449. if (!event.alt() && !event.ctrl() && !event.super()) {
  450. if (event.key() == KeyCode::Key_Tab) {
  451. if (event.shift())
  452. focus_previous_widget(FocusSource::Keyboard, false);
  453. else
  454. focus_next_widget(FocusSource::Keyboard, false);
  455. event.accept();
  456. return;
  457. }
  458. if (!event.shift() && (event.key() == KeyCode::Key_Left || event.key() == KeyCode::Key_Up)) {
  459. focus_previous_widget(FocusSource::Keyboard, true);
  460. event.accept();
  461. return;
  462. }
  463. if (!event.shift() && (event.key() == KeyCode::Key_Right || event.key() == KeyCode::Key_Down)) {
  464. focus_next_widget(FocusSource::Keyboard, true);
  465. event.accept();
  466. return;
  467. }
  468. }
  469. event.ignore();
  470. }
  471. void Widget::keyup_event(KeyEvent& event)
  472. {
  473. event.ignore();
  474. }
  475. void Widget::mousedown_event(MouseEvent&)
  476. {
  477. }
  478. void Widget::mouseup_event(MouseEvent&)
  479. {
  480. }
  481. void Widget::mousemove_event(MouseEvent&)
  482. {
  483. }
  484. void Widget::mousewheel_event(MouseEvent& event)
  485. {
  486. event.ignore();
  487. }
  488. void Widget::context_menu_event(ContextMenuEvent& event)
  489. {
  490. event.ignore();
  491. }
  492. void Widget::focusin_event(FocusEvent&)
  493. {
  494. }
  495. void Widget::focusout_event(FocusEvent&)
  496. {
  497. }
  498. void Widget::enter_event(Core::Event&)
  499. {
  500. }
  501. void Widget::leave_event(Core::Event&)
  502. {
  503. }
  504. void Widget::change_event(Event&)
  505. {
  506. }
  507. void Widget::drag_move_event(DragEvent&)
  508. {
  509. }
  510. void Widget::drag_enter_event(DragEvent& event)
  511. {
  512. StringBuilder builder;
  513. builder.join(',', event.mime_types());
  514. dbgln_if(DRAG_DEBUG, "{} {:p} DRAG ENTER @ {}, {}", class_name(), this, event.position(), builder.string_view());
  515. }
  516. void Widget::drag_leave_event(Event&)
  517. {
  518. dbgln_if(DRAG_DEBUG, "{} {:p} DRAG LEAVE", class_name(), this);
  519. }
  520. void Widget::drop_event(DropEvent& event)
  521. {
  522. dbgln_if(DRAG_DEBUG, "{} {:p} DROP @ {}, '{}'", class_name(), this, event.position(), event.text());
  523. event.ignore();
  524. }
  525. void Widget::theme_change_event(ThemeChangeEvent&)
  526. {
  527. }
  528. void Widget::fonts_change_event(FontsChangeEvent&)
  529. {
  530. if (m_default_font)
  531. set_font(nullptr);
  532. }
  533. void Widget::screen_rects_change_event(ScreenRectsChangeEvent&)
  534. {
  535. }
  536. void Widget::applet_area_rect_change_event(AppletAreaRectChangeEvent&)
  537. {
  538. }
  539. void Widget::update()
  540. {
  541. if (rect().is_empty())
  542. return;
  543. update(rect());
  544. }
  545. void Widget::update(Gfx::IntRect const& rect)
  546. {
  547. if (!is_visible())
  548. return;
  549. if (!updates_enabled())
  550. return;
  551. auto bound_by_widget = rect.intersected(this->rect());
  552. if (bound_by_widget.is_empty())
  553. return;
  554. Window* window = m_window;
  555. Widget* parent = parent_widget();
  556. while (parent) {
  557. if (!parent->updates_enabled())
  558. return;
  559. window = parent->m_window;
  560. parent = parent->parent_widget();
  561. }
  562. if (window)
  563. window->update(bound_by_widget.translated(window_relative_rect().location()));
  564. }
  565. void Widget::repaint()
  566. {
  567. if (rect().is_empty())
  568. return;
  569. repaint(rect());
  570. }
  571. void Widget::repaint(Gfx::IntRect const& rect)
  572. {
  573. auto* window = this->window();
  574. if (!window)
  575. return;
  576. update(rect);
  577. window->flush_pending_paints_immediately();
  578. }
  579. Gfx::IntRect Widget::window_relative_rect() const
  580. {
  581. auto rect = relative_rect();
  582. for (auto* parent = parent_widget(); parent; parent = parent->parent_widget()) {
  583. rect.translate_by(parent->relative_position());
  584. }
  585. return rect;
  586. }
  587. Gfx::IntRect Widget::screen_relative_rect() const
  588. {
  589. auto window_position = window()->window_type() == WindowType::Applet
  590. ? window()->applet_rect_on_screen().location()
  591. : window()->rect().location();
  592. return window_relative_rect().translated(window_position);
  593. }
  594. Widget* Widget::child_at(Gfx::IntPoint const& point) const
  595. {
  596. for (int i = children().size() - 1; i >= 0; --i) {
  597. if (!is<Widget>(children()[i]))
  598. continue;
  599. auto& child = verify_cast<Widget>(children()[i]);
  600. if (!child.is_visible())
  601. continue;
  602. if (child.relative_non_grabbable_rect().contains(point))
  603. return const_cast<Widget*>(&child);
  604. }
  605. return nullptr;
  606. }
  607. Widget::HitTestResult Widget::hit_test(Gfx::IntPoint const& position, ShouldRespectGreediness should_respect_greediness)
  608. {
  609. if (should_respect_greediness == ShouldRespectGreediness::Yes && is_greedy_for_hits())
  610. return { this, position };
  611. if (auto* child = child_at(position))
  612. return child->hit_test(position - child->relative_position());
  613. return { this, position };
  614. }
  615. void Widget::set_window(Window* window)
  616. {
  617. if (m_window == window)
  618. return;
  619. m_window = window;
  620. }
  621. void Widget::set_focus_proxy(Widget* proxy)
  622. {
  623. if (m_focus_proxy == proxy)
  624. return;
  625. m_focus_proxy = proxy;
  626. }
  627. FocusPolicy Widget::focus_policy() const
  628. {
  629. if (m_focus_proxy)
  630. return m_focus_proxy->focus_policy();
  631. return m_focus_policy;
  632. }
  633. void Widget::set_focus_policy(FocusPolicy policy)
  634. {
  635. if (m_focus_proxy)
  636. return m_focus_proxy->set_focus_policy(policy);
  637. m_focus_policy = policy;
  638. }
  639. bool Widget::is_focused() const
  640. {
  641. if (m_focus_proxy)
  642. return m_focus_proxy->is_focused();
  643. auto* win = window();
  644. if (!win)
  645. return false;
  646. // Accessory windows are not active despite being the active
  647. // input window. So we can have focus if either we're the active
  648. // input window or we're the active window
  649. if (win->is_active_input() || win->is_active())
  650. return win->focused_widget() == this;
  651. return false;
  652. }
  653. void Widget::set_focus(bool focus, FocusSource source)
  654. {
  655. if (m_focus_proxy)
  656. return m_focus_proxy->set_focus(focus, source);
  657. auto* win = window();
  658. if (!win)
  659. return;
  660. if (focus) {
  661. win->set_focused_widget(this, source);
  662. } else {
  663. if (win->focused_widget() == this)
  664. win->set_focused_widget(nullptr, source);
  665. }
  666. }
  667. void Widget::set_font(Gfx::Font const* font)
  668. {
  669. if (m_font.ptr() == font)
  670. return;
  671. if (!font) {
  672. m_font = Gfx::FontDatabase::default_font();
  673. m_default_font = true;
  674. } else {
  675. m_font = *font;
  676. m_default_font = false;
  677. }
  678. did_change_font();
  679. update();
  680. }
  681. void Widget::set_font_family(String const& family)
  682. {
  683. set_font(Gfx::FontDatabase::the().get(family, m_font->presentation_size(), m_font->weight(), m_font->slope()));
  684. }
  685. void Widget::set_font_size(unsigned size)
  686. {
  687. set_font(Gfx::FontDatabase::the().get(m_font->family(), size, m_font->weight(), m_font->slope()));
  688. }
  689. void Widget::set_font_weight(unsigned weight)
  690. {
  691. set_font(Gfx::FontDatabase::the().get(m_font->family(), m_font->presentation_size(), weight, m_font->slope()));
  692. }
  693. void Widget::set_font_fixed_width(bool fixed_width)
  694. {
  695. if (fixed_width)
  696. set_font(Gfx::FontDatabase::the().get(Gfx::FontDatabase::the().default_fixed_width_font().family(), m_font->presentation_size(), m_font->weight(), m_font->slope()));
  697. else
  698. set_font(Gfx::FontDatabase::the().get(Gfx::FontDatabase::the().default_font().family(), m_font->presentation_size(), m_font->weight(), m_font->slope()));
  699. }
  700. void Widget::set_min_size(UISize const& size)
  701. {
  702. VERIFY(size.width().is_one_of(SpecialDimension::Regular, SpecialDimension::Shrink));
  703. if (m_min_size == size)
  704. return;
  705. m_min_size = size;
  706. layout_relevant_change_occured();
  707. }
  708. void Widget::set_max_size(UISize const& size)
  709. {
  710. VERIFY(size.width().is_one_of(SpecialDimension::Regular, SpecialDimension::Grow));
  711. if (m_max_size == size)
  712. return;
  713. m_max_size = size;
  714. layout_relevant_change_occured();
  715. }
  716. void Widget::set_preferred_size(UISize const& size)
  717. {
  718. if (m_preferred_size == size)
  719. return;
  720. m_preferred_size = size;
  721. layout_relevant_change_occured();
  722. }
  723. Optional<UISize> Widget::calculated_preferred_size() const
  724. {
  725. if (layout())
  726. return { layout()->preferred_size() };
  727. return {};
  728. }
  729. Optional<UISize> Widget::calculated_min_size() const
  730. {
  731. if (layout())
  732. return { layout()->min_size() };
  733. // Fall back to at least displaying the margins, so the Widget is not 0 size.
  734. auto m = content_margins();
  735. if (!m.is_null())
  736. return UISize { m.left() + m.right(), m.top() + m.bottom() };
  737. return {};
  738. }
  739. void Widget::invalidate_layout()
  740. {
  741. if (window())
  742. window()->schedule_relayout();
  743. }
  744. void Widget::set_visible(bool visible)
  745. {
  746. if (visible == m_visible)
  747. return;
  748. m_visible = visible;
  749. layout_relevant_change_occured();
  750. if (m_visible)
  751. update();
  752. if (!m_visible && is_focused())
  753. set_focus(false);
  754. if (m_visible) {
  755. ShowEvent e;
  756. event(e);
  757. } else {
  758. HideEvent e;
  759. event(e);
  760. }
  761. }
  762. bool Widget::spans_entire_window_horizontally() const
  763. {
  764. auto* w = window();
  765. if (!w)
  766. return false;
  767. auto* main_widget = w->main_widget();
  768. if (!main_widget)
  769. return false;
  770. if (main_widget == this)
  771. return true;
  772. auto wrr = window_relative_rect();
  773. return wrr.left() == main_widget->rect().left() && wrr.right() == main_widget->rect().right();
  774. }
  775. void Widget::set_enabled(bool enabled)
  776. {
  777. if (m_enabled == enabled)
  778. return;
  779. m_enabled = enabled;
  780. for_each_child_widget([enabled](auto& child) {
  781. child.set_enabled(enabled);
  782. return IterationDecision::Continue;
  783. });
  784. if (!m_enabled && window() && window()->focused_widget() == this) {
  785. window()->did_disable_focused_widget({});
  786. }
  787. if (!m_enabled)
  788. set_override_cursor(Gfx::StandardCursor::None);
  789. Event e(Event::EnabledChange);
  790. event(e);
  791. update();
  792. }
  793. void Widget::move_to_front()
  794. {
  795. auto* parent = parent_widget();
  796. if (!parent)
  797. return;
  798. if (parent->children().size() == 1)
  799. return;
  800. parent->children().remove_first_matching([this](auto& entry) {
  801. return entry == this;
  802. });
  803. parent->children().append(*this);
  804. parent->update();
  805. }
  806. void Widget::move_to_back()
  807. {
  808. auto* parent = parent_widget();
  809. if (!parent)
  810. return;
  811. if (parent->children().size() == 1)
  812. return;
  813. parent->children().remove_first_matching([this](auto& entry) {
  814. return entry == this;
  815. });
  816. parent->children().prepend(*this);
  817. parent->update();
  818. }
  819. bool Widget::is_frontmost() const
  820. {
  821. auto* parent = parent_widget();
  822. if (!parent)
  823. return true;
  824. return &parent->children().last() == this;
  825. }
  826. bool Widget::is_backmost() const
  827. {
  828. auto* parent = parent_widget();
  829. if (!parent)
  830. return true;
  831. return &parent->children().first() == this;
  832. }
  833. Action* Widget::action_for_shortcut(Shortcut const& shortcut)
  834. {
  835. Action* found_action = nullptr;
  836. for_each_child_of_type<Action>([&](auto& action) {
  837. if (action.shortcut() == shortcut || action.alternate_shortcut() == shortcut) {
  838. found_action = &action;
  839. return IterationDecision::Break;
  840. }
  841. return IterationDecision::Continue;
  842. });
  843. return found_action;
  844. }
  845. void Widget::set_updates_enabled(bool enabled)
  846. {
  847. if (m_updates_enabled == enabled)
  848. return;
  849. m_updates_enabled = enabled;
  850. if (enabled)
  851. update();
  852. }
  853. void Widget::focus_previous_widget(FocusSource source, bool siblings_only)
  854. {
  855. auto focusable_widgets = window()->focusable_widgets(source);
  856. if (siblings_only)
  857. focusable_widgets.remove_all_matching([this](auto& entry) { return entry.parent() != parent(); });
  858. for (int i = focusable_widgets.size() - 1; i >= 0; --i) {
  859. if (&focusable_widgets[i] != this)
  860. continue;
  861. if (i > 0)
  862. focusable_widgets[i - 1].set_focus(true, source);
  863. else
  864. focusable_widgets.last().set_focus(true, source);
  865. }
  866. }
  867. void Widget::focus_next_widget(FocusSource source, bool siblings_only)
  868. {
  869. auto focusable_widgets = window()->focusable_widgets(source);
  870. if (siblings_only)
  871. focusable_widgets.remove_all_matching([this](auto& entry) { return entry.parent() != parent(); });
  872. for (size_t i = 0; i < focusable_widgets.size(); ++i) {
  873. if (&focusable_widgets[i] != this)
  874. continue;
  875. if (i < focusable_widgets.size() - 1)
  876. focusable_widgets[i + 1].set_focus(true, source);
  877. else
  878. focusable_widgets.first().set_focus(true, source);
  879. }
  880. }
  881. Vector<Widget&> Widget::child_widgets() const
  882. {
  883. Vector<Widget&> widgets;
  884. widgets.ensure_capacity(children().size());
  885. for (auto& child : const_cast<Widget*>(this)->children()) {
  886. if (is<Widget>(child))
  887. widgets.append(static_cast<Widget&>(child));
  888. }
  889. return widgets;
  890. }
  891. void Widget::set_palette(Palette const& palette)
  892. {
  893. m_palette = palette.impl();
  894. update();
  895. }
  896. void Widget::set_title(String title)
  897. {
  898. m_title = move(title);
  899. layout_relevant_change_occured();
  900. // For tab widget children, our change in title also affects the parent.
  901. if (parent_widget())
  902. parent_widget()->update();
  903. }
  904. String Widget::title() const
  905. {
  906. return m_title;
  907. }
  908. void Widget::set_background_role(ColorRole role)
  909. {
  910. m_background_role = role;
  911. update();
  912. }
  913. void Widget::set_foreground_role(ColorRole role)
  914. {
  915. m_foreground_role = role;
  916. update();
  917. }
  918. Gfx::Palette Widget::palette() const
  919. {
  920. return Gfx::Palette(*m_palette);
  921. }
  922. void Widget::did_begin_inspection()
  923. {
  924. update();
  925. }
  926. void Widget::did_end_inspection()
  927. {
  928. update();
  929. }
  930. void Widget::set_grabbable_margins(Margins const& margins)
  931. {
  932. if (m_grabbable_margins == margins)
  933. return;
  934. m_grabbable_margins = margins;
  935. layout_relevant_change_occured();
  936. }
  937. Gfx::IntRect Widget::relative_non_grabbable_rect() const
  938. {
  939. auto rect = relative_rect();
  940. rect.translate_by(m_grabbable_margins.left(), m_grabbable_margins.top());
  941. rect.set_width(rect.width() - (m_grabbable_margins.left() + m_grabbable_margins.right()));
  942. rect.set_height(rect.height() - (m_grabbable_margins.top() + m_grabbable_margins.bottom()));
  943. return rect;
  944. }
  945. void Widget::set_tooltip(String tooltip)
  946. {
  947. m_tooltip = move(tooltip);
  948. if (Application::the()->tooltip_source_widget() == this)
  949. show_or_hide_tooltip();
  950. }
  951. void Widget::show_or_hide_tooltip()
  952. {
  953. if (has_tooltip())
  954. Application::the()->show_tooltip(m_tooltip, this);
  955. else
  956. Application::the()->hide_tooltip();
  957. }
  958. Gfx::IntRect Widget::children_clip_rect() const
  959. {
  960. return rect();
  961. }
  962. void Widget::set_override_cursor(AK::Variant<Gfx::StandardCursor, NonnullRefPtr<Gfx::Bitmap>> cursor)
  963. {
  964. auto const& are_cursors_the_same = [](AK::Variant<Gfx::StandardCursor, NonnullRefPtr<Gfx::Bitmap>> const& a, AK::Variant<Gfx::StandardCursor, NonnullRefPtr<Gfx::Bitmap>> const& b) {
  965. if (a.has<Gfx::StandardCursor>() != b.has<Gfx::StandardCursor>())
  966. return false;
  967. if (a.has<Gfx::StandardCursor>())
  968. return a.get<Gfx::StandardCursor>() == b.get<Gfx::StandardCursor>();
  969. return a.get<NonnullRefPtr<Gfx::Bitmap>>().ptr() == b.get<NonnullRefPtr<Gfx::Bitmap>>().ptr();
  970. };
  971. if (are_cursors_the_same(m_override_cursor, cursor))
  972. return;
  973. m_override_cursor = move(cursor);
  974. if (auto* window = this->window()) {
  975. window->update_cursor({});
  976. }
  977. }
  978. bool Widget::load_from_gml(StringView gml_string)
  979. {
  980. return load_from_gml(gml_string, [](String const& class_name) -> RefPtr<Core::Object> {
  981. dbgln("Class '{}' not registered", class_name);
  982. return nullptr;
  983. });
  984. }
  985. bool Widget::load_from_gml(StringView gml_string, RefPtr<Core::Object> (*unregistered_child_handler)(String const&))
  986. {
  987. auto value = GML::parse_gml(gml_string);
  988. if (value.is_error()) {
  989. // FIXME: We don't report the error, so at least print it.
  990. dbgln("Error while parsing GML: {}", value.error());
  991. return false;
  992. }
  993. return load_from_gml_ast(value.release_value(), unregistered_child_handler);
  994. }
  995. bool Widget::load_from_gml_ast(NonnullRefPtr<GUI::GML::Node> ast, RefPtr<Core::Object> (*unregistered_child_handler)(String const&))
  996. {
  997. if (is<GUI::GML::GMLFile>(ast.ptr()))
  998. return load_from_gml_ast(static_ptr_cast<GUI::GML::GMLFile>(ast)->main_class(), unregistered_child_handler);
  999. VERIFY(is<GUI::GML::Object>(ast.ptr()));
  1000. auto object = static_ptr_cast<GUI::GML::Object>(ast);
  1001. object->for_each_property([&](auto key, auto value) {
  1002. set_property(key, value);
  1003. });
  1004. auto layout = object->layout_object();
  1005. if (!layout.is_null()) {
  1006. auto class_name = layout->name();
  1007. if (class_name.is_null()) {
  1008. dbgln("Invalid layout class name");
  1009. return false;
  1010. }
  1011. auto& layout_class = *Core::ObjectClassRegistration::find("GUI::Layout");
  1012. if (auto* registration = Core::ObjectClassRegistration::find(class_name)) {
  1013. auto layout = registration->construct();
  1014. if (!layout || !registration->is_derived_from(layout_class)) {
  1015. dbgln("Invalid layout class: '{}'", class_name.to_string());
  1016. return false;
  1017. }
  1018. set_layout(static_ptr_cast<Layout>(layout).release_nonnull());
  1019. } else {
  1020. dbgln("Unknown layout class: '{}'", class_name.to_string());
  1021. return false;
  1022. }
  1023. layout->for_each_property([&](auto key, auto value) {
  1024. this->layout()->set_property(key, value);
  1025. });
  1026. }
  1027. auto& widget_class = *Core::ObjectClassRegistration::find("GUI::Widget");
  1028. bool is_tab_widget = is<TabWidget>(*this);
  1029. object->for_each_child_object_interruptible([&](auto child_data) {
  1030. auto class_name = child_data->name();
  1031. // It is very questionable if this pseudo object should exist, but it works fine like this for now.
  1032. if (class_name == "GUI::Layout::Spacer") {
  1033. if (!this->layout()) {
  1034. dbgln("Specified GUI::Layout::Spacer in GML, but the parent has no Layout.");
  1035. return IterationDecision::Break;
  1036. }
  1037. this->layout()->add_spacer();
  1038. } else {
  1039. RefPtr<Core::Object> child;
  1040. if (auto* registration = Core::ObjectClassRegistration::find(class_name)) {
  1041. child = registration->construct();
  1042. if (!child || !registration->is_derived_from(widget_class)) {
  1043. dbgln("Invalid widget class: '{}'", class_name);
  1044. return IterationDecision::Break;
  1045. }
  1046. } else {
  1047. child = unregistered_child_handler(class_name);
  1048. }
  1049. if (!child)
  1050. return IterationDecision::Break;
  1051. add_child(*child);
  1052. // This is possible as we ensure that Widget is a base class above.
  1053. static_ptr_cast<Widget>(child)->load_from_gml_ast(child_data, unregistered_child_handler);
  1054. if (is_tab_widget) {
  1055. // FIXME: We need to have the child added before loading it so that it can access us. But the TabWidget logic requires the child to not be present yet.
  1056. remove_child(*child);
  1057. reinterpret_cast<TabWidget*>(this)->add_widget(*static_ptr_cast<Widget>(child));
  1058. }
  1059. }
  1060. return IterationDecision::Continue;
  1061. });
  1062. return true;
  1063. }
  1064. bool Widget::has_focus_within() const
  1065. {
  1066. auto* window = this->window();
  1067. if (!window)
  1068. return false;
  1069. if (!window->focused_widget())
  1070. return false;
  1071. auto& effective_focus_widget = focus_proxy() ? *focus_proxy() : *this;
  1072. return window->focused_widget() == &effective_focus_widget || is_ancestor_of(*window->focused_widget());
  1073. }
  1074. void Widget::set_shrink_to_fit(bool shrink_to_fit)
  1075. {
  1076. // This function is deprecated, and soon to be removed, it is only still here to ease the transition to UIDimensions
  1077. if (shrink_to_fit)
  1078. set_preferred_size(SpecialDimension::Fit);
  1079. }
  1080. bool Widget::has_pending_drop() const
  1081. {
  1082. return Application::the()->pending_drop_widget() == this;
  1083. }
  1084. bool Widget::is_visible_for_timer_purposes() const
  1085. {
  1086. return is_visible() && Object::is_visible_for_timer_purposes();
  1087. }
  1088. }