ScopeInterface.h

/*
 * Copyright (C) 2014 Canonical, Ltd.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; version 3.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 
#ifndef UNITY_SHELL_SCOPES_SCOPEINTERFACE_H
#define UNITY_SHELL_SCOPES_SCOPEINTERFACE_H
 
#include <unity/SymbolExport.h>
 
#include <QObject>
#include <QVariantMap>
 
namespace unity
{
namespace shell
{
namespace scopes
{
 
class CategoriesInterface;
class PreviewModelInterface;
class NavigationInterface;
class SettingsModelInterface;
class FiltersInterface;
class FilterBaseInterface;

class UNITY_API ScopeInterface : public QObject
{
    Q_OBJECT

    Q_PROPERTY(QString id READ id NOTIFY idChanged)
 
    
    Q_PROPERTY(QString name READ name NOTIFY nameChanged)

    Q_PROPERTY(QString iconHint READ iconHint NOTIFY iconHintChanged)

    Q_PROPERTY(QString description READ description NOTIFY descriptionChanged)

    Q_PROPERTY(QString searchHint READ searchHint NOTIFY searchHintChanged)

    Q_PROPERTY(bool searchInProgress READ searchInProgress NOTIFY searchInProgressChanged)

    Q_PROPERTY(bool activationInProgress READ activationInProgress NOTIFY activationInProgressChanged)

    Q_PROPERTY(bool favorite READ favorite WRITE setFavorite NOTIFY favoriteChanged)
    Q_PROPERTY(QString shortcut READ shortcut NOTIFY shortcutChanged)

    Q_PROPERTY(unity::shell::scopes::CategoriesInterface* categories READ categories NOTIFY categoriesChanged)

    Q_PROPERTY(unity::shell::scopes::SettingsModelInterface* settings READ settings NOTIFY settingsChanged)

    Q_PROPERTY(unity::shell::scopes::FilterBaseInterface* primaryNavigationFilter READ primaryNavigationFilter NOTIFY primaryNavigationFilterChanged)

    Q_PROPERTY(QString searchQuery READ searchQuery WRITE setSearchQuery NOTIFY searchQueryChanged)

    Q_PROPERTY(QString noResultsHint READ noResultsHint WRITE setNoResultsHint NOTIFY noResultsHintChanged)

    Q_PROPERTY(QString formFactor READ formFactor WRITE setFormFactor NOTIFY formFactorChanged)

    Q_PROPERTY(bool isActive READ isActive WRITE setActive NOTIFY isActiveChanged)

    Q_PROPERTY(QString currentNavigationId READ currentNavigationId NOTIFY currentNavigationIdChanged)

    Q_PROPERTY(bool hasNavigation READ hasNavigation NOTIFY hasNavigationChanged)

    Q_PROPERTY(QVariantMap customizations READ customizations NOTIFY customizationsChanged)

    Q_PROPERTY(unity::shell::scopes::ScopeInterface::Status status READ status NOTIFY statusChanged)

    Q_PROPERTY(unity::shell::scopes::FiltersInterface* filters READ filters NOTIFY filtersChanged)

    Q_PROPERTY(QString primaryNavigationTag READ primaryNavigationTag NOTIFY primaryNavigationTagChanged)

    Q_PROPERTY(int activeFiltersCount READ activeFiltersCount NOTIFY activeFiltersCountChanged)
 
protected:
    explicit ScopeInterface(QObject* parent = 0) : QObject(parent) { }
 
public:
    enum class Status
    {
        Okay,                           // Everything is fine
        NoInternet,                     // No Internet access
        NoLocationData,                 // No location data available
        Unknown,                        // A code unknown to the run-time was used
    };
    Q_ENUM(Status)
 
    // @cond
    virtual QString id() const = 0;
    virtual QString name() const = 0;
    virtual QString iconHint() const = 0;
    virtual QString description() const = 0;
    virtual QString searchHint() const = 0;
    virtual QString shortcut() const = 0;
    virtual bool searchInProgress() const = 0;
    virtual bool activationInProgress() const = 0;
    virtual bool favorite() const = 0;
    virtual CategoriesInterface* categories() const = 0;
    virtual SettingsModelInterface* settings() const = 0;
    virtual FilterBaseInterface* primaryNavigationFilter() const = 0;
    virtual QString searchQuery() const = 0;
    virtual QString noResultsHint() const = 0;
    virtual QString formFactor() const = 0;
    virtual bool isActive() const = 0;
    virtual QString currentNavigationId() const = 0;
    virtual bool hasNavigation() const = 0;
    virtual Status status() const = 0;
    virtual QVariantMap customizations() const = 0;
    virtual FiltersInterface* filters() const = 0;
    virtual QString primaryNavigationTag() const = 0;
    virtual int activeFiltersCount() const = 0;
 
    /* setters */
    virtual void setSearchQuery(const QString& search_query) = 0;
    virtual void setNoResultsHint(const QString& hint) = 0;
    virtual void setFormFactor(const QString& form_factor) = 0;
    virtual void setActive(const bool) = 0;
    virtual void setFavorite(const bool) = 0;
    // @endcond

    Q_INVOKABLE virtual void activate(QVariant const& result, QString const& categoryId) = 0;

    Q_INVOKABLE virtual unity::shell::scopes::PreviewModelInterface* preview(QVariant const& result, QString const& categoryId) = 0;

    Q_INVOKABLE virtual void cancelActivation() = 0;

    Q_INVOKABLE virtual void closeScope(unity::shell::scopes::ScopeInterface* scope) = 0;

    Q_INVOKABLE virtual unity::shell::scopes::NavigationInterface* getNavigation(QString const& navigationId) = 0;

    Q_INVOKABLE virtual void setNavigationState(QString const& navId) = 0;

    Q_INVOKABLE virtual void performQuery(QString const& cannedQuery) = 0;

    Q_INVOKABLE virtual void refresh() = 0;

    Q_INVOKABLE virtual void resetPrimaryNavigationTag() = 0;

    Q_INVOKABLE virtual void resetFilters() = 0;
 
    /*
     * @brief Method used to activate an action of a result.
     */
    Q_INVOKABLE virtual void activateAction(QVariant const& result, QString const& categoryId, QString const& actionId) = 0;
 
Q_SIGNALS:
    // @cond
    void idChanged();
    void nameChanged();
    void iconHintChanged();
    void descriptionChanged();
    void searchHintChanged();
    void searchInProgressChanged();
    void activationInProgressChanged();
    void favoriteChanged();
    void shortcutChanged();
    void categoriesChanged();
    void settingsChanged();
    void searchQueryChanged();
    void noResultsHintChanged();
    void formFactorChanged();
    void isActiveChanged();
    void hasNavigationChanged();
    void currentNavigationIdChanged();
    void customizationsChanged();
    void statusChanged();
    void detailsChanged();
    void filtersChanged();
    void primaryNavigationTagChanged();
    void activeFiltersCountChanged();
    void primaryNavigationFilterChanged();
    // @endcond
 
    // signals triggered by activate(..) or preview(..) requests.
    void showDash();

    void hideDash();

    void gotoUri(QString const& uri);

    void previewRequested(QVariant const& result);

    void gotoScope(QString const& scopeId);

    void openScope(unity::shell::scopes::ScopeInterface* scope);
};
 
}
}
}
 
Q_DECLARE_METATYPE(unity::shell::scopes::ScopeInterface*)
 
#endif