wxWidgets/include/wx/taskbarbutton.h

/////////////////////////////////////////////////////////////////////////////
// Name:        include/taskbarbutton.h
// Purpose:     Defines wxTaskBarButton class for manipulating buttons on the
//              windows taskbar.
// Author:      Chaobin Zhang <zhchbin@gmail.com>
// Created:     2014-04-30
// Copyright:   (c) 2014 wxWidgets development team
// Licence:     wxWindows licence
/////////////////////////////////////////////////////////////////////////////

#ifndef _WX_TASKBARBUTTON_H_
#define _WX_TASKBARBUTTON_H_

#if wxUSE_TASKBARBUTTON

#include "wx/defs.h"

// ----------------------------------------------------------------------------
// wxTaskBarButton: define wxTaskBarButton interface.
// ----------------------------------------------------------------------------

class WXDLLIMPEXP_FWD_CORE wxTaskBarButton;

namespace {
class WXDLLIMPEXP_FWD_CORE IObjectArray;
class WXDLLIMPEXP_FWD_CORE ICustomDestinationList;
class WXDLLIMPEXP_FWD_CORE IApplicationDocumentLists;
}


/**
    State of the task bar button.
*/
enum WXDLLIMPEXP_CORE wxTaskBarButtonState
{
    wxTASKBAR_BUTTON_NO_PROGRESS   = 0,
    wxTASKBAR_BUTTON_INDETERMINATE = 1,
    wxTASKBAR_BUTTON_NORMAL        = 2,
    wxTASKBAR_BUTTON_ERROR         = 4,
    wxTASKBAR_BUTTON_PAUSED        = 8
};

class WXDLLIMPEXP_CORE wxThumbBarButton : public wxObject {
public:
    wxThumbBarButton() : m_taskBarButtonParent(NULL) { }
    wxThumbBarButton(int id,
                     const wxIcon& icon,
                     const wxString& tooltip = wxString(),
                     bool enable = true,
                     bool dismissOnClick = false,
                     bool hasBackground = true,
                     bool shown = true,
                     bool interactive = true);

    virtual ~wxThumbBarButton() {}

    bool Create(int id,
                const wxIcon& icon,
                const wxString& tooltip = wxString(),
                bool enable = true,
                bool dismissOnClick = false,
                bool hasBackground = true,
                bool shown = true,
                bool interactive = true);
    int GetID() const { return m_id; }
    const wxIcon& GetIcon() const { return m_icon; }
    const wxString& GetTooltip() const { return m_tooltip; }

    bool IsEnable() const { return m_enable; }
    void Enable(bool enable = true);
    void Disable() { Enable(false); }

    bool IsDismissOnClick() const { return m_dismissOnClick; }
    void EnableDismissOnClick(bool enable = true);
    void DisableDimissOnClick() { EnableDismissOnClick(false); }

    bool HasBackground() const { return m_hasBackground; }
    void SetHasBackground(bool has = true);

    bool IsShown() const { return m_shown; }
    void Show(bool shown = true);
    void Hide() { Show(false); }

    bool IsInteractive() const { return m_interactive; }
    void SetInteractive(bool interactive = true);

    void SetParent(wxTaskBarButton *parent) { m_taskBarButtonParent = parent; }
    wxTaskBarButton* GetParent() const { return m_taskBarButtonParent; }

private:
    bool UpdateParentTaskBarButton();

    int m_id;
    wxIcon m_icon;
    wxString m_tooltip;
    bool m_enable;
    bool m_dismissOnClick;
    bool m_hasBackground;
    bool m_shown;
    bool m_interactive;
    wxTaskBarButton *m_taskBarButtonParent;

    DECLARE_DYNAMIC_CLASS(wxThumbBarButton)
};

class WXDLLIMPEXP_CORE wxTaskBarButton
{
public:
    wxTaskBarButton() { }
    virtual ~wxTaskBarButton() { }

    // Operations:
    virtual void SetProgressRange(int range) = 0;
    virtual void SetProgressValue(int value) = 0;
    virtual void PulseProgress() = 0;
    virtual void Show(bool show = true) = 0;
    virtual void Hide() = 0;
    virtual void SetThumbnailTooltip(const wxString& tooltip) = 0;
    virtual void SetProgressState(wxTaskBarButtonState state) = 0;
    virtual void SetOverlayIcon(const wxIcon& icon,
                                const wxString& description = wxString()) = 0;
    virtual void SetThumbnailClip(const wxRect& rect) = 0;
    virtual void SetThumbnailContents(const wxWindow *child) = 0;
    virtual bool InsertThumbBarButton(size_t pos, wxThumbBarButton *button) = 0;
    virtual bool AppendThumbBarButton(wxThumbBarButton *button) = 0;
    virtual bool AppendSeparatorInThumbBar() = 0;
    virtual wxThumbBarButton* RemoveThumbBarButton(wxThumbBarButton *button) = 0;
    virtual wxThumbBarButton* RemoveThumbBarButton(int id) = 0;

private:
    wxDECLARE_NO_COPY_CLASS(wxTaskBarButton);
};

