Digikam::AssignNameWidgetStates Class Reference

Inheritance diagram for Digikam::AssignNameWidgetStates:

Public Types
enum	IncludeFadingOutMode { IncludeFadingOut , ExcludeFadingOut }
enum	State { Hidden , FadingIn , Visible , FadingOut }

Public Slots
void	changeValue (const QVariant &value)
void	hide ()
void	hideAndRemoveItem (QObject *item)
void	hideItem (QObject *item)
void	setDirectlyVisible (bool visible)
void	setItemDirectlyVisible (QObject *item, bool visible)
void	setItemThatShallBeShown (QObject *item)
void	setItemVisible (QObject *item, bool visible)
void	setShallBeShown (bool shallBeShown)
void	setShallBeShownDirectly (bool shallBeShown)
void	setVisible (bool visible)
void	show ()
void	showItem (QObject *item)

Signals
void	finished ()
void	hiddenAndRemoved (QObject *item)
void	propertiesAssigned (bool visible)
void	propertiesAssigned (QObject *item, bool visible)
void	stateChanged ()

Public Member Functions
void	addItem (QObject *object)
	AssignNameWidgetStates (FaceItem *const item)
void	clear ()
bool	hasVisibleItems (IncludeFadingOutMode mode=IncludeFadingOut) const
bool	isVisible () const
QList< QObject * >	items () const
void	removeItem (QObject *object)
void	setAnimationDuration (int msecs)
void	setEasingCurve (const QEasingCurve &easing)
void	setPropertyName (const QByteArray &propertyName)
void	setTargetObject (QObject *const object)
bool	shallBeShown () const
State	state () const
QList< QObject * >	visibleItems (IncludeFadingOutMode mode=IncludeFadingOut) const
	~AssignNameWidgetStates () override

Protected Slots
void	animationFinished ()
void	objectDestroyed (QObject *)
void	slotPropertiesAssigned (bool)
void	slotStateChanged ()

Protected Member Functions
virtual QPropertyAnimation *	createAnimation (QObject *item)

Protected Attributes
QObject *	m_object
QByteArray	m_property
QVariant	m_value

Properties
bool	shallBeShown
bool	visible

Member Enumeration Documentation

IncludeFadingOutMode

enum Digikam::ItemVisibilityController::IncludeFadingOutMode

inherited

Enumerator
IncludeFadingOut	In addition to items visible or fading in, return those fading out.
ExcludeFadingOut	Do not return those items currently fading out (soon to be hidden)

State

enum Digikam::ItemVisibilityController::State

inherited

This class handles complex visibility situations for items. There is a 3-tiered approach: 1) shallBeShown determines if the items shall at any time be shown. If it is false, items will never be shown. Default is true, so you can ignore this setting. 2) visible determines if the items shall be shown now. Only takes effect if shallBeShown is true. Default is false: Initially, controlled items are hidden. 3) Opacity and individual item visibility: When showing, items are first set to individually visible, then their opacity is increased from 0 to 1. When hiding, opacity is first decreased from 1 to 0, then they are set individually to hidden. Different types of items can be handled:

• a group of items with an "opacity" and "visible" property
• a single item with an "opacity" and "visible" property
• a proxy object with these properties (see above)

Enumerator
Hidden
FadingIn
Visible
FadingOut

Constructor & Destructor Documentation

AssignNameWidgetStates()

Digikam::AssignNameWidgetStates::AssignNameWidgetStates ( FaceItem *const  item )

explicit

References Digikam::ItemVisibilityController::addItem(), Digikam::RegionFrameItem::hudWidget(), slotStateChanged(), and Digikam::HidingStateChanger::stateChanged().

~AssignNameWidgetStates()

Digikam::AssignNameWidgetStates::~AssignNameWidgetStates ( )

override

Member Function Documentation

addItem()

void Digikam::ItemVisibilityController::addItem ( QObject *  object )

inherited

Add and remove objects. The given objects shall provide an "opacity" and a "visible" property. You can, for convenience, use a ItemVisibilityControllerPropertyObject as a value container, if your items do not provide these properties directly. No ownership is taken, so the objects should live as long as this object is used.

