1 /*******************************************************************************
3 This file is part of mDictionary.
5 mDictionary is free software: you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation, either version 3 of the License, or
8 (at your option) any later version.
10 mDictionary is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with mDictionary. If not, see <http://www.gnu.org/licenses/>.
18 Copyright 2010 Comarch S.A.
20 *******************************************************************************/
21 /*! \file SearchBarWidget.h
22 \brief Displays search bar
24 \author Mateusz Półrola <mateusz.polrola@comarch.pl>
28 #ifndef SEARCHBARWIDGET_H
29 #define SEARCHBARWIDGET_H
33 #include <QDeclarativeView>
35 #include "../backbone/backbone.h"
36 #include "../../include/History.h"
39 Contains line edit field to input word which user would like to find
40 and buttons to start/stop search and browse search history.
41 Line edit and history buttons are disabled when search is ongoing,
42 only start/stop button stays active. When searching it also displays
45 class SearchBarWidget : public QWidget {
48 explicit SearchBarWidget(QWidget *parent = 0);
53 void setEnableHistoryNext(QVariant enable);
54 void setEnableHistoryShow(QVariant enable);
55 void setEnableHistoryPrev(QVariant enable);
56 void setButtonText(QVariant text);
57 void setLineEditText(QVariant text);
58 void setLineEditEnables(QVariant enabled);
60 //! Requests to search for a list of words matching a word passed as
62 void searchForTranslations(QString);
64 //! Requests to stop all active searchings
67 //! Requests to show previous translation in history
70 //! Requests to show next translation in history
73 //! Requests to show history list
75 \param p this argument is used only on desktop, it defines place on
76 which a popup with history will be shown
78 void historyShow(QPoint p = QPoint(-1,-1));
80 //! Requests to refresh state of history buttons
81 void refreshHistoryButtons();
85 void searchButtonClicked(QString text);
87 //! Enables or disables search word line edit and history buttons
89 While searching it disables only history button and line edit.
90 Search/Stop button is always enabled.
92 void setEnabled(bool);
95 //! Sets search bar in busy state
97 Displays "busy" bar and disables search word text edit and history buttons
101 //! Sets search bar in idle state
103 Hides "busy" bar and enables all widgets, refreshes state of history buttons
104 by emitting refreshHistoryButtons signal
108 //! Searches for a given word
110 Sets word as text in search word line edit
112 void search(QString word);
114 //! Starts to search for a given word after 500 ms delay
116 Sets word as text in search word line edit, and waits 500 ms to start
117 search. If in the meantime this slot is called again it will stop previous
120 void searchDelay(QString word);
122 //! Updates state of history buttons
124 \param prev if set to true, the history has some previous words
125 \param next if set to true, the history has some next words
126 \param list if set to true, the history can show word list
128 void updateHistoryButtons(bool prev, bool next, bool list);
133 //! Clears search word line edit
134 void clearSearchWordToolButtonClicked();
136 //! Starts to search for given words
137 void searchPushButtonClicked();
139 //! starts to search word which was passed to searchDelay
140 void delaySearchTimeout();
143 void showHistoryButtonClicked();
148 QVBoxLayout* mainLayout;
149 QDeclarativeView *view;
151 QLineEdit* searchWordLineEdit;
152 QCompleter* lineEditCompleter;
153 QStringListModel* completerModel;
154 QToolButton* clearSearchWordToolButton;
155 QPushButton* searchPushButton;
156 QToolButton* historyPrevToolButton;
157 QToolButton* historyNextToolButton;
158 QToolButton* historyShowToolButton;
159 QToolButton* fullScreenToolButton;
160 QHBoxLayout* horizontalLayout;
161 QProgressBar* searchingProgressBar;
164 //! generates icon for maemo (some of icons we use don't have inactive
165 //! pixmaps, so we generate them)
167 \param original original icon
168 \param rotation rotation of resulting icon
170 QIcon generateIcon(QIcon original, qreal rotation=0);
172 QVBoxLayout* verticalLayout;
182 #endif // SEARCHBARWIDGET_H