/************************************************************************** ** ** This file is part of Qt Creator ** ** Copyright (c) 2011 Nokia Corporation and/or its subsidiary(-ies). ** ** Contact: Nokia Corporation (qt-info@nokia.com) ** ** ** GNU Lesser General Public License Usage ** ** This file may be used under the terms of the GNU Lesser General Public ** License version 2.1 as published by the Free Software Foundation and ** appearing in the file LICENSE.LGPL included in the packaging of this file. ** Please review the following information to ensure the GNU Lesser General ** Public License version 2.1 requirements will be met: ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Nokia gives you certain additional ** rights. These rights are described in the Nokia Qt LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** Other Usage ** ** Alternatively, this file may be used in accordance with the terms and ** conditions contained in a signed written agreement between you and Nokia. ** ** If you have questions regarding the use of this file, please contact ** Nokia at qt-info@nokia.com. ** **************************************************************************/ #include "searchresultwindow.h" #include "searchresultwidget.h" #include "findtoolwindow.h" #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include static const char SETTINGSKEYSECTIONNAME[] = "SearchResults"; static const char SETTINGSKEYEXPANDRESULTS[] = "ExpandResults"; namespace Find { namespace Internal { class SearchResultWindowPrivate : public QObject { Q_OBJECT public: SearchResultWindowPrivate(SearchResultWindow *window); bool isSearchVisible() const; int visibleSearchIndex() const; SearchResultWindow *q; QList m_searchResultWidgets; QToolButton *m_expandCollapseButton; QAction *m_expandCollapseAction; static const bool m_initiallyExpand = false; QWidget *m_spacer; QComboBox *m_recentSearchesBox; QStackedWidget *m_widget; QList m_searchResults; int m_currentIndex; QFont m_font; public slots: void setCurrentIndex(int index); }; SearchResultWindowPrivate::SearchResultWindowPrivate(SearchResultWindow *window) : q(window) { } bool SearchResultWindowPrivate::isSearchVisible() const { return m_currentIndex > 0; } int SearchResultWindowPrivate::visibleSearchIndex() const { return m_currentIndex - 1; } void SearchResultWindowPrivate::setCurrentIndex(int index) { if (isSearchVisible()) m_searchResultWidgets.at(visibleSearchIndex())->notifyVisibilityChanged(false); m_currentIndex = index; m_widget->setCurrentIndex(index); m_recentSearchesBox->setCurrentIndex(index); if (!isSearchVisible()) { m_widget->currentWidget()->setFocus(); m_expandCollapseButton->setEnabled(false); } else { m_searchResultWidgets.at(visibleSearchIndex())->setFocusInternally(); m_searchResultWidgets.at(visibleSearchIndex())->notifyVisibilityChanged(true); m_expandCollapseButton->setEnabled(true); } q->navigateStateChanged(); } } using namespace Find::Internal; /*! \enum Find::SearchResultWindow::SearchMode Specifies if a search should show the replace UI or not. \value SearchOnly The search doesn't support replace. \value SearchAndReplace The search supports replace, so show the UI for it. */ /*! \class Find::SearchResult \brief Reports user interaction like activation of a search result item. Whenever a new search is initiated via startNewSearch, an instance of this class is returned to provide the initiator with the hooks for handling user interaction. */ /*! \fn void SearchResult::activated(const Find::SearchResultItem &item) \brief Sent if the user activated (e.g. double-clicked) a search result \a item. */ /*! \fn void SearchResult::replaceButtonClicked(const QString &replaceText, const QList &checkedItems) \brief Sent when the user initiated a replace, e.g. by pressing the replace all button. The signal reports the text to use for replacement in \a replaceText, and the list of search result items that were selected by the user in \a checkedItems. The handler of this signal should apply the replace only on the selected items. */ /*! \class Find::SearchResultWindow \brief The SearchResultWindow class is the implementation of a commonly shared \gui{Search Results} output pane. Use it to show search results to a user. Whenever you want to show the user a list of search results, or want to present UI for a global search and replace, use the single instance of this class. Except for being an implementation of a output pane, the SearchResultWindow has a few methods and one enum that allows other plugins to show their search results and hook into the user actions for selecting an entry and performing a global replace. Whenever you start a search, call startNewSearch(SearchMode) to initialize the search result window. The parameter determines if the GUI for replacing should be shown. The method returns a SearchResult object that is your hook into the signals from user interaction for this search. When you produce search results, call addResults or addResult to add them to the search result window. After the search has finished call finishSearch to inform the search result window about it. You will get activated signals via your SearchResult instance when the user selects a search result item, and, if you started the search with the SearchAndReplace option, the replaceButtonClicked signal when the user requests a replace. */ /*! \fn QString SearchResultWindow::displayName() const \internal */ SearchResultWindow *SearchResultWindow::m_instance = 0; /*! \fn SearchResultWindow::SearchResultWindow() \internal */ SearchResultWindow::SearchResultWindow(QWidget *newSearchPanel) : d(new SearchResultWindowPrivate(this)) { m_instance = this; d->m_spacer = new QWidget; d->m_spacer->setMinimumWidth(30); d->m_recentSearchesBox = new QComboBox; d->m_recentSearchesBox->setSizeAdjustPolicy(QComboBox::AdjustToContents); d->m_recentSearchesBox->addItem(tr("New Search")); connect(d->m_recentSearchesBox, SIGNAL(activated(int)), d, SLOT(setCurrentIndex(int))); d->m_widget = new QStackedWidget; d->m_widget->setWindowTitle(displayName()); QScrollArea *newSearchArea = new QScrollArea(d->m_widget); newSearchArea->setFrameStyle(QFrame::NoFrame); newSearchArea->setWidget(newSearchPanel); newSearchArea->setFocusProxy(newSearchPanel); d->m_widget->addWidget(newSearchArea); d->m_currentIndex = 0; d->m_expandCollapseButton = new QToolButton(d->m_widget); d->m_expandCollapseButton->setAutoRaise(true); d->m_expandCollapseAction = new QAction(tr("Expand All"), this); d->m_expandCollapseAction->setCheckable(true); d->m_expandCollapseAction->setIcon(QIcon(QLatin1String(":/find/images/expand.png"))); Core::Command *cmd = Core::ICore::instance()->actionManager()->registerAction( d->m_expandCollapseAction, "Find.ExpandAll", Core::Context(Core::Constants::C_GLOBAL)); cmd->setAttribute(Core::Command::CA_UpdateText); d->m_expandCollapseButton->setDefaultAction(cmd->action()); connect(d->m_expandCollapseAction, SIGNAL(toggled(bool)), this, SLOT(handleExpandCollapseToolButton(bool))); readSettings(); } /*! \fn SearchResultWindow::~SearchResultWindow() \internal */ SearchResultWindow::~SearchResultWindow() { writeSettings(); qDeleteAll(d->m_searchResults); delete d->m_widget; d->m_widget = 0; delete d; } /*! \fn SearchResultWindow *SearchResultWindow::instance() \brief Returns the single shared instance of the Search Results window. */ SearchResultWindow *SearchResultWindow::instance() { return m_instance; } /*! \fn void SearchResultWindow::visibilityChanged(bool) \internal */ void SearchResultWindow::visibilityChanged(bool visible) { if (d->isSearchVisible()) d->m_searchResultWidgets.at(d->visibleSearchIndex())->notifyVisibilityChanged(visible); } /*! \fn QWidget *SearchResultWindow::outputWidget(QWidget *) \internal */ QWidget *SearchResultWindow::outputWidget(QWidget *) { return d->m_widget; } /*! \fn QList SearchResultWindow::toolBarWidgets() const \internal */ QList SearchResultWindow::toolBarWidgets() const { return QList() << d->m_expandCollapseButton << d->m_spacer << d->m_recentSearchesBox; } /*! \brief Tells the search results window to start a new search. The \a label should be a string that shortly describes the type of search, i.e. search filter and possibly a most relevant search option, followed by a colon ':'. E.g. \code{Project 'myproject':} The \a searchTerm will be shown behind the colon. The \a toolTip should elaborate on the search parameters, like file patterns that are searched and find flags. If \a cfgGroup is not empty, it will be used for storing the "do not ask again" setting of a "this change cannot be undone" warning (which is implicitly requested by passing a non-empty group). Returns a SearchResult object that is used for signaling user interaction with the results of this search. The search result window owns the returned SearchResult and might delete it any time, even while the search is running (e.g. when the user clears the search result pane, or if the user opens so many other searches that this search falls out of the history). */ SearchResult *SearchResultWindow::startNewSearch(const QString &label, const QString &toolTip, const QString &searchTerm, SearchMode searchOrSearchAndReplace, const QString &cfgGroup) { if (d->m_searchResults.size() >= 5) { d->m_searchResultWidgets.last()->notifyVisibilityChanged(false); delete d->m_searchResults.takeLast(); delete d->m_searchResultWidgets.takeLast(); d->m_recentSearchesBox->removeItem(d->m_recentSearchesBox->count()-1); if (d->m_currentIndex >= d->m_recentSearchesBox->count()) { // temporarily set the index to the last existing d->m_currentIndex = d->m_recentSearchesBox->count() - 1; } } Internal::SearchResultWidget *widget = new Internal::SearchResultWidget; d->m_searchResultWidgets.prepend(widget); d->m_widget->insertWidget(1, widget); connect(widget, SIGNAL(navigateStateChanged()), this, SLOT(navigateStateChanged())); widget->setTextEditorFont(d->m_font); widget->setShowReplaceUI(searchOrSearchAndReplace != SearchOnly); widget->setAutoExpandResults(d->m_expandCollapseAction->isChecked()); widget->setInfo(label, toolTip, searchTerm); if (searchOrSearchAndReplace == SearchAndReplace) widget->setDontAskAgainGroup(cfgGroup); SearchResult *result = new SearchResult(widget); d->m_searchResults.prepend(result); d->m_recentSearchesBox->insertItem(1, tr("%1 %2").arg(label, searchTerm)); if (d->m_currentIndex > 0) ++d->m_currentIndex; // so setCurrentIndex still knows about the right "currentIndex" and its widget d->setCurrentIndex(1); return result; } /*! \fn void SearchResultWindow::clearContents() \brief Clears the current contents in the search result window. */ void SearchResultWindow::clearContents() { for (int i = d->m_recentSearchesBox->count() - 1; i > 0 /* don't want i==0 */; --i) d->m_recentSearchesBox->removeItem(i); foreach (Internal::SearchResultWidget *widget, d->m_searchResultWidgets) widget->notifyVisibilityChanged(false); qDeleteAll(d->m_searchResultWidgets); d->m_searchResultWidgets.clear(); qDeleteAll(d->m_searchResults); d->m_searchResults.clear(); d->m_currentIndex = 0; d->m_widget->currentWidget()->setFocus(); d->m_expandCollapseButton->setEnabled(false); navigateStateChanged(); } /*! \fn bool SearchResultWindow::hasFocus() \internal */ bool SearchResultWindow::hasFocus() const { return d->m_widget->focusWidget() && d->m_widget->focusWidget()->hasFocus(); } /*! \fn bool SearchResultWindow::canFocus() \internal */ bool SearchResultWindow::canFocus() const { if (d->isSearchVisible()) return d->m_searchResultWidgets.at(d->visibleSearchIndex())->canFocusInternally(); return true; } /*! \fn void SearchResultWindow::setFocus() \internal */ void SearchResultWindow::setFocus() { if (!d->isSearchVisible()) d->m_widget->currentWidget()->setFocus(); else d->m_searchResultWidgets.at(d->visibleSearchIndex())->setFocusInternally(); } /*! \fn void SearchResultWindow::setTextEditorFont(const QFont &font) \internal */ void SearchResultWindow::setTextEditorFont(const QFont &font) { d->m_font = font; foreach (Internal::SearchResultWidget *widget, d->m_searchResultWidgets) widget->setTextEditorFont(font); } void SearchResultWindow::openNewSearchPanel() { d->setCurrentIndex(0); popup(true/*focus*/, true/*sizeHint*/); } /*! \fn void SearchResultWindow::handleExpandCollapseToolButton(bool checked) \internal */ void SearchResultWindow::handleExpandCollapseToolButton(bool checked) { if (!d->isSearchVisible()) return; d->m_searchResultWidgets.at(d->visibleSearchIndex())->setAutoExpandResults(checked); if (checked) { d->m_expandCollapseAction->setText(tr("Collapse All")); d->m_searchResultWidgets.at(d->visibleSearchIndex())->expandAll(); } else { d->m_expandCollapseAction->setText(tr("Expand All")); d->m_searchResultWidgets.at(d->visibleSearchIndex())->collapseAll(); } } /*! \fn void SearchResultWindow::readSettings() \internal */ void SearchResultWindow::readSettings() { QSettings *s = Core::ICore::instance()->settings(); if (s) { s->beginGroup(QLatin1String(SETTINGSKEYSECTIONNAME)); d->m_expandCollapseAction->setChecked(s->value(QLatin1String(SETTINGSKEYEXPANDRESULTS), d->m_initiallyExpand).toBool()); s->endGroup(); } } /*! \fn void SearchResultWindow::writeSettings() \internal */ void SearchResultWindow::writeSettings() { QSettings *s = Core::ICore::instance()->settings(); if (s) { s->beginGroup(QLatin1String(SETTINGSKEYSECTIONNAME)); s->setValue(QLatin1String(SETTINGSKEYEXPANDRESULTS), d->m_expandCollapseAction->isChecked()); s->endGroup(); } } /*! \fn int SearchResultWindow::priorityInStatusBar() const \internal */ int SearchResultWindow::priorityInStatusBar() const { return 80; } /*! \fn bool SearchResultWindow::canNext() \internal */ bool SearchResultWindow::canNext() const { if (d->isSearchVisible()) return d->m_searchResultWidgets.at(d->visibleSearchIndex())->count() > 0; return false; } /*! \fn bool SearchResultWindow::canPrevious() \internal */ bool SearchResultWindow::canPrevious() const { return canNext(); } /*! \fn void SearchResultWindow::goToNext() \internal */ void SearchResultWindow::goToNext() { int index = d->m_widget->currentIndex(); if (index != 0) d->m_searchResultWidgets.at(index-1)->goToNext(); } /*! \fn void SearchResultWindow::goToPrev() \internal */ void SearchResultWindow::goToPrev() { int index = d->m_widget->currentIndex(); if (index != 0) d->m_searchResultWidgets.at(index-1)->goToPrevious(); } /*! \fn bool SearchResultWindow::canNavigate() \internal */ bool SearchResultWindow::canNavigate() const { return true; } /*! \fn SearchResult::SearchResult(SearchResultWidget *widget) \internal */ SearchResult::SearchResult(SearchResultWidget *widget) : m_widget(widget) { connect(widget, SIGNAL(activated(Find::SearchResultItem)), this, SIGNAL(activated(Find::SearchResultItem))); connect(widget, SIGNAL(replaceButtonClicked(QString,QList)), this, SIGNAL(replaceButtonClicked(QString,QList))); connect(widget, SIGNAL(cancelled()), this, SIGNAL(cancelled())); connect(widget, SIGNAL(visibilityChanged(bool)), this, SIGNAL(visibilityChanged(bool))); } /*! \fn void SearchResult::setUserData(const QVariant &data) \brief Attach some random \a data to this search, that you can use later. \sa userData() */ void SearchResult::setUserData(const QVariant &data) { m_userData = data; } /*! \fn void SearchResult::userData() \brief Return the data that was attached to this search by calling setUserData(). \sa setUserData() */ QVariant SearchResult::userData() const { return m_userData; } /*! \fn QString SearchResult::textToReplace() const \brief Returns the text that should replace the text in search results. */ QString SearchResult::textToReplace() const { return m_widget->textToReplace(); } /*! \fn void SearchResult::addResult(const QString &fileName, int lineNumber, const QString &rowText, int searchTermStart, int searchTermLength, const QVariant &userData) \brief Adds a single result line to the search results. The \a fileName, \a lineNumber and \a rowText are shown in the result line. \a searchTermStart and \a searchTermLength specify the region that should be visually marked (string position and length in \a rowText). You can attach arbitrary \a userData to the search result, which can be used e.g. when reacting to the signals of the SearchResult for your search. \sa addResults() */ void SearchResult::addResult(const QString &fileName, int lineNumber, const QString &lineText, int searchTermStart, int searchTermLength, const QVariant &userData) { m_widget->addResult(fileName, lineNumber, lineText, searchTermStart, searchTermLength, userData); } /*! \fn void SearchResult::addResults(const QList &items, SearchResult::AddMode mode) \brief Adds all of the given search result \a items to the search results window. \sa addResult() */ void SearchResult::addResults(const QList &items, AddMode mode) { m_widget->addResults(items, mode); } /*! \fn void SearchResult::finishSearch() \brief Notifies the search result window that the current search has finished, and the UI should reflect that. */ void SearchResult::finishSearch() { m_widget->finishSearch(); } /*! \fn void SearchResult::setTextToReplace(const QString &textToReplace) \brief Sets the value in the UI element that allows the user to type the text that should replace text in search results to \a textToReplace. */ void SearchResult::setTextToReplace(const QString &textToReplace) { m_widget->setTextToReplace(textToReplace); } } // namespace Find #include "searchresultwindow.moc"