You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
238 lines
5.6 KiB
238 lines
5.6 KiB
/*
|
|
This file is part of KOrganizer.
|
|
Copyright (c) 2002 Cornelius Schumacher <schumacher@kde.org>
|
|
Copyright (c) 2014 Timothy Pearson <kb9vqf@pearsoncomputing.net>
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Library General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2 of the License, or (at your option) any later version.
|
|
|
|
This library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Library General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Library General Public License
|
|
along with this library; see the file COPYING.LIB. If not, write to
|
|
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
Boston, MA 02110-1301, USA.
|
|
*/
|
|
#ifndef KNEWSTUFF_PROVIDER_H
|
|
#define KNEWSTUFF_PROVIDER_H
|
|
|
|
#include <tqcstring.h>
|
|
#include <tqdom.h>
|
|
#include <tqobject.h>
|
|
#include <tqptrlist.h>
|
|
#include <tqstring.h>
|
|
|
|
#include <kurl.h>
|
|
|
|
namespace TDEIO { class Job; }
|
|
|
|
namespace KNS {
|
|
|
|
/**
|
|
* @short TDENewStuff provider container.
|
|
*
|
|
* This class provides accessors for the provider object.
|
|
* as used by TDENewStuff.
|
|
* It should probably not be used directly by the application.
|
|
*
|
|
* @author Cornelius Schumacher (schumacher@kde.org)
|
|
* \par Maintainer:
|
|
* Timothy Pearson (kb9vqf@pearsoncomputing.net)
|
|
*/
|
|
class KDE_EXPORT Provider : public TQObject
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
typedef TQPtrList<Provider> List;
|
|
|
|
/**
|
|
* Constructor.
|
|
*/
|
|
Provider( TQString type = TQString::null, TQWidget* parent = 0 );
|
|
|
|
/**
|
|
* Constructor with XML feed.
|
|
*/
|
|
Provider( const TQDomElement &, TQString type = TQString::null, TQWidget* parent = 0 );
|
|
|
|
/**
|
|
* Destructor.
|
|
*/
|
|
virtual ~Provider();
|
|
|
|
/**
|
|
* @return provider load status
|
|
*/
|
|
bool loaded();
|
|
|
|
/**
|
|
* Sets the common name of the provider.
|
|
*/
|
|
void setName( const TQString & );
|
|
|
|
/**
|
|
* Retrieves the common name of the provider.
|
|
*
|
|
* @return provider name
|
|
*/
|
|
TQString name() const;
|
|
|
|
/**
|
|
* Sets the download URL.
|
|
*/
|
|
void setDownloadUrl( const KURL & );
|
|
|
|
/**
|
|
* Retrieves the download URL.
|
|
*
|
|
* @return download URL
|
|
*/
|
|
KURL downloadUrl() const;
|
|
|
|
/**
|
|
* Variant to retrieve 'tagged' download URLs.
|
|
* Variant can be one of 'score', 'downloads', 'latest'.
|
|
*
|
|
* @return download specific URL
|
|
*/
|
|
KURL downloadUrlVariant( TQString variant ) const;
|
|
|
|
/**
|
|
* Sets the upload URL.
|
|
*/
|
|
void setUploadUrl( const KURL & );
|
|
|
|
/**
|
|
* Retrieves the upload URL.
|
|
*
|
|
* @return upload URL
|
|
*/
|
|
KURL uploadUrl() const;
|
|
|
|
/**
|
|
* Sets the URL where a user is led if the provider does not support
|
|
* uploads.
|
|
*
|
|
* @see setNoUpload
|
|
*/
|
|
void setNoUploadUrl( const KURL & );
|
|
|
|
/**
|
|
* Retrieves the URL where a user is led if the provider does not
|
|
* support uploads.
|
|
*
|
|
* @return website URL
|
|
*/
|
|
KURL noUploadUrl() const;
|
|
|
|
/**
|
|
* Indicate whether provider supports uploads.
|
|
*/
|
|
void setNoUpload( bool );
|
|
|
|
/**
|
|
* Query whether provider supports uploads.
|
|
*
|
|
* @return upload support status
|
|
*/
|
|
bool noUpload() const;
|
|
|
|
/**
|
|
* Sets the URL for an icon for this provider.
|
|
* The icon should be in 32x32 format. If not set, the default icon
|
|
* of KDialogBase is used.
|
|
*/
|
|
void setIcon( const KURL & );
|
|
|
|
/**
|
|
* Retrieves the icon URL for this provider.
|
|
*
|
|
* @return icon URL
|
|
*/
|
|
KURL icon() const;
|
|
|
|
protected:
|
|
void parseDomElement( const TQDomElement & );
|
|
|
|
TQDomElement createDomElement( TQDomDocument &, TQDomElement &parent );
|
|
|
|
protected slots:
|
|
void slotJobData( TDEIO::Job *, const TQByteArray & );
|
|
void slotJobResult( TDEIO::Job * );
|
|
|
|
signals:
|
|
void providerLoaded();
|
|
|
|
private:
|
|
TQString mName;
|
|
KURL mDownloadUrl;
|
|
KURL mUploadUrl;
|
|
KURL mNoUploadUrl;
|
|
KURL mIcon;
|
|
bool mNoUpload;
|
|
TQString mJobData;
|
|
TQString mBaseURL;
|
|
TQWidget* mParent;
|
|
bool mLoaded;
|
|
TQString mContentType;
|
|
};
|
|
|
|
/**
|
|
* TDENewStuff provider loader.
|
|
* This class sets up a list of all possible providers by querying
|
|
* the main provider database for this specific application.
|
|
* It should probably not be used directly by the application.
|
|
*/
|
|
class KDE_EXPORT ProviderLoader : public TQObject
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* @param parentWidget the parent widget
|
|
*/
|
|
ProviderLoader( TQWidget *parentWidget );
|
|
|
|
/**
|
|
* Starts asynchronously loading the list of providers of the
|
|
* specified type.
|
|
*
|
|
* @param type data type such as 'kdesktop/wallpaper'.
|
|
* @param providerList the URl to the list of providers; if empty
|
|
* we first try the ProvidersUrl from TDEGlobal::config, then we
|
|
* fall back to a hardcoded value.
|
|
*/
|
|
void load( const TQString &type, const TQString &providerList = TQString::null );
|
|
|
|
signals:
|
|
/**
|
|
* Indicates that the list of providers has been successfully loaded.
|
|
*/
|
|
void providersLoaded( Provider::List * );
|
|
void percent(TDEIO::Job *job, unsigned long percent);
|
|
void error();
|
|
|
|
protected slots:
|
|
void slotJobData( TDEIO::Job *, const TQByteArray & );
|
|
void slotJobResult( TDEIO::Job * );
|
|
void providerLoaded();
|
|
|
|
private:
|
|
TQWidget *mParentWidget;
|
|
|
|
TQString mJobData;
|
|
TQString mContentType;
|
|
|
|
Provider::List mProviders;
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|