%1

") + tr("Your search did not match any documents.") + QLatin1String("

"); if (isIndexing) htmlFile += QLatin1String("

") + tr("(The reason for this might be that the documentation " "is still being indexed.)") + QLatin1String("

"); } htmlFile += QLatin1String(""); setHtml(htmlFile); } signals: void requestShowLink(const QUrl &url); private slots: void setSource(const QUrl & /* name */) {} }; class QHelpSearchResultWidgetPrivate : public QObject { Q_OBJECT private slots: void setResults(int hitsCount) { if (!searchEngine.isNull()) { #if defined(QT_CLUCENE_SUPPORT) showFirstResultPage(); updateNextButtonState(((hitsCount > 20) ? true : false)); #else resultTreeWidget->clear(); resultTreeWidget->showResultPage(searchEngine->hits(0, hitsCount)); #endif } } void showNextResultPage() { if (!searchEngine.isNull() && resultLastToShow < searchEngine->hitsCount()) { resultLastToShow += 20; resultFirstToShow += 20; resultTextBrowser->showResultPage(searchEngine->hits(resultFirstToShow, resultLastToShow), isIndexing); if (resultLastToShow >= searchEngine->hitsCount()) updateNextButtonState(false); } updateHitRange(); } void showLastResultPage() { if (!searchEngine.isNull()) { resultLastToShow = searchEngine->hitsCount(); resultFirstToShow = resultLastToShow - (resultLastToShow % 20); if (resultFirstToShow == resultLastToShow) resultFirstToShow -= 20; resultTextBrowser->showResultPage(searchEngine->hits(resultFirstToShow, resultLastToShow), isIndexing); updateNextButtonState(false); } updateHitRange(); } void showFirstResultPage() { if (!searchEngine.isNull()) { resultLastToShow = 20; resultFirstToShow = 0; resultTextBrowser->showResultPage(searchEngine->hits(resultFirstToShow, resultLastToShow), isIndexing); updatePrevButtonState(false); } updateHitRange(); } void showPreviousResultPage() { if (!searchEngine.isNull()) { int count = resultLastToShow % 20; if (count == 0 || resultLastToShow != searchEngine->hitsCount()) count = 20; resultLastToShow -= count; resultFirstToShow = resultLastToShow -20; resultTextBrowser->showResultPage(searchEngine->hits(resultFirstToShow, resultLastToShow), isIndexing); if (resultFirstToShow == 0) updatePrevButtonState(false); } updateHitRange(); } void updatePrevButtonState(bool state = true) { firstResultPage->setEnabled(state); previousResultPage->setEnabled(state); } void updateNextButtonState(bool state = true) { nextResultPage->setEnabled(state); lastResultPage->setEnabled(state); } void indexingStarted() { isIndexing = true; } void indexingFinished() { isIndexing = false; } private: QHelpSearchResultWidgetPrivate(QHelpSearchEngine *engine) : QObject() , searchEngine(engine) , isIndexing(false) { resultTreeWidget = 0; resultTextBrowser = 0; resultLastToShow = 20; resultFirstToShow = 0; firstResultPage = 0; previousResultPage = 0; hitsLabel = 0; nextResultPage = 0; lastResultPage = 0; connect(searchEngine, SIGNAL(indexingStarted()), this, SLOT(indexingStarted())); connect(searchEngine, SIGNAL(indexingFinished()), this, SLOT(indexingFinished())); } ~QHelpSearchResultWidgetPrivate() { delete searchEngine; } QToolButton* setupToolButton(const QString &iconPath) { QToolButton *button = new QToolButton(); button->setEnabled(false); button->setAutoRaise(true); button->setIcon(QIcon(iconPath)); button->setIconSize(QSize(12, 12)); button->setMaximumSize(QSize(16, 16)); return button; } void updateHitRange() { int last = 0; int first = 0; int count = 0; if (!searchEngine.isNull()) { count = searchEngine->hitsCount(); if (count > 0) { first = resultFirstToShow +1; last = resultLastToShow > count ? count : resultLastToShow; } } hitsLabel->setText(tr("%1 - %2 of %3 Hits").arg(first).arg(last).arg(count)); } private: friend class QHelpSearchResultWidget; QPointer searchEngine; QDefaultResultWidget *resultTreeWidget; QCLuceneResultWidget *resultTextBrowser; int resultLastToShow; int resultFirstToShow; bool isIndexing; QToolButton *firstResultPage; QToolButton *previousResultPage; QLabel *hitsLabel; QToolButton *nextResultPage; QToolButton *lastResultPage; }; #include "qhelpsearchresultwidget.moc" /*! \class QHelpSearchResultWidget \since 4.4 \inmodule QtHelp \brief The QHelpSearchResultWidget class provides either a tree widget or a text browser depending on the used search engine to display the hits found by the search. */ /*! \fn void QHelpSearchResultWidget::requestShowLink(const QUrl &link) This signal is emitted when a item is activated and its associated \a link should be shown. */ QHelpSearchResultWidget::QHelpSearchResultWidget(QHelpSearchEngine *engine) : QWidget(0) , d(new QHelpSearchResultWidgetPrivate(engine)) { QVBoxLayout *vLayout = new QVBoxLayout(this); vLayout->setMargin(0); vLayout->setSpacing(0); #if defined(QT_CLUCENE_SUPPORT) QHBoxLayout *hBoxLayout = new QHBoxLayout(); #ifndef Q_OS_MAC hBoxLayout->setMargin(0); hBoxLayout->setSpacing(0); #endif hBoxLayout->addWidget(d->firstResultPage = d->setupToolButton( QString::fromUtf8(":/trolltech/assistant/images/3leftarrow.png"))); hBoxLayout->addWidget(d->previousResultPage = d->setupToolButton( QString::fromUtf8(":/trolltech/assistant/images/1leftarrow.png"))); d->hitsLabel = new QLabel(tr("0 - 0 of 0 Hits"), this); d->hitsLabel->setEnabled(false); hBoxLayout->addWidget(d->hitsLabel); d->hitsLabel->setAlignment(Qt::AlignCenter); d->hitsLabel->setMinimumSize(QSize(150, d->hitsLabel->height())); hBoxLayout->addWidget(d->nextResultPage = d->setupToolButton( QString::fromUtf8(":/trolltech/assistant/images/1rightarrow.png"))); hBoxLayout->addWidget(d->lastResultPage = d->setupToolButton( QString::fromUtf8(":/trolltech/assistant/images/3rightarrow.png"))); QSpacerItem *spacer = new QSpacerItem(40, 20, QSizePolicy::Expanding, QSizePolicy::Minimum); hBoxLayout->addItem(spacer); vLayout->addLayout(hBoxLayout); d->resultTextBrowser = new QCLuceneResultWidget(this); vLayout->addWidget(d->resultTextBrowser); connect(d->resultTextBrowser, SIGNAL(requestShowLink(const QUrl&)), this, SIGNAL(requestShowLink(const QUrl&))); connect(d->nextResultPage, SIGNAL(clicked()), d, SLOT(showNextResultPage())); connect(d->lastResultPage, SIGNAL(clicked()), d, SLOT(showLastResultPage())); connect(d->firstResultPage, SIGNAL(clicked()), d, SLOT(showFirstResultPage())); connect(d->previousResultPage, SIGNAL(clicked()), d, SLOT(showPreviousResultPage())); connect(d->firstResultPage, SIGNAL(clicked()), d, SLOT(updateNextButtonState())); connect(d->previousResultPage, SIGNAL(clicked()), d, SLOT(updateNextButtonState())); connect(d->nextResultPage, SIGNAL(clicked()), d, SLOT(updatePrevButtonState())); connect(d->lastResultPage, SIGNAL(clicked()), d, SLOT(updatePrevButtonState())); #else d->resultTreeWidget = new QDefaultResultWidget(this); vLayout->addWidget(d->resultTreeWidget); connect(d->resultTreeWidget, SIGNAL(requestShowLink(const QUrl&)), this, SIGNAL(requestShowLink(const QUrl&))); #endif connect(engine, SIGNAL(searchingFinished(int)), d, SLOT(setResults(int))); } /*! Destroys the search result widget. */ QHelpSearchResultWidget::~QHelpSearchResultWidget() { delete d; } /*! Returns a reference of the URL that the item at \a point owns, or an empty URL if no item exists at that point. */ QUrl QHelpSearchResultWidget::linkAt(const QPoint &point) { QUrl url; #if defined(QT_CLUCENE_SUPPORT) if (d->resultTextBrowser) url = d->resultTextBrowser->anchorAt(point); #else if (d->resultTreeWidget) { QTreeWidgetItem *item = d->resultTreeWidget->itemAt(point); if (item) url = item->data(1, Qt::DisplayRole).toString(); } #endif return url; } QT_END_NAMESPACE