QtRectFPropertyManager Class Reference

The QtRectFPropertyManager provides and manages QRectF properties. More...

#include <qtpropertymanager.h>

Inherits QtAbstractPropertyManager.

Public Slots
void	setConstraint (QtProperty *property, const QRectF &constraint)
void	setDecimals (QtProperty *property, int prec)
void	setValue (QtProperty *property, const QRectF &val)

Signals
void	constraintChanged (QtProperty *property, const QRectF &constraint)
void	decimalsChanged (QtProperty *property, int prec)
void	valueChanged (QtProperty *property, const QRectF &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
QRectF	constraint (const QtProperty *property) const
int	decimals (const QtProperty *property) const
	QtRectFPropertyManager (QObject *parent=nullptr)
QtDoublePropertyManager *	subDoublePropertyManager () const
QRectF	value (const QtProperty *property) const
	~QtRectFPropertyManager () 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 slotDoubleChanged(QtProperty *, double)) Q_PRIVATE_SLOT(d_func()

Private Attributes
QtRectFPropertyManagerPrivate *	d_ptr

Detailed Description

The QtRectFPropertyManager provides and manages QRectF properties.

A rectangle property has nested x, y, 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 QtDoublePropertyManager object. This manager can be retrieved using the subDoublePropertyManager() 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 rectangle property also has a constraint rectangle which can be retrieved using the constraint() function, and set using the setConstraint() slot.

In addition, QtRectFPropertyManager provides the valueChanged() signal which is emitted whenever a property created by this manager changes, and the constraintChanged() signal which is emitted whenever such a property changes its constraint rectangle.

See also

QtAbstractPropertyManager, QtDoublePropertyManager, QtRectPropertyManager

Constructor & Destructor Documentation

QtRectFPropertyManager()

QtRectFPropertyManager::QtRectFPropertyManager

(

QObject *

parent = nullptr

)

Creates a manager with the given parent.

References d_ptr, QtRectFPropertyManagerPrivate::m_doublePropertyManager, QtAbstractPropertyManager::propertyDestroyed(), QtRectFPropertyManagerPrivate::q_ptr, and valueChanged().

~QtRectFPropertyManager()

QtRectFPropertyManager::~QtRectFPropertyManager ( )

override

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

References QtAbstractPropertyManager::clear(), and d_ptr.

Member Function Documentation

constraint()

QRectF QtRectFPropertyManager::constraint

(

const QtProperty *

property

)

const

Returns the given property's constraining rectangle. If returned value is null QRectF it means there is no constraint applied.

See also

value(), setConstraint()

References QtRectFPropertyManagerPrivate::Data::constraint, d_ptr, and QtRectFPropertyManagerPrivate::m_values.

constraintChanged

void QtRectFPropertyManager::constraintChanged ( QtProperty *  property, const QRectF &  constraint  )

signal

This signal is emitted whenever property changes its constraint rectangle, passing a pointer to the property and the new constraint rectangle as parameters.

See also

setConstraint()

Referenced by setConstraint().

decimals()

int QtRectFPropertyManager::decimals

(

const QtProperty *

property

)

const

Returns the given property's precision, in decimals.

See also

setDecimals()

References d_ptr, QtRectFPropertyManagerPrivate::Data::decimals, and QtRectFPropertyManagerPrivate::m_values.

Referenced by initializeProperty().

decimalsChanged

void QtRectFPropertyManager::decimalsChanged ( QtProperty *  property, int  prec  )

signal

This signal is emitted whenever a property created by this manager changes its precision of value, passing a pointer to the property and the new prec value

See also

setDecimals()

Referenced by setDecimals().

initializeProperty()

void QtRectFPropertyManager::initializeProperty ( QtProperty *  property )

overrideprotectedvirtual

Implements QtAbstractPropertyManager.

References QtAbstractPropertyManager::addProperty(), QtProperty::addSubProperty(), d_ptr, decimals(), QtRectFPropertyManagerPrivate::m_doublePropertyManager, QtRectFPropertyManagerPrivate::m_hToProperty, QtRectFPropertyManagerPrivate::m_propertyToH, QtRectFPropertyManagerPrivate::m_propertyToW, QtRectFPropertyManagerPrivate::m_propertyToX, QtRectFPropertyManagerPrivate::m_propertyToY, QtRectFPropertyManagerPrivate::m_values, QtRectFPropertyManagerPrivate::m_wToProperty, QtRectFPropertyManagerPrivate::m_xToProperty, QtRectFPropertyManagerPrivate::m_yToProperty, QtDoublePropertyManager::setDecimals(), QtDoublePropertyManager::setMinimum(), QtProperty::setPropertyName(), and QtDoublePropertyManager::setValue().

Q_PRIVATE_SLOT()

QtRectFPropertyManager::Q_PRIVATE_SLOT ( d_func()  , void   slotDoubleChangedQtProperty *, double  )

private

setConstraint

void QtRectFPropertyManager::setConstraint ( QtProperty *  property, const QRectF &  constraint  )

slot

Sets the given property's constraining rectangle to constraint.

When setting the constraint, the current value is adjusted if necessary (ensuring that the current rectangle value is inside the constraint). In order to reset the constraint pass a null QRectF value.

See also

setValue(), constraint(), constraintChanged()

References QtRectFPropertyManagerPrivate::Data::constraint, constraintChanged(), d_ptr, QtRectFPropertyManagerPrivate::m_values, QtAbstractPropertyManager::propertyChanged(), QtRectFPropertyManagerPrivate::setConstraint(), QtRectFPropertyManagerPrivate::Data::val, and valueChanged().

setDecimals

void QtRectFPropertyManager::setDecimals ( QtProperty *  property, int  prec  )

slot

Sets the precision of the given property to prec.

The valid decimal range is 0-13. The default is 2.

See also

decimals()

References d_ptr, QtRectFPropertyManagerPrivate::Data::decimals, decimalsChanged(), QtRectFPropertyManagerPrivate::m_doublePropertyManager, QtRectFPropertyManagerPrivate::m_propertyToH, QtRectFPropertyManagerPrivate::m_propertyToW, QtRectFPropertyManagerPrivate::m_propertyToX, QtRectFPropertyManagerPrivate::m_propertyToY, QtRectFPropertyManagerPrivate::m_values, and QtDoublePropertyManager::setDecimals().

setValue

void QtRectFPropertyManager::setValue ( QtProperty *  property, const QRectF &  value  )

slot

Sets the value of the given property to value. Nested properties are updated automatically.

If the specified value is not inside the given property's constraining rectangle, the value is adjusted accordingly to fit within the constraint.

See also

value(), setConstraint(), valueChanged()

References QtRectFPropertyManagerPrivate::Data::constraint, d_ptr, QtRectFPropertyManagerPrivate::m_doublePropertyManager, QtRectFPropertyManagerPrivate::m_propertyToH, QtRectFPropertyManagerPrivate::m_propertyToW, QtRectFPropertyManagerPrivate::m_propertyToX, QtRectFPropertyManagerPrivate::m_propertyToY, QtRectFPropertyManagerPrivate::m_values, QtAbstractPropertyManager::propertyChanged(), QtDoublePropertyManager::setValue(), QtRectFPropertyManagerPrivate::Data::val, and valueChanged().

subDoublePropertyManager()

QtDoublePropertyManager * QtRectFPropertyManager::subDoublePropertyManager

(

)

const

Returns the manager that creates the nested x, y, width and height subproperties.

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

See also

QtAbstractPropertyBrowser::setFactoryForManager()

References d_ptr, and QtRectFPropertyManagerPrivate::m_doublePropertyManager.

uninitializeProperty()

void QtRectFPropertyManager::uninitializeProperty ( QtProperty *  property )

overrideprotectedvirtual

Reimplemented from QtAbstractPropertyManager.

References d_ptr, QtRectFPropertyManagerPrivate::m_hToProperty, QtRectFPropertyManagerPrivate::m_propertyToH, QtRectFPropertyManagerPrivate::m_propertyToW, QtRectFPropertyManagerPrivate::m_propertyToX, QtRectFPropertyManagerPrivate::m_propertyToY, QtRectFPropertyManagerPrivate::m_values, QtRectFPropertyManagerPrivate::m_wToProperty, QtRectFPropertyManagerPrivate::m_xToProperty, and QtRectFPropertyManagerPrivate::m_yToProperty.

value()

QRectF QtRectFPropertyManager::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 rectangle.

See also

setValue(), constraint()

References d_ptr, and QtRectFPropertyManagerPrivate::m_values.

valueChanged

void QtRectFPropertyManager::valueChanged ( QtProperty *  property, const QRectF &  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 QtRectFPropertyManager(), setConstraint(), and setValue().

valueText()

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

overrideprotectedvirtual

Reimplemented from QtAbstractPropertyManager.

References d_ptr, and QtRectFPropertyManagerPrivate::m_values.

Member Data Documentation

d_ptr

QtRectFPropertyManagerPrivate* QtRectFPropertyManager::d_ptr

private

Referenced by constraint(), decimals(), initializeProperty(), QtRectFPropertyManager(), setConstraint(), setDecimals(), setValue(), subDoublePropertyManager(), uninitializeProperty(), value(), valueText(), and ~QtRectFPropertyManager().

---

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

• qtpropertymanager.h
• qtpropertymanager.cpp