References Digikam::ItemVisibilityController::createAnimation().

Referenced by Digikam::AnimatedVisibility::AnimatedVisibility(), AssignNameWidgetStates(), Digikam::FaceGroup::slotAddItemMoving(), and Digikam::FocusPointGroup::slotAddItemMoving().

animationFinished

void Digikam::ItemVisibilityController::animationFinished ( )

protectedslotinherited

References Digikam::ItemVisibilityController::propertiesAssigned(), and Digikam::ItemVisibilityController::Visible.

changeValue

void Digikam::HidingStateChanger::changeValue ( const QVariant &  value )

slotinherited

References Digikam::ItemVisibilityController::hasVisibleItems(), Digikam::ItemVisibilityController::hide(), Digikam::HidingStateChanger::m_value, Digikam::HidingStateChanger::slotPropertiesAssigned(), and value.

Referenced by Digikam::FaceItem::switchMode().

clear()

void Digikam::ItemVisibilityController::clear ( )

inherited

Remove all animations

Referenced by Digikam::FaceGroup::clear(), Digikam::FocusPointGroup::clear(), Digikam::FaceGroup::load(), Digikam::FocusPointGroup::load(), and Digikam::ItemVisibilityController::~ItemVisibilityController().

createAnimation()

QPropertyAnimation * Digikam::ItemVisibilityController::createAnimation ( QObject *  item )

protectedvirtualinherited

Creates the animation for showing and hiding the given item. The item is given for information only, you do not need to use it. The default implementation creates and animation for "opacity" from 0.0 to 1.0, using default easing curve and duration, which can and will be changed by setEasingCurve and setAnimationDuration.

Referenced by Digikam::ItemVisibilityController::addItem().

finished

void Digikam::HidingStateChanger::finished ( )

signalinherited

Emitted when the items were hidden, the target object's property changed, and the items shown again

Referenced by Digikam::HidingStateChanger::slotPropertiesAssigned().

hasVisibleItems()

bool Digikam::ItemVisibilityController::hasVisibleItems ( IncludeFadingOutMode  mode = IncludeFadingOut ) const

inherited

This returns the "result" of isVisible and shallBeShown: Something is indeed visible on the scene. Also returns false if no items are available.

Referenced by Digikam::HidingStateChanger::changeValue(), Digikam::FaceGroup::hasVisibleItems(), and Digikam::FocusPointGroup::hasVisibleItems().

hiddenAndRemoved

void Digikam::ItemVisibilityController::hiddenAndRemoved ( QObject *  item )

signalinherited

Emitted when hideAndRemoveItem has finished

hide

void Digikam::ItemVisibilityController::hide ( )

slotinherited

References Digikam::ItemVisibilityController::setVisible().

Referenced by Digikam::HidingStateChanger::changeValue(), Digikam::FaceGroup::itemStateChanged(), and Digikam::FocusPointGroup::itemStateChanged().

hideAndRemoveItem

void Digikam::ItemVisibilityController::hideAndRemoveItem ( QObject *  item )

slotinherited

Hide the item, and then remove it. When finished, hiddenAndRemoved() is emitted.

Referenced by Digikam::FaceGroup::slotRejected().

hideItem

void Digikam::ItemVisibilityController::hideItem ( QObject *  item )

slotinherited

References Digikam::ItemVisibilityController::setItemVisible().

isVisible()

bool Digikam::ItemVisibilityController::isVisible ( ) const

inherited

items()

QList< QObject * > Digikam::ItemVisibilityController::items ( ) const

inherited

Returns all items under control

Referenced by Digikam::ItemVisibilityController::visibleItems().

objectDestroyed

void Digikam::ItemVisibilityController::objectDestroyed ( QObject *  item )

protectedslotinherited

References Digikam::ItemVisibilityController::removeItem().

propertiesAssigned [1/2]

void Digikam::ItemVisibilityController::propertiesAssigned ( bool  visible )

signalinherited

Emitted when the (main) transition has finished

Referenced by Digikam::ItemVisibilityController::animationFinished(), and Digikam::HidingStateChanger::HidingStateChanger().

propertiesAssigned [2/2]

