KAboutPerson Class Reference

#include <kaboutdata.h>

Properties
QString	emailAddress
QString	name
QString	ocsUsername
QString	task
QString	webAddress

Public Member Functions
	KAboutPerson (const KAboutPerson &other)
	KAboutPerson (const QString &name=QString(), const QString &task=QString(), const QString &emailAddress=QString(), const QString &webAddress=QString(), const QString &ocsUsername=QString())
QString	emailAddress () const
QString	name () const
QString	ocsUsername () const
KAboutPerson &	operator= (const KAboutPerson &other)
QString	task () const
QString	webAddress () const

Static Public Member Functions
static KAboutPerson	fromJSON (const QJsonObject &obj)

Detailed Description

This class is used to store information about a person or developer.

It can store the person's name, a task, an email address and a link to a home page. This class is intended for use in the KAboutData class, but it can be used elsewhere as well. Normally you should at least define the person's name. Creating a KAboutPerson object by yourself is relatively useless, but the KAboutData methods KAboutData::authors() and KAboutData::credits() return lists of KAboutPerson data objects which you can examine.

Example usage within a main(), retrieving the list of people involved with a program and re-using data from one of them:

KAboutData about("khello", i18n("KHello"), "0.1",
                  i18n("A KDE version of Hello, world!"),
                  KAboutLicense::LGPL,
                  i18n("Copyright (C) 2014 Developer"));
 
about.addAuthor(i18n("Joe Developer"), i18n("developer"), "[email protected]", 0);
QList<KAboutPerson> people = about.authors();
about.addCredit(people[0].name(), people[0].task());

Definition at line 61 of file kaboutdata.h.

Constructor & Destructor Documentation

KAboutPerson() [1/2]

KAboutPerson::KAboutPerson ( const QString &  name = QString(), const QString &  task = QString(), const QString &  emailAddress = QString(), const QString &  webAddress = QString(), const QString &  ocsUsername = QString()  )

explicit

Convenience constructor.

Parameters

name	The name of the person.
task	The task of this person.
emailAddress	The email address of the person.
webAddress	Home page of the person.
ocsUsername	Open Collaboration Services username of the person.

name default argument

Since

5.53

Definition at line 47 of file kaboutdata.cpp.

KAboutPerson() [2/2]

KAboutPerson::KAboutPerson ( const KAboutPerson &  other )

default

Copy constructor.

Performs a deep copy.

Parameters

other

object to copy

Member Function Documentation

emailAddress()

QString KAboutPerson::emailAddress

(

)

const

The person's email address.

Returns

the person's email address (can be QString(), if it has been constructed with an empty email)

fromJSON()

KAboutPerson KAboutPerson::fromJSON ( const QJsonObject &  obj )

static

Creates a KAboutPerson from a JSON object with the following structure:

Key	Accessor
Name	name()
Email	emailAddress()
Task	task()
Website	webAddress()
UserName	ocsUsername()

The Name and Task key are translatable (by using e.g. a "Task[de_DE]" key)

Since

5.18

Definition at line 95 of file kaboutdata.cpp.

name()

QString KAboutPerson::name

(

)

const

The person's name.

Returns

the person's name (can be QString(), if it has been constructed with an empty name)

ocsUsername()

QString KAboutPerson::ocsUsername

(

)

const

The person's Open Collaboration Services username.

Returns

the persons OCS username (can be QString(), if it has been constructed with an empty username)

operator=()

KAboutPerson & KAboutPerson::operator= ( const KAboutPerson &  other )

default

Assignment operator.

Performs a deep copy.

Parameters

other

object to copy

task()

QString KAboutPerson::task

(

)

const

The person's task.

Returns

the person's task (can be QString(), if it has been constructed with an empty task)

webAddress()

QString KAboutPerson::webAddress

(

)

const

The home page or a relevant link.

Returns

the persons home page (can be QString(), if it has been constructed with an empty home page)

---

The documentation for this class was generated from the following files:

• kaboutdata.h
• kaboutdata.cpp