KContacts::Field Class Reference

#include <field.h>

Public Types
enum	FieldCategory {   All = 0x0, Frequent = 0x01, Address = 0x02, Email = 0x04,   Personal = 0x08, Organization = 0x10, CustomCategory = 0x20 }
typedef QList< Field * >	List

Public Member Functions
virtual int	category ()
virtual bool	equals (Field *field)
virtual bool	isCustom ()
virtual QString	label ()
virtual bool	setValue (KContacts::Addressee &addressee, const QString &value)
QString	sortKey (const KContacts::Addressee &addressee)
virtual QString	value (const KContacts::Addressee &addressee)

Static Public Member Functions
static Field::List	allFields ()
static QString	categoryLabel (int category)
static Field *	createCustomField (const QString &label, int category, const QString &key, const QString &app)
static Field::List	defaultFields ()
static void	deleteFields ()
static Field::List	restoreFields (const KConfigGroup &cfg, const QString &identifier)
static Field::List	restoreFields (const QString &identifier)
static void	saveFields (const QString &identifier, const Field::List &fields)
static void	saveFields (KConfigGroup &cfg, const QString &identifier, const Field::List &fields)

Static Protected Member Functions
static void	createDefaultField (int id, int category=0)
static void	createField (int id, int category=0)

Detailed Description

Represents a field in the Addressbook.

This class represents a field in the Addressbook database. It provides methods for accessing meta-information about the field (such as label() or category()) as well as getting or setting the field's value in an instance of Addressee (value(), setValue()).

Furthermore, some static methods are provided for getting a list of all fields (allFields(), defaultFields()), for creating new fields (createCustomField()) and for saving or loading fields to/from a config file (saveFields(), restoreFields()).

Deprecated:

since 5.88, class is unused

Definition at line 38 of file field.h.

Member Typedef Documentation

List

typedef QList<Field *> KContacts::Field::List

This type is used for a list of fields.

Definition at line 44 of file field.h.

Member Enumeration Documentation

FieldCategory

enum KContacts::Field::FieldCategory

Represents the category a field belongs to.

Enumerator
All	All fields.
Frequent	Frequently used fields.
Address	Fields which belong to the address, such as Street, City, Zip, etc.
Email	Fields which store information about the e-mail contact, such as e-mail address or mail client.
Personal	Personal fields, such as Birthday, Home Address fields, IM Address, etc.
Organization	Fields about the organization, such as Business Address fields, Department, Profession, etc.
CustomCategory	Custom (user-defined) fields.

Definition at line 49 of file field.h.

Member Function Documentation

allFields()

Field::List Field::allFields ( )

static

Returns a list of all fields.

Definition at line 472 of file field.cpp.

category()

int Field::category ( )

virtual

Returns the ored categories the field belongs to.

Definition at line 210 of file field.cpp.

categoryLabel()

QString Field::categoryLabel ( int  category )

static

Returns the translated label for category.

Parameters

category

the category of type FieldCategory

Returns

the translated label

Definition at line 215 of file field.cpp.

createCustomField()

Field * Field::createCustomField ( const QString &  label, int  category, const QString &  key, const QString &  app  )

static

Creates a custom field.

Parameters

label	The label for this field
category	The category of this field
key	Unique key for this field
app	Unique app name for this field

Definition at line 632 of file field.cpp.

createDefaultField()

void Field::createDefaultField ( int  id, int  category = 0  )

staticprotected

Creates a field and appends it to the list of default fields.

Parameters

id	The identifier for the field
category	The optional category for the field

Definition at line 533 of file field.cpp.

createField()

void Field::createField ( int  id, int  category = 0  )

staticprotected

Creates a field and appends it to the general list of fields.

Parameters

id	The identifier for the field
category	The optional category for the field

Definition at line 528 of file field.cpp.

defaultFields()

Field::List Field::defaultFields ( )

static

Returns a list of the default fields.

Definition at line 518 of file field.cpp.

deleteFields()

void Field::deleteFields ( )

static

Delete all fields from list.

Definition at line 538 of file field.cpp.

equals()

bool Field::equals ( Field *  field )

virtual

Returns, if the field is equal with field.

Parameters

field

the field to compare this field to

Returns

true if the fields are equal, false otherwise

Definition at line 617 of file field.cpp.

isCustom()

bool Field::isCustom ( )

virtual

Returns, if the field is a user-defined field.

Returns

true if this is a custom field, false otherwise

Definition at line 467 of file field.cpp.

label()

QString Field::label ( )

virtual

Returns the translated label for this field.

Definition at line 124 of file field.cpp.

restoreFields() [1/2]

Field::List Field::restoreFields ( const KConfigGroup &  cfg, const QString &  identifier  )

static

Load the field settings from a config file.

Parameters

cfg	The config file object
identifier	The unique identifier

Definition at line 593 of file field.cpp.

restoreFields() [2/2]

Field::List Field::restoreFields ( const QString &  identifier )

static

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Here, the list is loaded from KSharedConfig::openConfig() from group "KABCFields".

Parameters

identifier

The unique identifier

Definition at line 586 of file field.cpp.

saveFields() [1/2]

void Field::saveFields ( const QString &  identifier, const Field::List &  fields  )

static

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Here, the list is stored in KSharedConfig::openConfig() in group "KABCFields".

Parameters

identifier	The unique identifier
fields	The list of the fields

Definition at line 558 of file field.cpp.

saveFields() [2/2]

void Field::saveFields ( KConfigGroup &  cfg, const QString &  identifier, const Field::List &  fields  )

static

Save the field settings to a config file.

Parameters

cfg	The config file object
identifier	The unique identifier
fields	The list of the fields

Definition at line 565 of file field.cpp.

setValue()

bool Field::setValue ( KContacts::Addressee &  addressee, const QString &  value  )

virtual

Sets the value of the field in the given Addressee.

Returns

true on success or false, if the given string couldn't be converted to a valid value.

Definition at line 373 of file field.cpp.

sortKey()

QString Field::sortKey

(

const KContacts::Addressee &

addressee

)

Returns a string, that can be used for sorting.

Definition at line 426 of file field.cpp.

value()

QString Field::value ( const KContacts::Addressee &  addressee )

virtual

Returns a string representation of the value the field has in the given Addressee.

Returns

the string representation of the value or QString(), if it is not possible to convert the value to a string.

Definition at line 237 of file field.cpp.

---

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

• field.h
• field.cpp