void Digikam::ItemVisibilityController::propertiesAssigned ( QObject *  item, bool  visible  )

signalinherited

Emitted when a transition for a single item finished (see setItemVisible())

removeItem()

void Digikam::ItemVisibilityController::removeItem ( QObject *  object )

inherited

Referenced by Digikam::ItemVisibilityController::objectDestroyed().

setAnimationDuration()

void Digikam::ItemVisibilityController::setAnimationDuration ( int  msecs )

inherited

setDirectlyVisible

void Digikam::ItemVisibilityController::setDirectlyVisible ( bool  visible )

slotinherited

References Digikam::ItemVisibilityController::visible.

Referenced by Digikam::ItemVisibilityController::setShallBeShownDirectly().

setEasingCurve()

void Digikam::ItemVisibilityController::setEasingCurve ( const QEasingCurve &  easing )

inherited

Allows to change the default parameters of all animations.

setItemDirectlyVisible

void Digikam::ItemVisibilityController::setItemDirectlyVisible ( QObject *  item, bool  visible  )

slotinherited

References Digikam::ItemVisibilityController::visible.

Referenced by Digikam::FaceGroup::slotAddItemFinished(), and Digikam::FocusPointGroup::slotAddItemFinished().

setItemThatShallBeShown

void Digikam::ItemVisibilityController::setItemThatShallBeShown ( QObject *  item )

slotinherited

Sets a single item to be shown. Calling setVisible() will effectively effect only this single item, as if calling setItemVisible(). Reset by calling with 0 or setShallBeShown().

References Digikam::ItemVisibilityController::setVisible().

Referenced by Digikam::FocusPointGroup::setVisibleItem(), Digikam::FaceGroup::setVisibleItem(), and Digikam::FocusPointGroup::slotAddItemMoving().

setItemVisible

void Digikam::ItemVisibilityController::setItemVisible ( QObject *  item, bool  visible  )

slotinherited

References Digikam::ItemVisibilityController::visible.

Referenced by Digikam::ItemVisibilityController::hideItem(), and Digikam::ItemVisibilityController::showItem().

setPropertyName()

void Digikam::HidingStateChanger::setPropertyName ( const QByteArray &  propertyName )

inherited

References Digikam::HidingStateChanger::m_property.

Referenced by Digikam::HidingStateChanger::HidingStateChanger().

setShallBeShown

void Digikam::ItemVisibilityController::setShallBeShown ( bool  shallBeShown )

slotinherited

Adjusts the first condition - the items are shown if shallBeShown is true and isVisible is true

References Digikam::ItemVisibilityController::setVisible(), and Digikam::ItemVisibilityController::shallBeShown.

Referenced by Digikam::FaceGroup::FaceGroup(), Digikam::FocusPointGroup::FocusPointGroup(), Digikam::FaceGroup::setVisible(), and Digikam::FocusPointGroup::setVisible().

setShallBeShownDirectly

void Digikam::ItemVisibilityController::setShallBeShownDirectly ( bool  shallBeShown )

slotinherited

References Digikam::ItemVisibilityController::setDirectlyVisible(), and Digikam::ItemVisibilityController::shallBeShown.

setTargetObject()

void Digikam::HidingStateChanger::setTargetObject ( QObject *const  object )

inherited

References Digikam::HidingStateChanger::m_object.

Referenced by Digikam::HidingStateChanger::HidingStateChanger().

setVisible

void Digikam::ItemVisibilityController::setVisible ( bool  visible )

slotinherited

References Digikam::ItemVisibilityController::visible.

Referenced by Digikam::ItemVisibilityController::hide(), Digikam::HidingStateChanger::HidingStateChanger(), Digikam::ItemVisibilityController::setItemThatShallBeShown(), Digikam::ItemVisibilityController::setShallBeShown(), and Digikam::ItemVisibilityController::show().

shallBeShown()

bool Digikam::ItemVisibilityController::shallBeShown ( ) const

inherited

show

void Digikam::ItemVisibilityController::show ( )

slotinherited

Adjusts the main condition. All items are affected. If any items were shown or hidden separately, they will be resynchronized. "Directly" means no animation is employed.

