itom  4.1.0
QtRectPropertyManager Class Reference

The QtRectPropertyManager provides and manages QRect properties. More...

Inheritance diagram for QtRectPropertyManager:
QtAbstractPropertyManager

Public Slots

void setValue (QtProperty *property, const QRect &val)
 
void setConstraint (QtProperty *property, const QRect &constraint)
 

Signals

void valueChanged (QtProperty *property, const QRect &val)
 
void constraintChanged (QtProperty *property, const QRect &constraint)
 
- Signals inherited from QtAbstractPropertyManager
void propertyInserted (QtProperty *property, QtProperty *parent, QtProperty *after)
 
void propertyChanged (QtProperty *property)
 
void propertyRemoved (QtProperty *property, QtProperty *parent)
 
void propertyDestroyed (QtProperty *property)
 

Public Member Functions

 QtRectPropertyManager (QObject *parent=0)
 
 ~QtRectPropertyManager ()
 
QtIntPropertyManagersubIntPropertyManager () const
 
QRect value (const QtProperty *property) const
 
QRect constraint (const QtProperty *property) const
 
- Public Member Functions inherited from QtAbstractPropertyManager
 QtAbstractPropertyManager (QObject *parent=0)
 
 ~QtAbstractPropertyManager ()
 
QSet< QtProperty * > properties () const
 
void clear () const
 
QtPropertyaddProperty (const QString &name=QString())
 

Protected Member Functions

QString valueText (const QtProperty *property) const
 
virtual void initializeProperty (QtProperty *property)
 
virtual void uninitializeProperty (QtProperty *property)
 
- Protected Member Functions inherited from QtAbstractPropertyManager
virtual bool hasValue (const QtProperty *property) const
 
virtual QIcon valueIcon (const QtProperty *property) const
 
virtual QString displayText (const QtProperty *property) const
 
virtual EchoMode echoMode (const QtProperty *) const
 
virtual QtPropertycreateProperty ()
 

Private Member Functions

 Q_PRIVATE_SLOT (d_func(), void slotIntChanged(QtProperty *, int)) Q_PRIVATE_SLOT(d_func()
 

Private Attributes

QtRectPropertyManagerPrivated_ptr
 

Detailed Description

The QtRectPropertyManager provides and manages QRect 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 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 rectangle property also has a constraint rectangle which can be retrieved using the constraint() function, and set using the setConstraint() slot.

In addition, QtRectPropertyManager 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, QtIntPropertyManager, QtRectFPropertyManager

Constructor & Destructor Documentation

QtRectPropertyManager::QtRectPropertyManager ( QObject *  parent = 0)

Creates a manager with the given parent.

QtRectPropertyManager::~QtRectPropertyManager ( )

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

Member Function Documentation

QRect QtRectPropertyManager::constraint ( const QtProperty property) const

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

See also
value(), setConstraint()
void QtRectPropertyManager::constraintChanged ( QtProperty property,
const QRect &  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()
void QtRectPropertyManager::initializeProperty ( QtProperty property)
protectedvirtual
void QtRectPropertyManager::setConstraint ( QtProperty property,
const QRect &  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 QRect value.

See also
setValue(), constraint(), constraintChanged()
void QtRectPropertyManager::setValue ( QtProperty property,
const QRect &  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()
QtIntPropertyManager * QtRectPropertyManager::subIntPropertyManager ( ) 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()
void QtRectPropertyManager::uninitializeProperty ( QtProperty property)
protectedvirtual

Reimplemented from QtAbstractPropertyManager.

QRect QtRectPropertyManager::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()
void QtRectPropertyManager::valueChanged ( QtProperty property,
const QRect &  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()
QString QtRectPropertyManager::valueText ( const QtProperty property) const
protectedvirtual

Reimplemented from QtAbstractPropertyManager.


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