Mercurial > foo_out_sdl
view foosdk/sdk/foobar2000/SDK/contextmenu.h @ 1:20d02a178406 default tip
*: check in everything else
yay
| author | Paper <paper@tflc.us> |
|---|---|
| date | Mon, 05 Jan 2026 02:15:46 -0500 |
| parents | |
| children |
line wrap: on
line source
#pragma once #include "metadb_handle.h" #include <functional> //! Reserved for future use. typedef void * t_glyph; class NOVTABLE contextmenu_item_node { public: enum t_flags { FLAG_CHECKED = 1, FLAG_DISABLED = 2, FLAG_GRAYED = 4, FLAG_DISABLED_GRAYED = FLAG_DISABLED|FLAG_GRAYED, FLAG_RADIOCHECKED = 8, //new in 0.9.5.2 - overrides FLAG_CHECKED, set together with FLAG_CHECKED for backwards compatibility. }; enum t_type { type_group, type_command, type_separator, //for compatibility TYPE_POPUP = type_group,TYPE_COMMAND = type_command,TYPE_SEPARATOR = type_separator, }; virtual bool get_display_data(pfc::string_base & p_out,unsigned & p_displayflags,metadb_handle_list_cref p_data,const GUID & p_caller) = 0; virtual t_type get_type() = 0; virtual void execute(metadb_handle_list_cref p_data,const GUID & p_caller) = 0; virtual t_glyph get_glyph(metadb_handle_list_cref p_data, const GUID& p_caller) { (void)p_data; (void)p_caller; return 0; }//RESERVED virtual t_size get_children_count() = 0; virtual contextmenu_item_node * get_child(t_size p_index) = 0; virtual bool get_description(pfc::string_base & p_out) = 0; virtual GUID get_guid() = 0; virtual bool is_mappable_shortcut() = 0; protected: contextmenu_item_node() {} ~contextmenu_item_node() {} }; class NOVTABLE contextmenu_item_node_root : public contextmenu_item_node { public: virtual ~contextmenu_item_node_root() {} }; class NOVTABLE contextmenu_item_node_leaf : public contextmenu_item_node { public: t_type get_type() {return TYPE_COMMAND;} t_size get_children_count() {return 0;} contextmenu_item_node * get_child(t_size) {return NULL;} }; class NOVTABLE contextmenu_item_node_root_leaf : public contextmenu_item_node_root { public: t_type get_type() {return TYPE_COMMAND;} t_size get_children_count() {return 0;} contextmenu_item_node * get_child(t_size) {return NULL;} }; class NOVTABLE contextmenu_item_node_popup : public contextmenu_item_node { public: t_type get_type() override {return TYPE_POPUP;} void execute(metadb_handle_list_cref data, const GUID& caller) override { (void)data; (void)caller; } bool get_description(pfc::string_base& p_out) override { (void)p_out; return false; } }; class NOVTABLE contextmenu_item_node_root_popup : public contextmenu_item_node_root { public: t_type get_type() override {return TYPE_POPUP;} void execute(metadb_handle_list_cref data, const GUID& caller) override { (void)data; (void)caller; } bool get_description(pfc::string_base& p_out) override { (void)p_out; return false; } }; class contextmenu_item_node_separator : public contextmenu_item_node { public: t_type get_type() override {return TYPE_SEPARATOR;} void execute(metadb_handle_list_cref data, const GUID& caller) override { (void)data; (void)caller; } bool get_description(pfc::string_base& p_out) override { (void)p_out; return false; } t_size get_children_count() override {return 0;} bool get_display_data(pfc::string_base & p_out,unsigned & p_displayflags,metadb_handle_list_cref p_data,const GUID & p_caller) override { (void)p_data; (void)p_caller; p_displayflags = 0; p_out = "---"; return true; } contextmenu_item_node * get_child(t_size) override {return NULL;} GUID get_guid() override {return pfc::guid_null;} bool is_mappable_shortcut() override {return false;} }; /*! Service class for declaring context menu commands.\n See contextmenu_item_simple for implementation helper without dynamic menu generation features.\n All methods are valid from main app thread only. */ class NOVTABLE contextmenu_item : public service_base { public: enum t_enabled_state { FORCE_OFF, DEFAULT_OFF, DEFAULT_ON, }; //! Retrieves number of menu items provided by this contextmenu_item implementation. virtual unsigned get_num_items() = 0; //! Instantiates a context menu item (including sub-node tree for items that contain dynamically-generated sub-items). virtual contextmenu_item_node_root * instantiate_item(unsigned p_index,metadb_handle_list_cref p_data,const GUID & p_caller) = 0; //! Retrieves GUID of the context menu item. virtual GUID get_item_guid(unsigned p_index) = 0; //! Retrieves human-readable name of the context menu item. virtual void get_item_name(unsigned p_index,pfc::string_base & p_out) = 0; //! Obsolete since v1.0, don't use or override in new components. virtual void get_item_default_path(unsigned p_index, pfc::string_base& p_out) { (void)p_index; p_out = ""; } //! Retrieves item's description to show in the status bar. Set p_out to the string to be displayed and return true if you provide a description, return false otherwise. virtual bool get_item_description(unsigned p_index,pfc::string_base & p_out) = 0; //! Controls default state of context menu preferences for this item: \n //! Return DEFAULT_ON to show this item in the context menu by default - useful for most cases. \n //! Return DEFAULT_OFF to hide this item in the context menu by default - useful for rarely used utility commands. \n //! Return FORCE_OFF to hide this item by default and prevent the user from making it visible (very rarely used). \n //! foobar2000 v1.6 and newer: FORCE_OFF items are meant for being shown only in the keyboard shortcut list, not anywhere else. \n //! Values returned by this method should be constant for this context menu item and not change later. Do not use this to conditionally hide the item - return false from get_display_data() instead. virtual t_enabled_state get_enabled_state(unsigned p_index) = 0; //! Executes the menu item command without going thru the instantiate_item path. For items with dynamically-generated sub-items, p_node is identifies of the sub-item command to execute. virtual void item_execute_simple(unsigned p_index,const GUID & p_node,metadb_handle_list_cref p_data,const GUID & p_caller) = 0; bool item_get_display_data_root(pfc::string_base & p_out,unsigned & displayflags,unsigned p_index,metadb_handle_list_cref p_data,const GUID & p_caller); bool item_get_display_data(pfc::string_base & p_out,unsigned & displayflags,unsigned p_index,const GUID & p_node,metadb_handle_list_cref p_data,const GUID & p_caller); GUID get_parent_fallback(); GUID get_parent_(); //! Deprecated - use caller_active_playlist_selection instead. static const GUID caller_playlist; static const GUID caller_active_playlist_selection, caller_active_playlist, caller_playlist_manager, caller_now_playing, caller_keyboard_shortcut_list, caller_media_library_viewer; static const GUID caller_undefined; FB2K_MAKE_SERVICE_INTERFACE_ENTRYPOINT(contextmenu_item); }; //! \since 1.0 class NOVTABLE contextmenu_item_v2 : public contextmenu_item { FB2K_MAKE_SERVICE_INTERFACE(contextmenu_item_v2, contextmenu_item) public: virtual double get_sort_priority() {return 0;} virtual GUID get_parent() {return get_parent_fallback();} }; //! contextmenu_item implementation helper for implementing non-dynamically-generated context menu items; derive from this instead of from contextmenu_item directly if your menu items are static. class NOVTABLE contextmenu_item_simple : public contextmenu_item_v2 { private: public: //! Same as contextmenu_item_node::t_flags. enum t_flags { FLAG_CHECKED = 1, FLAG_DISABLED = 2, FLAG_GRAYED = 4, FLAG_DISABLED_GRAYED = FLAG_DISABLED|FLAG_GRAYED, FLAG_RADIOCHECKED = 8, //new in 0.9.5.2 - overrides FLAG_CHECKED, set together with FLAG_CHECKED for backwards compatibility. }; // Functions to be overridden by implementers (some are not mandatory). virtual t_enabled_state get_enabled_state(unsigned p_index) { (void)p_index; return contextmenu_item::DEFAULT_ON; } virtual unsigned get_num_items() = 0; virtual void get_item_name(unsigned p_index,pfc::string_base & p_out) = 0; virtual void context_command(unsigned p_index,metadb_handle_list_cref p_data,const GUID& p_caller) = 0; virtual bool context_get_display(unsigned p_index,metadb_handle_list_cref p_data,pfc::string_base & p_out,unsigned & p_displayflags,const GUID & p_caller) { (void)p_caller; (void)p_data; (void)p_displayflags; PFC_ASSERT(p_index>=0 && p_index<get_num_items()); get_item_name(p_index,p_out); return true; } virtual GUID get_item_guid(unsigned p_index) = 0; virtual bool get_item_description(unsigned p_index,pfc::string_base & p_out) = 0; private: class contextmenu_item_node_impl : public contextmenu_item_node_root_leaf { public: contextmenu_item_node_impl(contextmenu_item_simple * p_owner,unsigned p_index) : m_owner(p_owner), m_index(p_index) {} bool get_display_data(pfc::string_base & p_out,unsigned & p_displayflags,metadb_handle_list_cref p_data,const GUID & p_caller) {return m_owner->get_display_data(m_index,p_data,p_out,p_displayflags,p_caller);} void execute(metadb_handle_list_cref p_data,const GUID & p_caller) {m_owner->context_command(m_index,p_data,p_caller);} bool get_description(pfc::string_base & p_out) {return m_owner->get_item_description(m_index,p_out);} GUID get_guid() {return pfc::guid_null;} bool is_mappable_shortcut() {return m_owner->item_is_mappable_shortcut(m_index);} private: service_ptr_t<contextmenu_item_simple> m_owner; unsigned m_index; }; contextmenu_item_node_root * instantiate_item(unsigned p_index,metadb_handle_list_cref p_data,const GUID & p_caller) { (void)p_data; (void)p_caller; return new contextmenu_item_node_impl(this,p_index); } void item_execute_simple(unsigned p_index,const GUID & p_node,metadb_handle_list_cref p_data,const GUID & p_caller) { if (p_node == pfc::guid_null) context_command(p_index,p_data,p_caller); } virtual bool item_is_mappable_shortcut(unsigned p_index) { (void)p_index; return true; } virtual bool get_display_data(unsigned n,metadb_handle_list_cref data,pfc::string_base & p_out,unsigned & displayflags,const GUID & caller) { bool rv = false; assert(n>=0 && n<get_num_items()); if (data.get_count()>0) { rv = context_get_display(n,data,p_out,displayflags,caller); } return rv; } }; //! Helper. template<typename T> class contextmenu_item_factory_t : public service_factory_single_t<T> {}; //! Helper. #define DECLARE_CONTEXT_MENU_ITEM(P_CLASSNAME,P_NAME,P_DEFAULTPATH,P_FUNC,P_GUID,P_DESCRIPTION) \ namespace { \ class P_CLASSNAME : public contextmenu_item_simple { \ public: \ unsigned get_num_items() {return 1;} \ void get_item_name(unsigned p_index,pfc::string_base & p_out) {p_out = P_NAME;} \ void get_item_default_path(unsigned p_index,pfc::string_base & p_out) {p_out = P_DEFAULTPATH;} \ void context_command(unsigned p_index,metadb_handle_list_cref p_data,const GUID& p_caller) {P_FUNC(p_data);} \ GUID get_item_guid(unsigned p_index) {return P_GUID;} \ bool get_item_description(unsigned p_index,pfc::string_base & p_out) {if (P_DESCRIPTION[0] == 0) return false;p_out = P_DESCRIPTION; return true;} \ }; \ static contextmenu_item_factory_t<P_CLASSNAME> g_##P_CLASSNAME##_factory; \ } //! New in 0.9.5.1. Static methods safe to use in prior versions as it will use slow fallback mode when the service isn't present. \n //! Functionality provided by menu_item_resolver methods isn't much different from just walking all registered contextmenu_item / mainmenu_commands implementations to find the command we want, but it uses a hint map to locate the service we're looking for without walking all of them which may be significantly faster in certain scenarios. class menu_item_resolver : public service_base { FB2K_MAKE_SERVICE_COREAPI(menu_item_resolver) public: virtual bool resolve_context_command(const GUID & id, service_ptr_t<class contextmenu_item> & out, t_uint32 & out_index) = 0; virtual bool resolve_main_command(const GUID & id, service_ptr_t<class mainmenu_commands> & out, t_uint32 & out_index) = 0; static bool g_resolve_context_command(const GUID & id, service_ptr_t<class contextmenu_item> & out, t_uint32 & out_index); static bool g_resolve_main_command(const GUID & id, service_ptr_t<class mainmenu_commands> & out, t_uint32 & out_index); }; //! \since 1.0 class NOVTABLE contextmenu_group : public service_base { FB2K_MAKE_SERVICE_INTERFACE_ENTRYPOINT(contextmenu_group); public: virtual GUID get_guid() = 0; virtual GUID get_parent() = 0; virtual double get_sort_priority() = 0; }; //! \since 1.0 class NOVTABLE contextmenu_group_popup : public contextmenu_group { FB2K_MAKE_SERVICE_INTERFACE(contextmenu_group_popup, contextmenu_group) public: virtual void get_display_string(pfc::string_base & out) = 0; void get_name(pfc::string_base & out) {get_display_string(out);} }; class contextmenu_groups { public: static const GUID root, utilities, tagging, tagging_pictures, replaygain, fileoperations, playbackstatistics, properties, convert, legacy; }; class contextmenu_group_impl : public contextmenu_group { public: contextmenu_group_impl(const GUID & guid, const GUID & parent, double sortPriority = 0) : m_guid(guid), m_parent(parent), m_sortPriority(sortPriority) {} GUID get_guid() {return m_guid;} GUID get_parent() {return m_parent;} double get_sort_priority() {return m_sortPriority;} private: const GUID m_guid, m_parent; const double m_sortPriority; }; class contextmenu_group_popup_impl : public contextmenu_group_popup { public: contextmenu_group_popup_impl(const GUID & guid, const GUID & parent, const char * name, double sortPriority = 0) : m_guid(guid), m_parent(parent), m_sortPriority(sortPriority), m_name(name) {} GUID get_guid() {return m_guid;} GUID get_parent() {return m_parent;} double get_sort_priority() {return m_sortPriority;} void get_display_string(pfc::string_base & out) {out = m_name;} private: const GUID m_guid, m_parent; const double m_sortPriority; const char * const m_name; }; namespace contextmenu_priorities { enum { root_queue = -100, root_main = -50, root_tagging, root_fileoperations, root_convert, root_utilities, root_replaygain, root_playbackstatistics, root_legacy = 99, root_properties = 100, tagging_pictures = 100, }; }; class contextmenu_group_factory : public service_factory_single_t<contextmenu_group_impl> { public: contextmenu_group_factory(const GUID & guid, const GUID & parent, double sortPriority = 0) : service_factory_single_t<contextmenu_group_impl>(guid, parent, sortPriority) {} }; class contextmenu_group_popup_factory : public service_factory_single_t<contextmenu_group_popup_impl> { public: contextmenu_group_popup_factory(const GUID & guid, const GUID & parent, const char * name, double sortPriority = 0) : service_factory_single_t<contextmenu_group_popup_impl>(guid, parent, name, sortPriority) {} }; class contextmenu_item_lambda : public contextmenu_item_simple { public: typedef std::function<void(metadb_handle_list_cref)> func_t; contextmenu_item_lambda(func_t f, const char* n, const GUID& g, const GUID& pg, const char* d = nullptr, double sp = 0) : m_func(f), m_name(n), m_guid(g), m_parentGuid(pg), m_desc(d), m_sortPriority(sp) {} unsigned get_num_items() override { return 1; } void get_item_name(unsigned p_index, pfc::string_base& p_out) override { (void)p_index; p_out = m_name; } void context_command(unsigned p_index, metadb_handle_list_cref p_data, const GUID& p_caller) override { (void)p_index; (void)p_caller; m_func(p_data); } GUID get_item_guid(unsigned p_index) override { (void)p_index; return m_guid; } bool get_item_description(unsigned p_index, pfc::string_base& p_out) override { (void)p_index; if (m_desc == nullptr) return false; p_out = m_desc; return true; } double get_sort_priority() override { return m_sortPriority; } GUID get_parent() override { return m_parentGuid; } private: const std::function<void(metadb_handle_list_cref)> m_func; const char* const m_name; const GUID m_guid, m_parentGuid; const char* const m_desc; const double m_sortPriority; }; #define FB2K_DECLARE_CONTEXT_MENU_ITEM(func, name, guid, parent, desc, sort) FB2K_SERVICE_FACTORY_PARAMS(contextmenu_item_lambda, func, name, guid, parent, desc, sort)
