mirror of
https://github.com/LadybirdBrowser/ladybird.git
synced 2025-01-08 04:15:23 +03:00
544366ff2a
This feature allows any application to easily install an automatically updating list of recently open files in a GUI::Menu. There are three main pieces to this mechanism: - GUI::Application::set_config_domain(domain): This must be called before using the recent files feature. It informs the Application object about which config domain to find the relevant RecentFiles list under. - GUI::Menu::add_recently_open_files(callback): This inserts the list in a menu. A callback must be provided to handle actually opening the recent file in some application-specific way. - GUI::Application::set_most_recently_open_file(path): This updates the list of recently open files, both in the configuration files, and in the GUI menu.
138 lines
4.7 KiB
C++
138 lines
4.7 KiB
C++
/*
|
|
* Copyright (c) 2018-2023, Andreas Kling <kling@serenityos.org>
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <AK/DeprecatedString.h>
|
|
#include <AK/HashMap.h>
|
|
#include <AK/OwnPtr.h>
|
|
#include <AK/String.h>
|
|
#include <AK/WeakPtr.h>
|
|
#include <LibCore/EventLoop.h>
|
|
#include <LibCore/Object.h>
|
|
#include <LibGUI/Forward.h>
|
|
#include <LibGUI/Shortcut.h>
|
|
#include <LibGUI/Widget.h>
|
|
#include <LibGfx/Point.h>
|
|
#include <LibMain/Main.h>
|
|
|
|
namespace GUI {
|
|
|
|
class Application : public Core::Object {
|
|
C_OBJECT(Application);
|
|
|
|
public:
|
|
static Application* the();
|
|
|
|
~Application();
|
|
|
|
static bool in_teardown();
|
|
|
|
int exec();
|
|
void quit(int = 0);
|
|
|
|
Action* action_for_shortcut(Shortcut const&) const;
|
|
|
|
void register_global_shortcut_action(Badge<Action>, Action&);
|
|
void unregister_global_shortcut_action(Badge<Action>, Action&);
|
|
|
|
void show_tooltip(DeprecatedString, Widget const* tooltip_source_widget);
|
|
void show_tooltip_immediately(DeprecatedString, Widget const* tooltip_source_widget);
|
|
void hide_tooltip();
|
|
Widget const* tooltip_source_widget() { return m_tooltip_source_widget; };
|
|
|
|
bool quit_when_last_window_deleted() const { return m_quit_when_last_window_deleted; }
|
|
void set_quit_when_last_window_deleted(bool b) { m_quit_when_last_window_deleted = b; }
|
|
|
|
void did_create_window(Badge<Window>);
|
|
void did_delete_last_window(Badge<Window>);
|
|
|
|
DeprecatedString const& invoked_as() const { return m_invoked_as; }
|
|
Vector<DeprecatedString> const& args() const { return m_args; }
|
|
|
|
Gfx::Palette palette() const;
|
|
void set_palette(Gfx::Palette&);
|
|
|
|
void set_system_palette(Core::AnonymousBuffer&);
|
|
|
|
bool focus_debugging_enabled() const { return m_focus_debugging_enabled; }
|
|
bool hover_debugging_enabled() const { return m_hover_debugging_enabled; }
|
|
bool dnd_debugging_enabled() const { return m_dnd_debugging_enabled; }
|
|
|
|
Core::EventLoop& event_loop() { return *m_event_loop; }
|
|
|
|
Window* active_window() { return m_active_window; }
|
|
Window const* active_window() const { return m_active_window; }
|
|
|
|
void window_did_become_active(Badge<Window>, Window&);
|
|
void window_did_become_inactive(Badge<Window>, Window&);
|
|
|
|
Widget* drag_hovered_widget() { return m_drag_hovered_widget.ptr(); }
|
|
Widget const* drag_hovered_widget() const { return m_drag_hovered_widget.ptr(); }
|
|
|
|
Widget* pending_drop_widget() { return m_pending_drop_widget.ptr(); }
|
|
Widget const* pending_drop_widget() const { return m_pending_drop_widget.ptr(); }
|
|
|
|
void set_drag_hovered_widget(Badge<Window>, Widget* widget, Gfx::IntPoint position = {}, Vector<DeprecatedString> mime_types = {})
|
|
{
|
|
set_drag_hovered_widget_impl(widget, position, move(mime_types));
|
|
}
|
|
void notify_drag_cancelled(Badge<ConnectionToWindowServer>);
|
|
|
|
Function<void(Action&)> on_action_enter;
|
|
Function<void(Action&)> on_action_leave;
|
|
Function<void()> on_theme_change;
|
|
|
|
auto const& global_shortcut_actions(Badge<GUI::CommandPalette>) const { return m_global_shortcut_actions; }
|
|
|
|
static constexpr size_t max_recently_open_files() { return 4; }
|
|
|
|
void set_config_domain(String);
|
|
void update_recent_file_actions();
|
|
void set_most_recently_open_file(String path);
|
|
|
|
void register_recent_file_actions(Badge<GUI::Menu>, Vector<NonnullRefPtr<GUI::Action>>);
|
|
|
|
private:
|
|
Application(int argc, char** argv, Core::EventLoop::MakeInspectable = Core::EventLoop::MakeInspectable::No);
|
|
Application(Main::Arguments const& arguments, Core::EventLoop::MakeInspectable inspectable = Core::EventLoop::MakeInspectable::No)
|
|
: Application(arguments.argc, arguments.argv, inspectable)
|
|
{
|
|
}
|
|
|
|
virtual void event(Core::Event&) override;
|
|
|
|
void request_tooltip_show();
|
|
void tooltip_hide_timer_did_fire();
|
|
|
|
void set_drag_hovered_widget_impl(Widget*, Gfx::IntPoint = {}, Vector<DeprecatedString> = {});
|
|
void set_pending_drop_widget(Widget*);
|
|
|
|
OwnPtr<Core::EventLoop> m_event_loop;
|
|
RefPtr<Gfx::PaletteImpl> m_palette;
|
|
RefPtr<Gfx::PaletteImpl> m_system_palette;
|
|
HashMap<Shortcut, Action*> m_global_shortcut_actions;
|
|
class TooltipWindow;
|
|
RefPtr<Core::Timer> m_tooltip_show_timer;
|
|
RefPtr<Core::Timer> m_tooltip_hide_timer;
|
|
RefPtr<TooltipWindow> m_tooltip_window;
|
|
RefPtr<Widget const> m_tooltip_source_widget;
|
|
WeakPtr<Window> m_active_window;
|
|
bool m_quit_when_last_window_deleted { true };
|
|
bool m_focus_debugging_enabled { false };
|
|
bool m_hover_debugging_enabled { false };
|
|
bool m_dnd_debugging_enabled { false };
|
|
DeprecatedString m_invoked_as;
|
|
Vector<DeprecatedString> m_args;
|
|
WeakPtr<Widget> m_drag_hovered_widget;
|
|
WeakPtr<Widget> m_pending_drop_widget;
|
|
|
|
String m_config_domain;
|
|
Vector<NonnullRefPtr<GUI::Action>> m_recent_file_actions;
|
|
};
|
|
|
|
}
|