References Digikam::ItemVisibilityController::setVisible().

Referenced by Digikam::FaceGroup::itemStateChanged(), Digikam::FocusPointGroup::itemStateChanged(), Digikam::FaceGroup::load(), Digikam::FocusPointGroup::load(), and Digikam::HidingStateChanger::slotPropertiesAssigned().

showItem

void Digikam::ItemVisibilityController::showItem ( QObject *  item )

slotinherited

Shows or hides a single item. The item's status is changed individually. The next call to the "global" method will take precedence again. "Directly" means no animation is employed.

References Digikam::ItemVisibilityController::setItemVisible().

Referenced by Digikam::FaceGroup::slotAddItemMoving(), and Digikam::FocusPointGroup::slotAddItemMoving().

slotPropertiesAssigned

void Digikam::HidingStateChanger::slotPropertiesAssigned ( bool  visible )

protectedslotinherited

References Digikam::HidingStateChanger::finished(), Digikam::HidingStateChanger::m_object, Digikam::HidingStateChanger::m_property, Digikam::HidingStateChanger::m_value, Digikam::ItemVisibilityController::show(), Digikam::HidingStateChanger::stateChanged(), and Digikam::ItemVisibilityController::visible.

Referenced by Digikam::HidingStateChanger::changeValue(), and Digikam::HidingStateChanger::HidingStateChanger().

slotStateChanged

void Digikam::AssignNameWidgetStates::slotStateChanged ( )

protectedslot

References Digikam::AssignNameWidget::ConfirmedMode, Digikam::AssignNameWidget::mode, Digikam::FaceItem::setEditable(), and Digikam::FaceItem::widget().

Referenced by AssignNameWidgetStates().

state()

ItemVisibilityController::State Digikam::ItemVisibilityController::state ( ) const

inherited

References Digikam::ItemVisibilityController::Hidden.

stateChanged

void Digikam::HidingStateChanger::stateChanged ( )

signalinherited

Emitted when the items were hidden and the target object's property changed

Referenced by AssignNameWidgetStates(), and Digikam::HidingStateChanger::slotPropertiesAssigned().

visibleItems()

QList< QObject * > Digikam::ItemVisibilityController::visibleItems ( IncludeFadingOutMode  mode = IncludeFadingOut ) const

inherited

Returns all currently visible items.

References Digikam::ItemVisibilityController::items().

Referenced by Digikam::FaceGroup::itemHoverMoveEvent().

Member Data Documentation

m_object

QObject* Digikam::HidingStateChanger::m_object

protectedinherited

Referenced by Digikam::HidingStateChanger::setTargetObject(), and Digikam::HidingStateChanger::slotPropertiesAssigned().

m_property

QByteArray Digikam::HidingStateChanger::m_property

protectedinherited

Referenced by Digikam::HidingStateChanger::setPropertyName(), and Digikam::HidingStateChanger::slotPropertiesAssigned().

m_value

QVariant Digikam::HidingStateChanger::m_value

protectedinherited

Referenced by Digikam::HidingStateChanger::changeValue(), and Digikam::HidingStateChanger::slotPropertiesAssigned().

Property Documentation

shallBeShown

bool Digikam::ItemVisibilityController::shallBeShown

readwriteinherited

Referenced by Digikam::FaceGroup::isVisible(), Digikam::FocusPointGroup::isVisible(), Digikam::FaceGroup::setInfo(), Digikam::FocusPointGroup::setInfo(), Digikam::ItemVisibilityController::setShallBeShown(), and Digikam::ItemVisibilityController::setShallBeShownDirectly().

visible

bool Digikam::ItemVisibilityController::visible

readwriteinherited

Referenced by Digikam::ItemVisibilityController::setDirectlyVisible(), Digikam::ItemVisibilityController::setItemDirectlyVisible(), Digikam::ItemVisibilityController::setItemVisible(), Digikam::ItemVisibilityController::setVisible(), and Digikam::HidingStateChanger::slotPropertiesAssigned().

---

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

• core/utilities/facemanagement/widgets/assignnamewidgetstates.h
• core/utilities/facemanagement/widgets/assignnamewidgetstates.cpp