summaryrefslogtreecommitdiffstats
path: root/kvoctrain/kvoctrain/kvtnewstuff.h
blob: 9953ac1a0cf42f081583e32015d6a9b19842d452 (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
//
// C++ Interface: kvtnewstuff
//
// Description:
//
//
// Author: Peter Hedlund <peter.hedlund@kdemail.net>, (C) 2005
//
// Copyright: See COPYING file that comes with this distribution
//
//
#ifndef KVTNEWSTUFF_H
#define KVTNEWSTUFF_H

#include <knewstuff/knewstuff.h>

class kvoctrainApp;

/**
@author Peter Hedlund
*/
class KVTNewStuff : public QObject, public KNewStuff
{
Q_OBJECT
public:
  KVTNewStuff(QWidget *parent = 0, const char *name = 0);

  /**
    Installs a downloaded file according to the application's configuration.

    @param fileName filename of the donwloaded file
    @return @c true in case of installation success, @c false otherwise
  */
  bool install(const QString &fileName);

  /**
    Creates a file suitable for upload.
    Note that this method always fails, since using KNewStuffGeneric
    means that the provided file must already be in a usable format.

    @param fileName the name of the file to upload after its creation
    @return @c true in case of creation success, @c false otherwise
  */
  bool createUploadFile(const QString &fileName);

  /**
    Queries the preferred destination file for a download.

    @param entry a Hotstuff data entry
    @return destination filename, or 0 to return directory only
  */
  QString downloadDestination(KNS::Entry *entry);

private:
  QString destinationPath(KNS::Entry *entry);

  kvoctrainApp * m_app;
};

#endif