KConfig 5.109.0
Public Member Functions | List of all members
KCoreConfigSkeleton::ItemDateTime

Class for handling a QDateTime preferences item. More...

#include <kcoreconfigskeleton.h>

Public Member Functions

 ItemDateTime (const QString &_group, const QString &_key, QDateTime &reference, const QDateTime &defaultValue=QDateTime())
 Constructor.
 
bool isEqual (const QVariant &p) const override
 Check whether the item is equal to p.
 
QVariant property () const override
 Return item as property.
 
void readConfig (KConfig *config) override
 This function is called by KCoreConfigSkeleton to read the value for this setting from a config file.
 
void setProperty (const QVariant &p) override
 Set item to p.
 
- Public Member Functions inherited from KConfigSkeletonGenericItem< QDateTime >
 KConfigSkeletonGenericItem (const QString &_group, const QString &_key, QDateTime &reference, QDateTime defaultValue)
 Constructor.
 
void readDefault (KConfig *config) override
 Read global default value.
 
void setDefault () override
 Set the value for this item to the default value.
 
virtual void setDefaultValue (const QDateTime &v)
 Set default value for this item.
 
void setValue (const QDateTime &v)
 Set value of this KConfigSkeletonItem.
 
void swapDefault () override
 Exchanges the current value with the default value Used by KCoreConfigSkeleton::useDefaults(bool);.
 
QDateTime & value ()
 Return value of this KConfigSkeletonItem.
 
const QDateTime & value () const
 Return const value of this KConfigSkeletonItem.
 
void writeConfig (KConfig *config) override
 This function is called by KCoreConfigSkeleton to write the value of this setting to a config file.
 
- Public Member Functions inherited from KConfigSkeletonItem
 KConfigSkeletonItem (const QString &_group, const QString &_key)
 Constructor.
 
virtual ~KConfigSkeletonItem ()
 Destructor.
 
KConfigGroup configGroup (KConfig *config) const
 Return a KConfigGroup, the one provided by setGroup(const KConfigGroup&) if it's valid, or make one from config and item's group.
 
QVariant getDefault () const
 Returns the default value.
 
QString group () const
 Return name of config file group.
 
bool isDefault () const
 Indicates if the item is set to its default value.
 
virtual bool isEqual (const QVariant &p) const =0
 Check whether the item is equal to p.
 
bool isImmutable () const
 Return if the entry can be modified.
 
bool isSaveNeeded () const
 Indicates if the item has a different value than the previously loaded value.
 
QString key () const
 Return config file key.
 
QString label () const
 Return the label of the item.
 
virtual QVariant maxValue () const
 Return maximum value of item or invalid if not specified.
 
virtual QVariant minValue () const
 Return minimum value of item or invalid if not specified.
 
QString name () const
 Return internal name of entry.
 
virtual QVariant property () const =0
 Return item as property.
 
virtual void readConfig (KConfig *)=0
 This function is called by KCoreConfigSkeleton to read the value for this setting from a config file.
 
virtual void readDefault (KConfig *)=0
 Read global default value.
 
virtual void setDefault ()=0
 Sets the current value to the default value.
 
void setGroup (const KConfigGroup &cg)
 Set config file group but giving the KConfigGroup.
 
void setGroup (const QString &_group)
 Set config file group.
 
void setKey (const QString &_key)
 Set config file key.
 
void setLabel (const QString &l)
 Set label providing a translated one-line description of the item.
 
void setName (const QString &_name)
 Set internal name of entry.
 
virtual void setProperty (const QVariant &p)=0
 Set item to p.
 
void setToolTip (const QString &t)
 Set ToolTip description of item.
 
void setWhatsThis (const QString &w)
 Set WhatsThis description of item.
 
void setWriteFlags (KConfigBase::WriteConfigFlags flags)
 The write flags to be used when writing configuration.
 
virtual void swapDefault ()=0
 Exchanges the current value with the default value Used by KCoreConfigSkeleton::useDefaults(bool);.
 
QString toolTip () const
 Return ToolTip description of item.
 
QString whatsThis () const
 Return WhatsThis description of item.
 
virtual void writeConfig (KConfig *)=0
 This function is called by KCoreConfigSkeleton to write the value of this setting to a config file.
 
KConfigBase::WriteConfigFlags writeFlags () const
 Return write flags to be used when writing configuration.
 

Additional Inherited Members

- Public Types inherited from KConfigSkeletonItem
typedef QHash< QString, KConfigSkeletonItem * > Dict
 
typedef QHash< QString, KConfigSkeletonItem * >::Iterator DictIterator
 
typedef QList< KConfigSkeletonItem * > List
 
- Protected Member Functions inherited from KConfigSkeletonItem
 __attribute__ ((visibility("hidden"))) explicit KConfigSkeletonItem(KConfigSkeletonItemPrivate &dd
 
void readImmutability (const KConfigGroup &group)
 Sets mIsImmutable to true if mKey in config is immutable.
 
void setGetDefaultImpl (const std::function< QVariant()> &impl)
 
void setIsDefaultImpl (const std::function< bool()> &impl)
 
void setIsSaveNeededImpl (const std::function< bool()> &impl)
 
- Protected Attributes inherited from KConfigSkeletonGenericItem< QDateTime >
QDateTime mDefault
 The default value for this item.
 
QDateTime mLoadedValue
 
QDateTime & mReference
 Stores the value for this item.
 
- Protected Attributes inherited from KConfigSkeletonItem
const QString & _group
 
const QString const QString & _key
 
KConfigSkeletonItemPrivate *const d_ptr
 
QString mGroup
 The group name for this item.
 
QString mKey
 The config key for this item.
 
QString mName
 The name of this item.
 

Detailed Description

Class for handling a QDateTime preferences item.

Constructor & Destructor Documentation

◆ ItemDateTime()

KCoreConfigSkeleton::ItemDateTime::ItemDateTime ( const QString &  _group,
const QString &  _key,
QDateTime &  reference,
const QDateTime &  defaultValue = QDateTime() 
)

Constructor.

Parameters
_groupConfig file group.
_keyConfig file key.
referenceThe initial value to hold in the item
defaultValueThe default value for the item

Member Function Documentation

◆ isEqual()

bool KCoreConfigSkeleton::ItemDateTime::isEqual ( const QVariant &  p) const
overridevirtual

Check whether the item is equal to p.

Use this function to compare items that use custom types, because QVariant::operator== will not work for those.

Parameters
pQVariant to compare to
Returns
true if the item is equal to p, false otherwise

Implements KConfigSkeletonItem.

◆ property()

QVariant KCoreConfigSkeleton::ItemDateTime::property ( ) const
overridevirtual

Return item as property.

Implements KConfigSkeletonItem.

◆ readConfig()

void KCoreConfigSkeleton::ItemDateTime::readConfig ( KConfig config)
overridevirtual

This function is called by KCoreConfigSkeleton to read the value for this setting from a config file.

Implements KConfigSkeletonItem.

◆ setProperty()

void KCoreConfigSkeleton::ItemDateTime::setProperty ( const QVariant &  p)
overridevirtual

Set item to p.

Implements KConfigSkeletonItem.