class WXDLLIMPEXP_CORE wxAppProgressIndicator
{
public:
    wxAppProgressIndicator(wxTopLevelWindow *parent, int maxValue);
    virtual ~wxAppProgressIndicator();
    bool Update(int value);
    bool Pulse();

private:
    void Init();

    wxTopLevelWindow *m_parent;
    int m_maxValue;
    wxScopedPtr<wxTaskBarButton> m_taskBarButton;
};

enum WXDLLIMPEXP_CORE wxJumpListItemType {
    wxJUMP_LIST_SEPARATOR,
    wxJUMP_LIST_TASK,
    wxJUMP_LIST_DESTIONATION
};

class WXDLLIMPEXP_CORE wxJumpListItem
{
public:
    wxJumpListItem(wxJumpListItemType type,
                   const wxString& title = wxEmptyString,
                   const wxString& filePath = wxEmptyString,
                   const wxString& arguments = wxEmptyString,
                   const wxString& tooltip = wxEmptyString,
                   const wxString& iconPath = wxEmptyString,
                   int iconIndex = 0);

    wxJumpListItemType GetType() const;
    void SetType(wxJumpListItemType type);
    const wxString& GetTitle() const;
    void SetTitle(const wxString& title);
    const wxString& GetFilePath() const;
    void SetFilePath(const wxString& filePath);
    const wxString& GetArguments() const;
    void SetArguments(const wxString& arguments);
    const wxString& GetTooltip() const;
    void SetTooltip(const wxString& tooltip);
    const wxString& GetIconPath() const;
    void SetIconPath(const wxString& iconPath);
    int GetIconIndex() const;
    void SetIconIndex(int iconIndex);

private:
    wxJumpListItemType m_type;
    wxString m_title;
    wxString m_filePath;
    wxString m_arguments;
    wxString m_tooltip;
    wxString m_iconPath;
    int      m_iconIndex;
};

typedef wxVector<wxJumpListItem*> wxJumpListItems;

class WXDLLIMPEXP_FWD_CORE  wxJumpList;

class WXDLLIMPEXP_CORE wxJumpListCategory
{
public:
    wxJumpListCategory(const wxString& title = wxEmptyString);
    virtual ~wxJumpListCategory();

    wxJumpListItem* Append(wxJumpListItem *item);
    void Delete(wxJumpListItem *item);
    wxJumpListItem* Remove(wxJumpListItem *item);
    wxJumpListItem* FindItemByPosition (size_t pos) const;
    wxJumpListItem* Insert(size_t pos, wxJumpListItem *item);
    wxJumpListItem* Prepend(wxJumpListItem *item);
    void SetTitle(const wxString& title);
    const wxString& GetTitle() const;
    const wxJumpListItems& GetItems() const;

private:
    wxJumpListItems m_items;
    wxString m_title;
};

class WXDLLIMPEXP_CORE wxJumpList
{
public:
    wxJumpList();
    virtual ~wxJumpList();
    wxJumpListCategory* GetTasks();
    void ShowRecentCategory(bool shown = true);
    void HideRecentCategory();
    void ShowFrequentCategory(bool shown = true);
    void HideFrequentCategory();

    const wxJumpListCategory* GetFrequentCategory();
    const wxJumpListCategory* GetRecentCategory();
    const wxVector<wxJumpListCategory*>& GetCustomCategories();

    void AddCategory(wxJumpListCategory * catalog);
    wxJumpListCategory* RemoveCategory(const wxString& title);

    void Update();

private:
    bool BeginUpdate();
    bool CommitUpdate();
    void AddTasksToDestinationList();
    void LoadKnownCategory(const wxString& title);

    ICustomDestinationList    *m_destinationList;
    IObjectArray              *m_objectArray;

    wxScopedPtr<wxJumpListCategory> m_tasks;
    wxScopedPtr<wxJumpListCategory> m_frequent;
    wxScopedPtr<wxJumpListCategory> m_recent;
    wxVector<wxJumpListCategory*>   m_customCategories;
    bool m_recent_visible;
    bool m_frequent_visible;
};

#if defined(__WXMSW__)
    #include "wx/msw/taskbarbutton.h"
#endif

#endif // wxUSE_TASKBARBUTTON

#endif  // _WX_TASKBARBUTTON_H_