KCoreAddons
kaboutdata.cpp
319 // Expressions can in theory also contain AND, OR and () to build constructs involving more than
339 licenseShort = QCoreApplication::translate("KAboutLicense", "GPL v2", "@item license (short name)");
340 licenseFull = QCoreApplication::translate("KAboutLicense", "GNU General Public License Version 2", "@item license");
343 licenseShort = QCoreApplication::translate("KAboutLicense", "LGPL v2", "@item license (short name)");
344 licenseFull = QCoreApplication::translate("KAboutLicense", "GNU Lesser General Public License Version 2", "@item license");
347 licenseShort = QCoreApplication::translate("KAboutLicense", "BSD License", "@item license (short name)");
351 licenseShort = QCoreApplication::translate("KAboutLicense", "Artistic License", "@item license (short name)");
352 licenseFull = QCoreApplication::translate("KAboutLicense", "Artistic License", "@item license");
355 licenseShort = QCoreApplication::translate("KAboutLicense", "QPL v1.0", "@item license (short name)");
356 licenseFull = QCoreApplication::translate("KAboutLicense", "Q Public License", "@item license");
359 licenseShort = QCoreApplication::translate("KAboutLicense", "GPL v3", "@item license (short name)");
360 licenseFull = QCoreApplication::translate("KAboutLicense", "GNU General Public License Version 3", "@item license");
363 licenseShort = QCoreApplication::translate("KAboutLicense", "LGPL v3", "@item license (short name)");
364 licenseFull = QCoreApplication::translate("KAboutLicense", "GNU Lesser General Public License Version 3", "@item license");
367 licenseShort = QCoreApplication::translate("KAboutLicense", "LGPL v2.1", "@item license (short name)");
368 licenseFull = QCoreApplication::translate("KAboutLicense", "GNU Lesser General Public License Version 2.1", "@item license");
372 licenseShort = licenseFull = QCoreApplication::translate("KAboutLicense", "Custom", "@item license");
375 licenseShort = licenseFull = QCoreApplication::translate("KAboutLicense", "Not specified", "@item license");
481 static QList<KAboutPerson> parseTranslators(const QString &translatorName, const QString &translatorEmail);
531 // KF6: do not set a default desktopFileName value here, but remove this code and leave it empty
563 // KF6: do not set a default desktopFileName value here, but remove this code and leave it empty
894 QList<KAboutPerson> KAboutData::Private::parseTranslators(const QString &translatorName, const QString &translatorEmail)
1050 qCWarning(KABOUTDATA) << appDataString <<appDataValue << "is out-of-sync with" << aboutDataString << aboutDataValue;
1078 qCWarning(KABOUTDATA) << "Could not initialize the properties of KAboutData::applicationData by the equivalent properties from Q*Application: no app instance (yet) existing.";
1089 warnIfOutOfSync("KAboutData::applicationData().organizationDomain", aboutData->organizationDomain(),
1093 "QGuiApplication::applicationDisplayName", app->property("applicationDisplayName").toString());
1122 qCWarning(KABOUTDATA) << "Could not initialize the equivalent properties of Q*Application: no instance (yet) existing.";
1125 // KF6: Rethink the current relation between KAboutData::applicationData and the Q*Application metadata
1177 return parser->addOption(QCommandLineOption(QStringLiteral("author"), QCoreApplication::translate("KAboutData CLI", "Show author information.")))
1178 && parser->addOption(QCommandLineOption(QStringLiteral("license"), QCoreApplication::translate("KAboutData CLI", "Show license information.")))
1180 QCoreApplication::translate("KAboutData CLI", "The base file name of the desktop entry for this application."),
1190 printf("%s\n", qPrintable(QCoreApplication::translate("KAboutData CLI", "This application was written by somebody who wants to remain anonymous.")));
1192 printf("%s\n", qPrintable(QCoreApplication::translate("KAboutData CLI", "%1 was written by:").arg(qAppName())));
1203 printf("%s\n", qPrintable(QCoreApplication::translate("KAboutData CLI", "Please use https://bugs.kde.org to report bugs.")));
1205 printf("%s\n", qPrintable(QCoreApplication::translate("KAboutData CLI", "Please report bugs to %1.").arg(bugAddress())));
KAboutData & setCopyrightStatement(const QString ©rightStatement)
Defines the copyright statement to show when displaying the license.
Definition: kaboutdata.cpp:746
KAboutData & setBugAddress(const QByteArray &bugAddress)
Defines the address where bug reports should be sent.
Definition: kaboutdata.cpp:764
QString & append(QChar ch)
QString organizationDomain() const
Returns the domain name of the organization that wrote this application.
Definition: kaboutdata.cpp:868
void processCommandLine(QCommandLineParser *parser)
Reads the processed parser and sees if any of the arguments are the ones set up from setupCommandLine...
Definition: kaboutdata.cpp:1184
static KAboutData applicationData()
Returns the KAboutData for the application.
Definition: kaboutdata.cpp:1056
KAboutData & setLicense(KAboutLicense::LicenseKey licenseKey)
Defines the license identifier.
Definition: kaboutdata.cpp:716
KAboutData & setOtherText(const QString &otherText)
Defines the additional text to show in the about dialog.
Definition: kaboutdata.cpp:752
void removeFirst()
QString translate(const char *context, const char *sourceText, const char *disambiguation, int n)
QString host(QUrl::ComponentFormattingOptions options) const const
KAboutData & setDesktopFileName(const QString &desktopFileName)
Sets the base name of the desktop entry for this application.
Definition: kaboutdata.cpp:993
QString ocsProviderUrl() const
Returns the chosen Open Collaboration Services provider URL.
Definition: kaboutdata.cpp:835
KAboutData & setDisplayName(const QString &displayName)
Defines the displayable component name string.
Definition: kaboutdata.cpp:691
const char * internalBugAddress() const
Definition: kaboutdata.cpp:876
QCommandLineOption addVersionOption()
KAboutData & setHomepage(const QString &homepage)
Defines the program homepage.
Definition: kaboutdata.cpp:758
QString desktopFileName() const
KAboutLicense & operator=(const KAboutLicense &other)
Assignment operator.
Definition: kaboutdata.cpp:386
ReadOnly
QString organizationDomain()
QString join(const QString &separator) const const
QString & remove(int position, int n)
static KAboutData * pluginData(const QString &componentName)
Return the KAboutData for the given plugin identified by componentName.
Definition: kaboutdata.cpp:1148
KAboutData & addAuthor(const QString &name, const QString &task=QString(), const QString &emailAddress=QString(), const QString &webAddress=QString(), const QString &ocsUsername=QString())
Defines an author.
Definition: kaboutdata.cpp:615
int size() const const
KAboutData & setVersion(const QByteArray &version)
Defines the program version string.
Definition: kaboutdata.cpp:704
KAboutData & setLicenseText(const QString &license)
Defines a license text, which is translated.
Definition: kaboutdata.cpp:642
KAboutData & setOcsProvider(const QString &providerUrl)
Specifies an Open Collaboration Services provider by URL.
Definition: kaboutdata.cpp:698
static void registerPluginData(const KAboutData &aboutData)
Register the KAboutData information for a plugin.
Definition: kaboutdata.cpp:1135
Definition: kaboutdata.h:199
KAboutPerson & operator=(const KAboutPerson &other)
Assignment operator.
Definition: kaboutdata.cpp:103
QVector< V > values(const QMultiHash< K, V > &c)
KAboutData & setCustomAuthorText(const QString &plainText, const QString &richText)
Sets the custom text displayed around the list of authors instead of the default message telling user...
Definition: kaboutdata.cpp:972
bool customAuthorTextEnabled() const
Returns whether custom text should be displayed around the list of authors.
Definition: kaboutdata.cpp:967
int count(const T &value) const const
QString applicationVersion()
void append(const T &value)
QString fromUtf8(const char *str, int size)
QVariant property(const char *name) const const
KAboutData & addLicenseTextFile(const QString &file)
Adds a license text by pointing to a file where it resides.
Definition: kaboutdata.cpp:671
KAboutData & addCredit(const QString &name, const QString &task=QString(), const QString &emailAddress=QString(), const QString &webAddress=QString(), const QString &ocsUsername=QString())
Defines a person that deserves credit.
Definition: kaboutdata.cpp:625
void setUrl(const QString &url, QUrl::ParsingMode parsingMode)
Definition: kmacroexpander.h:17
static QString readTranslatedString(const QJsonObject &jo, const QString &key, const QString &defaultValue=QString())
Definition: kpluginmetadata.cpp:201
bool isEmpty() const const
QString trimmed() const const
QStringList split(const QString &sep, QString::SplitBehavior behavior, Qt::CaseSensitivity cs) const const
QCommandLineOption addHelpOption()
bool endsWith(const QString &s, Qt::CaseSensitivity cs) const const
This class is used to store information about a program or plugin.
Definition: kaboutdata.h:394
void setApplicationDescription(const QString &description)
QCoreApplication * instance()
KAboutData & setProductName(const QByteArray &name)
Defines the product name which will be used in the KBugReport dialog.
Definition: kaboutdata.cpp:776
GenericDataLocation
KAboutData & addLicense(KAboutLicense::LicenseKey licenseKey)
Adds a license identifier.
Definition: kaboutdata.cpp:728
KAboutData & setShortDescription(const QString &shortDescription)
Defines a short description of what the program does.
Definition: kaboutdata.cpp:710
bool isSet(const QString &name) const const
virtual bool open(QIODevice::OpenMode mode) override
QString scheme() const const
QList::iterator end()
QString toLower() const const
static void setApplicationData(const KAboutData &aboutData)
Sets the application data for this application.
Definition: kaboutdata.cpp:1102
KeepEmptyParts
KAboutData & setOrganizationDomain(const QByteArray &domain)
Defines the domain of the organization that wrote this application.
Definition: kaboutdata.cpp:770
QVariant fromValue(const T &value)
This class is used to store information about a person or developer.
Definition: kaboutdata.h:55
static KAboutData fromPluginMetaData(const KPluginMetaData &plugin)
Creates a KAboutData from the given plugin metadata.
Definition: kaboutdata.cpp:599
static KAboutPerson fromJSON(const QJsonObject &obj)
Creates a KAboutPerson from a JSON object with the following structure:
Definition: kaboutdata.cpp:109
QString ocsUsername() const
The person's Open Collaboration Services username.
KAboutData & addLicenseText(const QString &license)
Adds a license text, which is translated.
Definition: kaboutdata.cpp:649
QString customAuthorPlainText() const
Returns the plain text displayed around the list of authors instead of the default message telling us...
Definition: kaboutdata.cpp:957
bool isValid() const const
QByteArray toLatin1() const const
QString productName() const
Returns the application's product name, which will be used in KBugReport dialog.
KAboutData & unsetCustomAuthorText()
Clears any custom text displayed around the list of authors and falls back to the default message tel...
Definition: kaboutdata.cpp:983
bool setupCommandLine(QCommandLineParser *parser)
Configures the parser command line parser to provide an authors entry with information about the deve...
Definition: kaboutdata.cpp:1164
KAboutData & setLicenseTextFile(const QString &file)
Defines a license text by pointing to a file where it resides.
Definition: kaboutdata.cpp:664
static KAboutLicense byKeyword(const QString &keyword)
Fetch a known license by a keyword/spdx ID.
Definition: kaboutdata.cpp:397
QString arg(qlonglong a, int fieldWidth, int base, QChar fillChar) const const
static QString aboutTranslationTeam()
Returns a message about the translation team.
Definition: kaboutdata.cpp:930
This class allows easily accessing some standardized values from the JSON metadata that can be embedd...
Definition: kpluginmetadata.h:87
KAboutPerson(const QString &name=QString(), const QString &task=QString(), const QString &emailAddress=QString(), const QString &webAddress=QString(), const QString &ocsUsername=QString())
Convenience constructor.
Definition: kaboutdata.cpp:47
KAboutData & setComponentName(const QString &componentName)
Defines the component name used internally.
Definition: kaboutdata.cpp:685
bool addOption(const QCommandLineOption &option)
char * data()
KAboutData & setProgramLogo(const QVariant &image)
Defines the program logo.
Definition: kaboutdata.cpp:829
QString fromLatin1(const char *str, int size)
const char * internalProgramName() const
Definition: kaboutdata.cpp:806
KAboutData & setProgramIconName(const QString &iconName)
Obsolete method.
Definition: kaboutdata.cpp:817
bool setProperty(const char *name, const QVariant &value)
KAboutData(const QString &componentName, const QString &displayName, const QString &version, const QString &shortDescription, enum KAboutLicense::LicenseKey licenseType, const QString ©rightStatement=QString(), const QString &otherText=QString(), const QString &homePageAddress=QString(), const QString &bugAddress=QStringLiteral("[email protected]"))
Constructor.
Definition: kaboutdata.cpp:485
QString customAuthorRichText() const
Returns the rich text displayed around the list of authors instead of the default message telling use...
Definition: kaboutdata.cpp:962
QString readAll()
QString toString() const const
QString value(const QString &optionName) const const
QString shortDescription() const
Returns a short, translated description.
QList::iterator begin()
QString applicationName()
QString locate(QStandardPaths::StandardLocation type, const QString &fileName, QStandardPaths::LocateOptions options)
KAboutData & setTranslator(const QString &name, const QString &emailAddress)
Sets the name(s) of the translator(s) of the GUI.
Definition: kaboutdata.cpp:635
QByteArray toUtf8() const const
This file is part of the KDE documentation.
Documentation copyright © 1996-2021 The KDE developers.
Generated on Wed Jan 20 2021 23:06:36 by doxygen 1.8.11 written by Dimitri van Heesch, © 1997-2006
Documentation copyright © 1996-2021 The KDE developers.
Generated on Wed Jan 20 2021 23:06:36 by doxygen 1.8.11 written by Dimitri van Heesch, © 1997-2006
KDE's Doxygen guidelines are available online.