┌   ┐
54
└   ┘

summaryrefslogtreecommitdiff
path: root/src/search/dolphinsearchoptionsconfigurator.h
blob: e4f7718e266bcab65fa265388345d7cd2bd5b2ca (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
/***************************************************************************
 *   Copyright (C) 2009 by Peter Penz <[email protected]>                  *
 *                                                                         *
 *   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; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   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, write to the                         *
 *   Free Software Foundation, Inc.,                                       *
 *   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA            *
 ***************************************************************************/

#ifndef DOLPHINSEARCHOPTIONSCONFIGURATOR_H
#define DOLPHINSEARCHOPTIONSCONFIGURATOR_H

#include <kurl.h>
#define DISABLE_NEPOMUK_LEGACY
#include <nepomuk/query.h>
#include <QList>
#include <QString>
#include <QWidget>

class KComboBox;
class SearchCriterionSelector;
class QPushButton;
class QVBoxLayout;

/**
 * @brief Allows the user to configure a search query for Nepomuk.
 */
class DolphinSearchOptionsConfigurator : public QWidget
{
    Q_OBJECT

public:
    DolphinSearchOptionsConfigurator(QWidget* parent = 0);
    virtual ~DolphinSearchOptionsConfigurator();

    QString customSearchQuery() const;
    KUrl directory() const;

    /**
     * Returns the sum of the configured options and the
     * custom search query as Nepomuk conform search URL. If the
     * query is invalid, an empty URL is returned.
     * @see DolphinSearchOptionsConfigurator::setCustomSearchQuery()
     */
    KUrl nepomukSearchUrl() const;

public slots:
    /**
     * Sets a custom search query that is added to the
     * search query defined by the search options configurator.
     * This is useful if a custom search user interface is
     * offered outside the search options configurator.
     */
    void setCustomSearchQuery(const QString& searchQuery);

    /**
     * Sets the directory that is used when the
     * "From Here"-location-filter is used. URLs that represent
     * already a Nepomuk search URL will be ignored.
     */
    void setDirectory(const KUrl& dir);

signals:
    void searchOptionsChanged();

protected:
    virtual void showEvent(QShowEvent* event);

private slots:
    void slotAddSelectorButtonClicked();
    void removeCriterion();

    /**
     * Saves the current query by adding it as Places entry.
     */
    void saveQuery();

    /**
     * Enables the enabled property of the search-, save-button and the
     * add-selector button.
     */
    void updateButtons();

private:
    /**
     * Adds the new search description selector to the bottom
     * of the layout.
     */
    void addCriterion(SearchCriterionSelector* selector);

    /**
     * Returns the sum of the configured options and the
     * custom search query as Nepomuk confrom query.
     * @see DolphinSearchOptionsConfigurator::setCustomSearchQuery()
     */
    Nepomuk::Query::Query nepomukQuery() const;

private:
    bool m_initialized;
    KUrl m_directory;
    KComboBox* m_locationBox;
    KComboBox* m_whatBox;
    QPushButton* m_addSelectorButton;
    QPushButton* m_searchButton;
    QPushButton* m_saveButton;
    QVBoxLayout* m_vBoxLayout;
    QList<SearchCriterionSelector*> m_criteria;
    QString m_customSearchQuery;
};

#endif