~ubuntu-branches/ubuntu/oneiric/arora/oneiric

« back to all changes in this revision

Viewing changes to src/opensearch/opensearchenginedelegate.cpp

  • Committer: Bazaar Package Importer
  • Author(s): Roderick B. Greening
  • Date: 2009-09-10 15:24:04 UTC
  • mfrom: (1.1.10 upstream)
  • Revision ID: james.westby@ubuntu.com-20090910152404-668k22ux3mfap6g0
Tags: 0.9.0-0ubuntu1
* New upstream release
* Update patches:
  - kubuntu_02_default_bookmarks.diff
* Remove patches:
  - kubuntu_04_startpage_spacing.diff (fixed upstream)
  - kubuntu_05_manpages.diff (fixed upstream)
  - kubuntu_07_adblock.diff (unstable/unsuitable)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
/*
 
2
 * Copyright 2009 Jakub Wieczorek <faw217@gmail.com>
 
3
 *
 
4
 * This program is free software; you can redistribute it and/or modify
 
5
 * it under the terms of the GNU General Public License as published by
 
6
 * the Free Software Foundation; either version 2 of the License, or
 
7
 * (at your option) any later version.
 
8
 *
 
9
 * This program is distributed in the hope that it will be useful,
 
10
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 
11
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
12
 * GNU General Public License for more details.
 
13
 *
 
14
 * You should have received a copy of the GNU General Public License
 
15
 * along with this program; if not, write to the Free Software
 
16
 * Foundation, Inc., 51 Franklin Street, Fifth Floor,
 
17
 * Boston, MA  02110-1301  USA
 
18
 */
 
19
 
 
20
#include "opensearchenginedelegate.h"
 
21
 
 
22
/*!
 
23
    \class OpenSearchEngineDelegate
 
24
    \brief An abstract class providing custom processing of specific activities.
 
25
 
 
26
    OpenSearchEngineDelegate is an abstract class that can be subclassed and set on
 
27
    an OpenSearchEngine. It allows to customize some parts of the default implementation
 
28
    or even extend it with missing bits.
 
29
 
 
30
    Currently subclasses can only provide a custom way of handling search requests by
 
31
    reimplementing the performSearchRequest() method.
 
32
 
 
33
    \sa OpenSearchEngine
 
34
*/
 
35
 
 
36
/*!
 
37
    Constructs the delegate.
 
38
*/
 
39
OpenSearchEngineDelegate::OpenSearchEngineDelegate()
 
40
{
 
41
}
 
42
 
 
43
/*!
 
44
    Destructs the delegate.
 
45
*/
 
46
OpenSearchEngineDelegate::~OpenSearchEngineDelegate()
 
47
{
 
48
}
 
49
 
 
50
/*!
 
51
    \fn void performSearchRequest(const QNetworkRequest &request,
 
52
    QNetworkAccessManager::Operation operation, const QByteArray &data) = 0
 
53
 
 
54
    This method will be used after OpenSearchEngine::requestResults() is called.
 
55
 
 
56
    For example, a console application that uses the OpenSearchEngine class to generate
 
57
    a search URL for a search term supplied by the user would reimplement the function
 
58
    and forward the request to e.g. a web browser.
 
59
 
 
60
    Likewise, a web browser that uses the OpenSearchEngine class to support multiple search
 
61
    engines e.g. in a toolbar would perform the request and navigate to the search results site.
 
62
*/