• Skip to content
  • Skip to link menu
  • KDE API Reference
  • kdelibs-4.14.38 API Reference
  • KDE Home
  • Contact Us
 

Plasma

  • Plasma
  • PackageMetadata
Public Member Functions | List of all members
Plasma::PackageMetadata Class Reference

#include <Plasma/PackageMetadata>

Public Member Functions

 PackageMetadata (const PackageMetadata &other)
 
 PackageMetadata (const QString &path=QString())
 
 ~PackageMetadata ()
 
QString application () const
 
QString author () const
 
QString category () const
 
QString description () const
 
QString email () const
 
QString icon () const
 
QString implementationApi () const
 
bool isValid () const
 
QStringList keywords () const
 
QString license () const
 
QString name () const
 
PackageMetadata & operator= (const PackageMetadata &other)
 
QString pluginName () const
 
void read (const QString &filename)
 
KUrl remoteLocation () const
 
QString requiredVersion () const
 
QString serviceType () const
 
void setApplication (const QString &)
 
void setAuthor (const QString &)
 
void setCategory (const QString &)
 
void setDescription (const QString &)
 
void setEmail (const QString &)
 
void setIcon (const QString &icon)
 
void setImplementationApi (const QString &api)
 
void setKeywords (const QStringList &keywords)
 
void setLicense (const QString &)
 
void setName (const QString &)
 
void setPluginName (const QString &name)
 
void setRemoteLocation (const KUrl &)
 
void setRequiredVersion (const QString &)
 
void setServiceType (const QString &)
 
void setType (const QString &type)
 
void setVersion (const QString &)
 
void setWebsite (const QString &)
 
QString type () const
 
QString version () const
 
QString website () const
 
void write (const QString &filename) const
 

Detailed Description

Provides metadata for a Package.

Definition at line 56 of file packagemetadata.h.

Constructor & Destructor Documentation

◆ PackageMetadata() [1/2]

Plasma::PackageMetadata::PackageMetadata ( const QString &  path = QString())
explicit

Constructs a metadata object using the values in the file at path.

Parameters
pathpath to a metadata.desktop file

Definition at line 85 of file packagemetadata.cpp.

◆ PackageMetadata() [2/2]

Plasma::PackageMetadata::PackageMetadata ( const PackageMetadata &  other)

Copy constructor.

Definition at line 74 of file packagemetadata.cpp.

◆ ~PackageMetadata()

Plasma::PackageMetadata::~PackageMetadata ( )

Definition at line 91 of file packagemetadata.cpp.

Member Function Documentation

◆ application()

QString Plasma::PackageMetadata::application ( ) const

Definition at line 226 of file packagemetadata.cpp.

◆ author()

QString Plasma::PackageMetadata::author ( ) const

Definition at line 191 of file packagemetadata.cpp.

◆ category()

QString Plasma::PackageMetadata::category ( ) const

Definition at line 231 of file packagemetadata.cpp.

◆ description()

QString Plasma::PackageMetadata::description ( ) const

Definition at line 181 of file packagemetadata.cpp.

◆ email()

QString Plasma::PackageMetadata::email ( ) const

Definition at line 196 of file packagemetadata.cpp.

◆ icon()

QString Plasma::PackageMetadata::icon ( ) const

Returns the icon name associated with this package, or QString() if none.

Since
4.5

Definition at line 201 of file packagemetadata.cpp.

◆ implementationApi()

QString Plasma::PackageMetadata::implementationApi ( ) const

Definition at line 261 of file packagemetadata.cpp.

◆ isValid()

bool Plasma::PackageMetadata::isValid ( ) const

Definition at line 96 of file packagemetadata.cpp.

◆ keywords()

QStringList Plasma::PackageMetadata::keywords ( ) const

Definition at line 241 of file packagemetadata.cpp.

◆ license()

QString Plasma::PackageMetadata::license ( ) const

Definition at line 221 of file packagemetadata.cpp.

◆ name()

QString Plasma::PackageMetadata::name ( ) const

Definition at line 176 of file packagemetadata.cpp.

◆ operator=()

PackageMetadata & Plasma::PackageMetadata::operator= ( const PackageMetadata &  other)

Definition at line 79 of file packagemetadata.cpp.

◆ pluginName()

QString Plasma::PackageMetadata::pluginName ( ) const

Definition at line 271 of file packagemetadata.cpp.

◆ read()

void Plasma::PackageMetadata::read ( const QString &  filename)

Reads in metadata from a file, which should be a .desktop file.

It writes out the information in a format that is compatible with KPluginInfo

See also
KPluginInfo
Parameters
filenamepath to the file to write to

Definition at line 130 of file packagemetadata.cpp.

◆ remoteLocation()

KUrl Plasma::PackageMetadata::remoteLocation ( ) const

Definition at line 251 of file packagemetadata.cpp.

◆ requiredVersion()

QString Plasma::PackageMetadata::requiredVersion ( ) const

Definition at line 246 of file packagemetadata.cpp.

◆ serviceType()

QString Plasma::PackageMetadata::serviceType ( ) const

Definition at line 186 of file packagemetadata.cpp.

◆ setApplication()

void Plasma::PackageMetadata::setApplication ( const QString &  application)

Set the name of the application this package may belongs to.

