The QtEnumPropertyManager provides and manages enum properties. More...

#include <qtpropertymanager.h>

Inheritance diagram for QtEnumPropertyManager:

Collaboration diagram for QtEnumPropertyManager:

Public Slots
void	setEnumIcons (QtProperty *property, const QMap< int, QIcon > &icons)

void	setEnumNames (QtProperty *property, const QStringList &names)

void	setValue (QtProperty *property, int val)

Signals
void	enumIconsChanged (QtProperty *property, const QMap< int, QIcon > &icons)

void	enumNamesChanged (QtProperty *property, const QStringList &names)

void	valueChanged (QtProperty *property, int 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
QMap< int, QIcon >	enumIcons (const QtProperty *property) const

QStringList	enumNames (const QtProperty *property) const

	QtEnumPropertyManager (QObject *parent=nullptr)

int	value (const QtProperty *property) const

	~QtEnumPropertyManager () 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

QIcon	valueIcon (const QtProperty *property) const 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

Detailed Description

The QtEnumPropertyManager provides and manages enum properties.

Each enum property has an associated list of enum names which can be retrieved using the enumNames() function, and set using the corresponding setEnumNames() function. An enum property's value is represented by an index in this list, and can be retrieved and set using the value() and setValue() slots respectively.

Each enum value can also have an associated icon. The mapping from values to icons can be set using the setEnumIcons() function and queried with the enumIcons() function.

In addition, QtEnumPropertyManager provides the valueChanged() signal which is emitted whenever a property created by this manager changes. The enumNamesChanged() or enumIconsChanged() signal is emitted whenever the list of enum names or icons is altered.

See also: QtAbstractPropertyManager, QtEnumEditorFactory

Constructor & Destructor Documentation

◆ QtEnumPropertyManager()

QtEnumPropertyManager::QtEnumPropertyManager ( QObject * parent = nullptr )

Creates a manager with the given parent.

◆ ~QtEnumPropertyManager()

QtEnumPropertyManager::~QtEnumPropertyManager ( )

override

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

References QtAbstractPropertyManager::clear().

Here is the call graph for this function:

Member Function Documentation

◆ enumIcons()

QMap< int, QIcon > QtEnumPropertyManager::enumIcons ( const QtProperty * property ) const

Returns the given property's map of enum values to their icons.

See also: value(), setEnumIcons()

References QtEnumPropertyManagerPrivate::Data::enumIcons, and QtEnumPropertyManagerPrivate::m_values.

Referenced by QtEnumEditorFactory::createEditor(), setEnumIcons(), and QtEnumEditorFactoryPrivate::slotEnumNamesChanged().

Here is the caller graph for this function:

◆ enumIconsChanged

void QtEnumPropertyManager::enumIconsChanged	(	QtProperty *	property,
		const QMap< int, QIcon > &	icons
	)

signal

This signal is emitted whenever a property created by this manager changes its enum icons, passing a pointer to the property and the new mapping of values to icons as parameters.

See also: setEnumIcons()

Referenced by setEnumIcons().

Here is the caller graph for this function:

◆ enumNames()

QStringList QtEnumPropertyManager::enumNames ( const QtProperty * property ) const

Returns the given property's list of enum names.

See also: value(), setEnumNames()

References QtEnumPropertyManagerPrivate::Data::enumNames, and QtEnumPropertyManagerPrivate::m_values.

Referenced by QtEnumEditorFactory::createEditor(), setEnumNames(), and QtEnumEditorFactoryPrivate::slotEnumIconsChanged().

Here is the caller graph for this function:

◆ enumNamesChanged

void QtEnumPropertyManager::enumNamesChanged	(	QtProperty *	property,
		const QStringList &	names
	)

signal

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

See also: setEnumNames()

Referenced by setEnumNames().

Here is the caller graph for this function:

◆ initializeProperty()

void QtEnumPropertyManager::initializeProperty ( QtProperty * property )

overrideprotectedvirtual

\reimp

Implements QtAbstractPropertyManager.

References QtEnumPropertyManagerPrivate::m_values.

◆ setEnumIcons

void QtEnumPropertyManager::setEnumIcons	(	QtProperty *	property,
		const QMap< int, QIcon > &	enumIcons
	)

slot

Sets the given property's map of enum values to their icons to enumIcons.

Each enum value can have associated icon. This association is represented with passed enumIcons map.

See also: enumNames(), enumNamesChanged()

References enumIcons(), enumIconsChanged(), QtEnumPropertyManagerPrivate::m_values, and QtAbstractPropertyManager::propertyChanged().

Referenced by QtCursorEditorFactory::createEditor(), and main().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setEnumNames

void QtEnumPropertyManager::setEnumNames	(	QtProperty *	property,
		const QStringList &	enumNames
	)

slot

Sets the given property's list of enum names to enumNames. The property's current value is reset to 0 indicating the first item of the list.

If the specified enumNames list is empty, the property's current value is set to -1.

See also: enumNames(), enumNamesChanged()

References QtEnumPropertyManagerPrivate::Data::enumNames, enumNames(), enumNamesChanged(), QtEnumPropertyManagerPrivate::m_values, QtAbstractPropertyManager::propertyChanged(), QtEnumPropertyManagerPrivate::Data::val, and valueChanged().

Referenced by QtCursorEditorFactory::createEditor(), QtLocalePropertyManager::initializeProperty(), QtSizePolicyPropertyManager::initializeProperty(), QtFontPropertyManager::initializeProperty(), main(), QtLocalePropertyManager::setValue(), and QtFontPropertyManagerPrivate::slotFontDatabaseDelayedChange().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setValue

void QtEnumPropertyManager::setValue	(	QtProperty *	property,
		int	value
	)

slot

Sets the value of the given property to value.

The specified value must be less than the size of the given property's enumNames() list, and larger than (or equal to) 0.

See also: value(), valueChanged()

References QtEnumPropertyManagerPrivate::Data::enumNames, QtEnumPropertyManagerPrivate::m_values, QtAbstractPropertyManager::propertyChanged(), QtEnumPropertyManagerPrivate::Data::val, and valueChanged().

Referenced by QtCursorEditorFactory::createEditor(), QtLocalePropertyManager::initializeProperty(), QtSizePolicyPropertyManager::initializeProperty(), QtFontPropertyManager::initializeProperty(), QtFontPropertyManager::setValue(), QtLocalePropertyManager::setValue(), QtSizePolicyPropertyManager::setValue(), QtFontPropertyManagerPrivate::slotFontDatabaseDelayedChange(), QtCursorEditorFactoryPrivate::slotPropertyChanged(), and QtEnumEditorFactoryPrivate::slotSetValue().

Here is the caller graph for this function:

◆ uninitializeProperty()

void QtEnumPropertyManager::uninitializeProperty ( QtProperty * property )

overrideprotectedvirtual

\reimp

Reimplemented from QtAbstractPropertyManager.

References QtEnumPropertyManagerPrivate::m_values.

◆ value()

int QtEnumPropertyManager::value ( const QtProperty * property ) const

Returns the given property's value which is an index in the list returned by enumNames()

If the given property is not managed by this manager, this function returns -1.

See also: enumNames(), setValue()

References QtEnumPropertyManagerPrivate::m_values.

Referenced by QtEnumEditorFactory::createEditor(), QtLocalePropertyManagerPrivate::slotEnumChanged(), QtEnumEditorFactoryPrivate::slotEnumIconsChanged(), QtEnumEditorFactoryPrivate::slotEnumNamesChanged(), and QtFontPropertyManagerPrivate::slotFontDatabaseDelayedChange().

Here is the caller graph for this function:

◆ valueChanged

void QtEnumPropertyManager::valueChanged	(	QtProperty *	property,
		int	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.