The QtSizePropertyManager provides and manages QSize properties. More...

#include <qtpropertymanager.h>

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

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

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

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

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

void	valueChanged (QtProperty *property, const QSize &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
QSize	maximum (const QtProperty *property) const

QSize	minimum (const QtProperty *property) const

	QtSizePropertyManager (QObject *parent=nullptr)

QtIntPropertyManager *	subIntPropertyManager () const

QSize	value (const QtProperty *property) const

	~QtSizePropertyManager () 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 Member Functions
	Q_PRIVATE_SLOT (d_func(), void slotIntChanged(QtProperty *, int)) Q_PRIVATE_SLOT(d_func()

Private Attributes
QtSizePropertyManagerPrivate *	d_ptr

Detailed Description

The QtSizePropertyManager provides and manages QSize properties.

A size property has nested width and height subproperties. The top-level property's value can be retrieved using the value() function, and set using the setValue() slot.

The subproperties are created by a QtIntPropertyManager object. This manager can be retrieved using the subIntPropertyManager() function. In order to provide editing widgets for the subproperties in a property browser widget, this manager must be associated with an editor factory.

A size property also has a range of valid values defined by a minimum size and a maximum size. These sizes can be retrieved using the minimum() and the maximum() functions, and set using the setMinimum() and setMaximum() slots. Alternatively, the range can be defined in one go using the setRange() slot.

In addition, QtSizePropertyManager 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 sizes.

See also: QtAbstractPropertyManager, QtIntPropertyManager, QtSizeFPropertyManager

Constructor & Destructor Documentation

◆ QtSizePropertyManager()

QtSizePropertyManager::QtSizePropertyManager ( QObject * parent = nullptr )

Creates a manager with the given parent.

References d_ptr, QtSizePropertyManagerPrivate::m_intPropertyManager, QtAbstractPropertyManager::propertyDestroyed(), QtSizePropertyManagerPrivate::q_ptr, and valueChanged().

◆ ~QtSizePropertyManager()

QtSizePropertyManager::~QtSizePropertyManager ( )

override

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

References QtAbstractPropertyManager::clear(), and d_ptr.

Member Function Documentation

◆ initializeProperty()

void QtSizePropertyManager::initializeProperty ( QtProperty * property )

overrideprotectedvirtual

Implements QtAbstractPropertyManager.

References QtAbstractPropertyManager::addProperty(), QtProperty::addSubProperty(), d_ptr, QtSizePropertyManagerPrivate::m_hToProperty, QtSizePropertyManagerPrivate::m_intPropertyManager, QtSizePropertyManagerPrivate::m_propertyToH, QtSizePropertyManagerPrivate::m_propertyToW, QtSizePropertyManagerPrivate::m_values, QtSizePropertyManagerPrivate::m_wToProperty, QtIntPropertyManager::setMinimum(), QtProperty::setPropertyName(), and QtIntPropertyManager::setValue().

◆ maximum()

QSize QtSizePropertyManager::maximum ( const QtProperty * property ) const

Returns the given property's maximum size value.

See also: setMaximum(), minimum(), setRange()

References d_ptr, and QtSizePropertyManagerPrivate::m_values.

◆ minimum()

QSize QtSizePropertyManager::minimum ( const QtProperty * property ) const

Returns the given property's minimum size value.

See also: setMinimum(), maximum(), setRange()

References d_ptr, and QtSizePropertyManagerPrivate::m_values.

◆ Q_PRIVATE_SLOT()

QtSizePropertyManager::Q_PRIVATE_SLOT	(	d_func()	,
		void	slotIntChangedQtProperty *, int
	)

private

◆ rangeChanged

void QtSizePropertyManager::rangeChanged	(	QtProperty *	property,
		const QSize &	minimum,
		const QSize &	maximum
	)

signal

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

See also: setRange()

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

◆ setMaximum

void QtSizePropertyManager::setMaximum	(	QtProperty *	property,
		const QSize &	maxVal
	)

slot

Sets the maximum size value for the given property to maxVal.

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

See also: maximum(), setRange(), rangeChanged()

References d_ptr, QtSizePropertyManagerPrivate::Data::maximumValue(), QtAbstractPropertyManager::propertyChanged(), rangeChanged(), QtSizePropertyManagerPrivate::Data::setMaximumValue(), QtSizePropertyManagerPrivate::setRange(), and valueChanged().

◆ setMinimum

void QtSizePropertyManager::setMinimum	(	QtProperty *	property,
		const QSize &	minVal
	)

slot

Sets the minimum size value for the given property to minVal.

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

See also: minimum(), setRange(), rangeChanged()

References d_ptr, QtSizePropertyManagerPrivate::Data::minimumValue(), QtAbstractPropertyManager::propertyChanged(), rangeChanged(), QtSizePropertyManagerPrivate::Data::setMinimumValue(), QtSizePropertyManagerPrivate::setRange(), and valueChanged().

◆ setRange

void QtSizePropertyManager::setRange	(	QtProperty *	property,
		const QSize &	minimum,
		const QSize &	maximum
	)

slot

Sets the range of valid values.

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

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

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

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

Referenced by MainWindow::itemClicked().

◆ setValue

void QtSizePropertyManager::setValue	(	QtProperty *	property,
		const QSize &	value
	)

slot

Sets the value of the given property to value.

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

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

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

Referenced by MainWindow::itemClicked().

◆ subIntPropertyManager()

QtIntPropertyManager * QtSizePropertyManager::subIntPropertyManager ( ) const

Returns the manager that creates the nested width and height subproperties.

In order to provide editing widgets for the width and height properties in a property browser widget, this manager must be associated with an editor factory.

See also: QtAbstractPropertyBrowser::setFactoryForManager()

References d_ptr, and QtSizePropertyManagerPrivate::m_intPropertyManager.

Referenced by main(), and MainWindow::MainWindow().

◆ uninitializeProperty()

void QtSizePropertyManager::uninitializeProperty ( QtProperty * property )

overrideprotectedvirtual

Reimplemented from QtAbstractPropertyManager.

References d_ptr, QtSizePropertyManagerPrivate::m_hToProperty, QtSizePropertyManagerPrivate::m_propertyToH, QtSizePropertyManagerPrivate::m_propertyToW, QtSizePropertyManagerPrivate::m_values, and QtSizePropertyManagerPrivate::m_wToProperty.

◆ value()

QSize QtSizePropertyManager::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 size

See also: setValue()

References d_ptr, and QtSizePropertyManagerPrivate::m_values.

◆ valueChanged

void QtSizePropertyManager::valueChanged	(	QtProperty *	property,
		const QSize &	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.

See also: setValue()

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

◆ valueText()

QString QtSizePropertyManager::valueText ( const QtProperty * property ) const

overrideprotectedvirtual

Reimplemented from QtAbstractPropertyManager.

References d_ptr, and QtSizePropertyManagerPrivate::m_values.

Member Data Documentation

◆ d_ptr

QtSizePropertyManagerPrivate* QtSizePropertyManager::d_ptr

private

Referenced by initializeProperty(), maximum(), minimum(), QtSizePropertyManager(), setMaximum(), setMinimum(), setRange(), setValue(), subIntPropertyManager(), uninitializeProperty(), value(), valueText(), and ~QtSizePropertyManager().

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

Public Slots

Signals

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ QtSizePropertyManager()

◆ ~QtSizePropertyManager()

Member Function Documentation

◆ initializeProperty()

◆ maximum()

◆ minimum()

◆ Q_PRIVATE_SLOT()

◆ rangeChanged

◆ setMaximum

◆ setMinimum

◆ setRange

◆ setValue

◆ subIntPropertyManager()

◆ uninitializeProperty()

◆ value()

◆ valueChanged

◆ valueText()

Member Data Documentation

◆ d_ptr