KCal::CustomProperties Class Reference

#include <customproperties.h>

Inheritance diagram for KCal::CustomProperties:

Public Member Functions
	CustomProperties ()
	CustomProperties (const CustomProperties &other)
virtual	~CustomProperties ()
QMap< QByteArray, QString >	customProperties () const
QString	customProperty (const QByteArray &app, const QByteArray &key) const
QString	nonKDECustomProperty (const QByteArray &name) const
CustomProperties &	operator= (const CustomProperties &other)
bool	operator== (const CustomProperties &properties) const
void	removeCustomProperty (const QByteArray &app, const QByteArray &key)
void	removeNonKDECustomProperty (const QByteArray &name)
void	setCustomProperties (const QMap< QByteArray, QString > &properties)
void	setCustomProperty (const QByteArray &app, const QByteArray &key, const QString &value)
void	setNonKDECustomProperty (const QByteArray &name, const QString &value)

Static Public Member Functions
static QByteArray	customPropertyName (const QByteArray &app, const QByteArray &key)

Protected Member Functions
virtual void	customPropertyUpdated ()

Detailed Description

A class to manage custom calendar properties.

This class represents custom calendar properties. It is used as a base class for classes which represent calendar components. A custom property name written by the kcal library has the form X-KDE-APP-KEY where APP represents the application name, and KEY distinguishes individual properties for the application. In keeping with RFC2445, property names must be composed only of the characters A-Z, a-z, 0-9 and '-'.

Definition at line 52 of file customproperties.h.

Constructor & Destructor Documentation

CustomProperties::CustomProperties

(

)

Constructs an empty custom properties instance.

Definition at line 65 of file customproperties.cpp.

CustomProperties::CustomProperties

(

const CustomProperties &

other

)

Copy constructor.

Parameters

other

is the one to copy.

Definition at line 70 of file customproperties.cpp.

CustomProperties::~CustomProperties ( )

virtual

Destructor.

Definition at line 86 of file customproperties.cpp.

Member Function Documentation

QMap< QByteArray, QString > CustomProperties::customProperties

(

)

const

Returns all custom calendar property key/value pairs.

See also

setCustomProperties().

Definition at line 166 of file customproperties.cpp.

QString CustomProperties::customProperty	(	const QByteArray &	app,
		const QByteArray &	key
	)		const

Return the value of a custom calendar property.

Parameters

app	Application name as it appears in the custom property name.
key	Property identifier specific to the application.

Returns

Property value, or QString() if (and only if) the property does not exist.

Definition at line 115 of file customproperties.cpp.

QByteArray CustomProperties::customPropertyName ( const QByteArray &  app, const QByteArray &  key  )

static

Validate and return the full name of a custom calendar property.

Parameters

app	Application name as it appears in the custom property name.
key	Property identifier specific to the application.

Returns

Full property name, or empty string if it would contain invalid characters

Since

4.5

Definition at line 120 of file customproperties.cpp.

virtual void KCal::CustomProperties::customPropertyUpdated ( )

inlineprotectedvirtual

Called when a custom property has been changed.

The default implementation does nothing: override in derived classes to perform change processing.

Reimplemented in KCal::Calendar, KCal::Alarm, and KCal::IncidenceBase.

Definition at line 178 of file customproperties.h.

QString CustomProperties::nonKDECustomProperty

(

const QByteArray &

name

)

const

Return the value of a non-KDE or non-standard custom calendar property.

Parameters

name	Full property name

Returns

Property value, or QString() if (and only if) the property does not exist.

Definition at line 145 of file customproperties.cpp.

CustomProperties & CustomProperties::operator=

(

const CustomProperties &

other

)

Assignment operator.

Warning

The assignment is not polymorphic.

Definition at line 75 of file customproperties.cpp.

bool CustomProperties::operator==

(

const CustomProperties &

properties

)

const

Compare this with properties for equality.

Parameters

properties

is the one to compare.

Warning

The comparison is not polymorphic.

Definition at line 91 of file customproperties.cpp.

void CustomProperties::removeCustomProperty	(	const QByteArray &	app,
		const QByteArray &	key
	)

Delete a custom calendar property.

Parameters

app	Application name as it appears in the custom property name.
key	Property identifier specific to the application.

See also

setCustomProperty().

Definition at line 110 of file customproperties.cpp.

void CustomProperties::removeNonKDECustomProperty

(

const QByteArray &

name

)

Delete a non-KDE or non-standard custom calendar property.

Parameters

name	Full property name

See also

setNonKDECustomProperty().

Definition at line 138 of file customproperties.cpp.

void CustomProperties::setCustomProperties

(

const QMap< QByteArray, QString > &

properties

)

Initialise the alarm's custom calendar properties to the specified key/value pairs.

Parameters

properties

is a QMap of property key/value pairs.

See also

customProperties().

Definition at line 150 of file customproperties.cpp.

void CustomProperties::setCustomProperty	(	const QByteArray &	app,
		const QByteArray &	key,
		const QString &	value
	)

Create or modify a custom calendar property.

Parameters

app	Application name as it appears in the custom property name.
key	Property identifier specific to the application.
value	The property's value. A call with a value of QString() will be ignored.

See also

removeCustomProperty().

Definition at line 96 of file customproperties.cpp.

void CustomProperties::setNonKDECustomProperty	(	const QByteArray &	name,
		const QString &	value
	)

Create or modify a non-KDE or non-standard custom calendar property.

Parameters

name	Full property name
value	The property's value. A call with a value of QString() will be ignored.

See also

removeNonKDECustomProperty().

Definition at line 129 of file customproperties.cpp.

---

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

• customproperties.h
• customproperties.cpp