This is used only for display purposes so far.

Definition at line 321 of file packagemetadata.cpp.

◆ setAuthor()

void Plasma::PackageMetadata::setAuthor ( const QString &  author)

Set the name of the author of the package.

Definition at line 296 of file packagemetadata.cpp.

◆ setCategory()

void Plasma::PackageMetadata::setCategory ( const QString &  category)

Sets the category this package belongs in.

Definition at line 326 of file packagemetadata.cpp.

◆ setDescription()

void Plasma::PackageMetadata::setDescription ( const QString &  description)

Set the description used to provide some general information what the package is about.

Definition at line 286 of file packagemetadata.cpp.

◆ setEmail()

void Plasma::PackageMetadata::setEmail ( const QString &  email)

Set the E-Mail address of the author or of the project that provided the package.

Definition at line 301 of file packagemetadata.cpp.

◆ setIcon()

void Plasma::PackageMetadata::setIcon ( const QString &  icon)

Set the icon name to be used with this package.

Since
4.5

Definition at line 206 of file packagemetadata.cpp.

◆ setImplementationApi()

void Plasma::PackageMetadata::setImplementationApi ( const QString &  api)

Set the implementation API this package uses.

Definition at line 266 of file packagemetadata.cpp.

◆ setKeywords()

void Plasma::PackageMetadata::setKeywords ( const QStringList &  keywords)

Set the keywords used to provide search and categorizations.

Parameters
keywordsthe keywords to associate with this package

Definition at line 236 of file packagemetadata.cpp.

◆ setLicense()

void Plasma::PackageMetadata::setLicense ( const QString &  license)

Set the license the package is distributed under.

Definition at line 316 of file packagemetadata.cpp.

◆ setName()

void Plasma::PackageMetadata::setName ( const QString &  name)

Set the name of the package used to displayed a short describing name.

Definition at line 281 of file packagemetadata.cpp.

◆ setPluginName()

void Plasma::PackageMetadata::setPluginName ( const QString &  name)

Set the plugin name of the package.

The plugin name is used to locate the package;

QString serviceName("plasma-applet-" + data.pluginName());
QString service = KStandardDirs::locateLocal("services", serviceName + ".desktop");

Definition at line 276 of file packagemetadata.cpp.

◆ setRemoteLocation()

void Plasma::PackageMetadata::setRemoteLocation ( const KUrl &  location)

Set the url where this package is hosted.

Definition at line 336 of file packagemetadata.cpp.

◆ setRequiredVersion()

void Plasma::PackageMetadata::setRequiredVersion ( const QString &  requiredVersion)

Set the required version.

See also the setVersion() method.

Definition at line 331 of file packagemetadata.cpp.

◆ setServiceType()

void Plasma::PackageMetadata::setServiceType ( const QString &  serviceType)

Set the service-type which defines the X-KDE-ServiceTypes type within the desktop file.

If not defined this defaults to "Plasma/Applet,Plasma/Containment" in the desktop file.

Definition at line 291 of file packagemetadata.cpp.

◆ setType()

void Plasma::PackageMetadata::setType ( const QString &  type)

Set the type of the package.

If not defined this defaults to "Service" in the desktop file.

Definition at line 341 of file packagemetadata.cpp.

◆ setVersion()

void Plasma::PackageMetadata::setVersion ( const QString &  version)

Set the version of the package.

Definition at line 306 of file packagemetadata.cpp.

◆ setWebsite()

void Plasma::PackageMetadata::setWebsite ( const QString &  website)

Set the website URL where the package is hosted or where additional details about the project are available.

Definition at line 311 of file packagemetadata.cpp.

◆ type()

QString Plasma::PackageMetadata::type ( ) const

Definition at line 256 of file packagemetadata.cpp.

◆ version()

QString Plasma::PackageMetadata::version ( ) const

Definition at line 211 of file packagemetadata.cpp.

◆ website()

QString Plasma::PackageMetadata::website ( ) const

Definition at line 216 of file packagemetadata.cpp.

◆ write()

void Plasma::PackageMetadata::write ( const QString &  filename) const

Writes out the metadata to filename, which should be a .desktop file.

It writes out the information in a format that is compatible with KPluginInfo

See also
KPluginInfo
Parameters
filenamepath to the file to write to

Definition at line 104 of file packagemetadata.cpp.


The documentation for this class was generated from the following files:
  • packagemetadata.h
  • packagemetadata.cpp
This file is part of the KDE documentation.
Documentation copyright © 1996-2020 The KDE developers.
Generated on Thu Jan 30 2020 00:00:00 by doxygen 1.8.17 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.

Plasma

Skip menu "Plasma"
  • Main Page
  • Namespace List
  • Namespace Members
  • Alphabetical List
  • Class List
  • Class Hierarchy
  • Class Members
  • File List
  • File Members
  • Related Pages

kdelibs-4.14.38 API Reference

Skip menu "kdelibs-4.14.38 API Reference"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDEWebKit
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • kio
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • KPty
  • Kross
  • KUnitConversion
  • KUtils
  • Nepomuk
  • Plasma
  • Solid
  • Sonnet
  • ThreadWeaver
Report problems with this website to our bug tracking system.
Contact the specific authors with questions and comments about the page contents.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal