The QtDatePropertyManager provides and manages QDate properties. More...

#include <qtpropertymanager.h>

Public Slots
void	setMaximum (QtProperty *property, const QDate &maxVal)

void	setMinimum (QtProperty *property, const QDate &minVal)

void	setRange (QtProperty *property, const QDate &minVal, const QDate &maxVal)

void	setValue (QtProperty *property, const QDate &val)

Signals
void	rangeChanged (QtProperty *property, const QDate &minVal, const QDate &maxVal)

void	valueChanged (QtProperty *property, const QDate &val)

Signals inherited from QtAbstractPropertyManager
void	propertyChanged (QtProperty *property)

void	propertyDestroyed (QtProperty *property)

void	propertyInserted (QtProperty property, QtProperty parent, QtProperty *after)

void	propertyRemoved (QtProperty property, QtProperty parent)

Public Member Functions
QDate	maximum (const QtProperty *property) const

QDate	minimum (const QtProperty *property) const

	QtDatePropertyManager (QObject *parent=nullptr)

QDate	value (const QtProperty *property) const

	~QtDatePropertyManager () override

Public Member Functions inherited from QtAbstractPropertyManager
QtProperty *	addProperty (const QString &name=QString())

void	clear () const

QSet< QtProperty * >	properties () const

	QtAbstractPropertyManager (QObject *parent=nullptr)

	~QtAbstractPropertyManager () override

Protected Member Functions
void	initializeProperty (QtProperty *property) override

void	uninitializeProperty (QtProperty *property) override

QString	valueText (const QtProperty *property) const override

Protected Member Functions inherited from QtAbstractPropertyManager
virtual QtProperty *	createProperty ()

virtual QString	displayText (const QtProperty *property) const

virtual EchoMode	echoMode (const QtProperty *) const

virtual bool	hasValue (const QtProperty *property) const

virtual QIcon	valueIcon (const QtProperty *property) const

Private Attributes
QtDatePropertyManagerPrivate *	d_ptr

Detailed Description

The QtDatePropertyManager provides and manages QDate properties.

A date property has a current value, and a range specifying the valid dates. The range is defined by a minimum and a maximum value.

The property's values can be retrieved using the minimum(), maximum() and value() functions, and can be set using the setMinimum(), setMaximum() and setValue() slots. Alternatively, the range can be defined in one go using the setRange() slot.

In addition, QtDatePropertyManager provides the valueChanged() signal which is emitted whenever a property created by this manager changes, and the rangeChanged() signal which is emitted whenever such a property changes its range of valid dates.

See also: QtAbstractPropertyManager, QtDateEditFactory, QtDateTimePropertyManager

Constructor & Destructor Documentation

◆ QtDatePropertyManager()

QtDatePropertyManager::QtDatePropertyManager ( QObject * parent = nullptr )

Creates a manager with the given parent.

References d_ptr, QtDatePropertyManagerPrivate::m_format, and QtDatePropertyManagerPrivate::q_ptr.

◆ ~QtDatePropertyManager()

QtDatePropertyManager::~QtDatePropertyManager ( )

override

Destroys this manager, and all the properties it has created.

References QtAbstractPropertyManager::clear(), and d_ptr.

Member Function Documentation

◆ initializeProperty()

void QtDatePropertyManager::initializeProperty ( QtProperty * property )

overrideprotectedvirtual

Implements QtAbstractPropertyManager.

References d_ptr, and QtDatePropertyManagerPrivate::m_values.

◆ maximum()

QDate QtDatePropertyManager::maximum ( const QtProperty * property ) const

Returns the given property's maximum date.

See also: minimum(), setRange()

References d_ptr, and QtDatePropertyManagerPrivate::m_values.

Referenced by QtDateEditFactory::createEditor().

◆ minimum()

QDate QtDatePropertyManager::minimum ( const QtProperty * property ) const

Returns the given property's minimum date.

See also: maximum(), setRange()

References d_ptr, and QtDatePropertyManagerPrivate::m_values.

Referenced by QtDateEditFactory::createEditor().

◆ rangeChanged

void QtDatePropertyManager::rangeChanged	(	QtProperty *	property,
		const QDate &	minimum,
		const QDate &	maximum
	)

signal

This signal is emitted whenever a property created by this manager changes its range of valid dates, passing a pointer to the property and the new minimum and maximum dates.

See also: setRange()

Referenced by setMaximum(), setMinimum(), and setRange().

◆ setMaximum

void QtDatePropertyManager::setMaximum	(	QtProperty *	property,
		const QDate &	maxVal
	)

slot

Sets the maximum value for the given property to maxVal.

When setting the maximum value, the minimum and current values are adjusted if necessary (ensuring that the range remains valid and that the current value is within in the range).

See also: maximum(), setRange()

References d_ptr, QtAbstractPropertyManager::propertyChanged(), rangeChanged(), and valueChanged().

◆ setMinimum

void QtDatePropertyManager::setMinimum	(	QtProperty *	property,
		const QDate &	minVal
	)

slot

Sets the minimum value for the given property to minVal.

When setting the minimum value, the maximum and current values are adjusted if necessary (ensuring that the range remains valid and that the current value is within in the range).

See also: minimum(), setRange()

References d_ptr, QtAbstractPropertyManager::propertyChanged(), rangeChanged(), and valueChanged().

◆ setRange

void QtDatePropertyManager::setRange	(	QtProperty *	property,
		const QDate &	minimum,
		const QDate &	maximum
	)

slot

Sets the range of valid dates.

This is a convenience function defining the range of valid dates in one go; setting the minimum and maximum values for the given property with a single function call.

When setting a new date range, the current value is adjusted if necessary (ensuring that the value remains in date range).

See also: setMinimum(), setMaximum(), rangeChanged()

References d_ptr, QtAbstractPropertyManager::propertyChanged(), rangeChanged(), and valueChanged().

◆ setValue

void QtDatePropertyManager::setValue	(	QtProperty *	property,
		const QDate &	value
	)

slot

Sets the value of the given property to value.

If the specified value is not a valid date according to the given property's range, the value is adjusted to the nearest valid value within the range.

See also: value(), setRange(), valueChanged()

References d_ptr, QtAbstractPropertyManager::propertyChanged(), and valueChanged().

Referenced by QtDateEditFactoryPrivate::slotSetValue().

◆ uninitializeProperty()

void QtDatePropertyManager::uninitializeProperty ( QtProperty * property )

overrideprotectedvirtual

Reimplemented from QtAbstractPropertyManager.

References d_ptr, and QtDatePropertyManagerPrivate::m_values.

◆ value()

QDate QtDatePropertyManager::value ( const QtProperty * property ) const

Returns the given property's value.

If the given property is not managed by this manager, this function returns an invalid date.

See also: setValue()

References d_ptr, and QtDatePropertyManagerPrivate::m_values.

Referenced by QtDateEditFactory::createEditor(), and QtDateEditFactoryPrivate::slotRangeChanged().

◆ valueChanged

void QtDatePropertyManager::valueChanged	(	QtProperty *	property,
		const QDate &	value
	)

signal

This signal is emitted whenever a property created by this manager changes its value, passing a pointer to the property and the new value as parameters.