ui.h

Go to the documentation of this file.

#ifndef _WINDOWS
#error PORTME
#endif

class NOVTABLE user_interface : public service_base {
public:
    typedef BOOL (WINAPI * HookProc_t)(HWND wnd,UINT msg,WPARAM wp,LPARAM lp,LRESULT * ret);

    virtual const char * get_name()=0;
    virtual HWND init(HookProc_t hook)=0;
    virtual void shutdown()=0;
    virtual void activate()=0;
    virtual void hide()=0;
    virtual bool is_visible() = 0;
    virtual GUID get_guid() = 0;

    virtual void override_statusbar_text(const char * p_text) = 0;
    virtual void revert_statusbar_text() = 0;

    virtual void show_now_playing() = 0;

    static bool g_find(service_ptr_t<user_interface> & p_out,const GUID & p_guid);

    FB2K_MAKE_SERVICE_INTERFACE_ENTRYPOINT(user_interface);
};

template<typename T>
class user_interface_factory : public service_factory_single_t<T> {};

class NOVTABLE ui_status_text_override : public service_base
{
public:
    virtual void override_text(const char * p_message) = 0;
    virtual void revert_text() = 0;

    FB2K_MAKE_SERVICE_INTERFACE(ui_status_text_override,service_base);
};

class NOVTABLE ui_control : public service_base {
public:
    virtual bool is_visible()=0;
    virtual void activate()=0;
    virtual void hide()=0;
    virtual HICON get_main_icon()=0;
    virtual HICON load_main_icon(unsigned width,unsigned height) = 0;

    virtual void show_preferences(const GUID & p_page) = 0;

    virtual bool override_status_text_create(service_ptr_t<ui_status_text_override> & p_out) = 0;

    FB2K_MAKE_SERVICE_INTERFACE_ENTRYPOINT(ui_control);
};

class NOVTABLE ui_drop_item_callback : public service_base {
public:
    virtual bool on_drop(interface IDataObject * pDataObject) = 0;
    virtual bool is_accepted_type(interface IDataObject * pDataObject, DWORD * p_effect)=0;

    static bool g_on_drop(interface IDataObject * pDataObject);
    static bool g_is_accepted_type(interface IDataObject * pDataObject, DWORD * p_effect);

    FB2K_MAKE_SERVICE_INTERFACE_ENTRYPOINT(ui_drop_item_callback);
};

template<class T>
class ui_drop_item_callback_factory_t : public service_factory_single_t<T> {};


class ui_selection_callback;

class NOVTABLE ui_selection_holder : public service_base {
public:
    virtual void set_selection(metadb_handle_list_cref data) = 0;
    virtual void set_playlist_selection_tracking() = 0;
    virtual void set_playlist_tracking() = 0;

    virtual void set_selection_ex(metadb_handle_list_cref data, const GUID & type) = 0;

    FB2K_MAKE_SERVICE_INTERFACE(ui_selection_holder,service_base);
};

class NOVTABLE ui_selection_manager : public service_base {
public:
    virtual void get_selection(metadb_handle_list_ref p_selection) = 0;
    virtual void register_callback(ui_selection_callback * p_callback) = 0;
    virtual void unregister_callback(ui_selection_callback * p_callback) = 0;

    virtual ui_selection_holder::ptr acquire() = 0;

    virtual GUID get_selection_type() = 0;
    
    FB2K_MAKE_SERVICE_INTERFACE_ENTRYPOINT(ui_selection_manager);
};

class NOVTABLE ui_selection_manager_v2 : public ui_selection_manager {
    FB2K_MAKE_SERVICE_INTERFACE(ui_selection_manager_v2, ui_selection_manager)
public:
    enum { flag_no_now_playing = 1 };
    virtual void get_selection(metadb_handle_list_ref out, t_uint32 flags) = 0;
    virtual GUID get_selection_type(t_uint32 flags) = 0;
    virtual void register_callback(ui_selection_callback * callback, t_uint32 flags) = 0;
};

class ui_selection_callback {
public:
    virtual void on_selection_changed(metadb_handle_list_cref p_selection) = 0;
protected:
    ui_selection_callback() {}
    ~ui_selection_callback() {}
};

class ui_selection_callback_impl_base : public ui_selection_callback {
protected:
    ui_selection_callback_impl_base(bool activate = true) : m_active() {ui_selection_callback_activate(activate);}
    ~ui_selection_callback_impl_base() {ui_selection_callback_activate(false);}

    void ui_selection_callback_activate(bool state = true) {
        if (state != m_active) {
            m_active = state;
            static_api_ptr_t<ui_selection_manager> api;
            if (state) api->register_callback(this);
            else api->unregister_callback(this);
        }
    }

    //avoid pure virtual function calls in rare cases - provide a dummy implementation
    void on_selection_changed(metadb_handle_list_cref p_selection) {}

    PFC_CLASS_NOT_COPYABLE_EX(ui_selection_callback_impl_base);
private:
    bool m_active;
};

template<unsigned flags>
class ui_selection_callback_impl_base_ex : public ui_selection_callback {
protected:
    enum {
        ui_selection_flags = flags
    };
    ui_selection_callback_impl_base_ex(bool activate = true) : m_active() {ui_selection_callback_activate(activate);}
    ~ui_selection_callback_impl_base_ex() {ui_selection_callback_activate(false);}

    void ui_selection_callback_activate(bool state = true) {
        if (state != m_active) {
            m_active = state;
            static_api_ptr_t<ui_selection_manager_v2> api;
            if (state) api->register_callback(this, flags);
            else api->unregister_callback(this);
        }
    }

    //avoid pure virtual function calls in rare cases - provide a dummy implementation
    void on_selection_changed(metadb_handle_list_cref p_selection) {}

    PFC_CLASS_NOT_COPYABLE(ui_selection_callback_impl_base_ex, ui_selection_callback_impl_base_ex<flags>);
private:
    bool m_active;
};