iprm::CDelegatedEnableableParamComp Class Reference

#include <CDelegatedEnableableParamComp.h>

Inheritance diagram for iprm::CDelegatedEnableableParamComp:

Public Types
typedef icomp::CComponentBase	BaseClass
Public Types inherited from iprm::IEnableableParam
enum	ChangeFlags { CF_ENABLED = 0x089347 }
	Change notification flags. More...
Public Types inherited from istd::IChangeable
enum	ChangeFlags {   CF_ACF_INTERNAL = 0 , CF_ALL_DATA , CF_ANY , CF_DESTROYING ,   CF_DELEGATED , CF_NO_UNDO }
	Data model change notification flags. More...
enum	SupportedOperations {   SO_NONE = 0 , SO_OBSERVE = 1 << 0 , SO_COPY = 1 << 1 , SO_CLONE = 1 << 2 ,   SO_COMPARE = 1 << 3 , SO_RESET = 1 << 4 }
	Flags for supported operations. More...
enum	CompatibilityMode { CM_STRICT , CM_WITHOUT_REFS , CM_WITH_REFS , CM_CONVERT }
	Control how relationship betweeen objects are interpreted. More...
typedef QMultiMap< QByteArray, QVariant >	ChangeInfoMap

Public Member Functions
	CDelegatedEnableableParamComp ()
Public Member Functions inherited from icomp::CComponentBase
	CComponentBase ()
	Create component and assign it to specific context.
virtual const icomp::IComponent *	GetParentComponent (bool ownerOnly=false) const override
	Get parent of this component.
virtual void *	GetInterface (const istd::CClassInfo &interfaceType, const QByteArray &subId="") override
	Get access to specified component interface.
virtual IComponentContextSharedPtr	GetComponentContext () const override
	Get access to component context describing all application-specified component information loaded from components registry.
virtual void	SetComponentContext (const IComponentContextSharedPtr &contextPtr, const icomp::IComponent *parentPtr, bool isParentOwner) override
	Set component context of this component.
Public Member Functions inherited from istd::IPolymorphic
virtual	~IPolymorphic ()
Public Member Functions inherited from iser::ISerializable
virtual quint32	GetMinimalVersion (int versionId) const
	Get minimal needed version to correct storing of this data.
Public Member Functions inherited from istd::IChangeable
virtual int	GetSupportedOperations () const
	Get set of flags for supported operations.
virtual bool	CopyFrom (const IChangeable &object, CompatibilityMode mode=CM_WITHOUT_REFS)
	Copy this object from another one.
virtual bool	IsEqual (const IChangeable &object) const
	Compare this object with another object.
virtual istd::TUniqueInterfacePtr< istd::IChangeable >	CloneMe (CompatibilityMode mode=CM_WITHOUT_REFS) const
	Make a copy of this object.
virtual bool	ResetData (CompatibilityMode mode=CM_WITHOUT_REFS)
	Reset data to its default state.
virtual void	BeginChanges (const ChangeSet &changeSet)
	Starts the change transaction.
virtual void	EndChanges (const ChangeSet &changeSet)
	Ends the change transaction.
virtual void	BeginChangeGroup (const ChangeSet &changeSet)
	Starts group of changes.
virtual void	EndChangeGroup (const ChangeSet &changeSet)
	Ends group of changes.

Protected Member Functions
virtual bool	IsEnabled () const override
	Return true if something is enabled.
virtual bool	IsEnablingAllowed () const override
	Return true if enabling/disabling is allowed.
virtual bool	SetEnabled (bool isEnabled=true) override
	Set the enabled state.
virtual bool	Serialize (iser::IArchive &archive) override
	Load or store state of this object as a archive stream.
virtual bool	CopyFrom (const IChangeable &object, CompatibilityMode mode=CM_WITHOUT_REFS) override
virtual void	OnComponentCreated () override
virtual void	OnComponentDestroyed () override
Protected Member Functions inherited from icomp::CComponentBase
bool	IsComponentActive () const
	Check if component is active.
virtual const icomp::IRealComponentStaticInfo &	GetComponentStaticInfo () const =0
	Get access to static info of this component.
Protected Member Functions inherited from istd::IChangeable
virtual void	OnBeginChanges ()
	Callback function for begin change event.
virtual void	OnEndChanges (const ChangeSet &changeSet)
	Callback function for end change event.

Additional Inherited Members
Static Public Member Functions inherited from istd::IChangeable
static const ChangeSet &	GetNoChanges ()
	Get empty set of changes.
static const ChangeSet &	GetAnyChange ()
	Get anonymous change set.
static const ChangeSet &	GetAllChanges ()
	Get anonymous change set.
static const ChangeSet &	GetDelegatedChanges ()
	Get delegated change set.
Static Protected Member Functions inherited from icomp::CComponentBase
static const icomp::IRealComponentStaticInfo &	InitStaticInfo (IComponent *componentPtr)
static QByteArray	GetComponentId (const icomp::IComponentContext *componentContextPtr, const QByteArray &contextId=QByteArray())

Detailed Description

Definition at line 15 of file CDelegatedEnableableParamComp.h.

Member Typedef Documentation

BaseClass

typedef icomp::CComponentBase iprm::CDelegatedEnableableParamComp::BaseClass

Definition at line 20 of file CDelegatedEnableableParamComp.h.

Constructor & Destructor Documentation

CDelegatedEnableableParamComp()

iprm::CDelegatedEnableableParamComp::CDelegatedEnableableParamComp

(

)

Member Function Documentation

CopyFrom()

virtual bool iprm::CDelegatedEnableableParamComp::CopyFrom ( const IChangeable &  object, CompatibilityMode  mode = CM_WITHOUT_REFS  )

overrideprotectedvirtual

IsEnabled()

virtual bool iprm::CDelegatedEnableableParamComp::IsEnabled ( ) const

overrideprotectedvirtual

Return true if something is enabled.

Returns

true if currently enabled, false if disabled.

if (param.IsEnabled())
{
    // Perform action that requires enabled state
}

See also

SetEnabled, IsEnablingAllowed

Implements iprm::IEnableableParam.

IsEnablingAllowed()

virtual bool iprm::CDelegatedEnableableParamComp::IsEnablingAllowed ( ) const

overrideprotectedvirtual

Return true if enabling/disabling is allowed.

Indicates whether the enable state can be changed. Some parameters may have fixed enable states based on system constraints or dependencies.

Returns

true if SetEnabled() can change the state, false if state is fixed.

if (param.IsEnablingAllowed())
{
    // User can toggle the enable state
    param.SetEnabled(!param.IsEnabled());
}
else
{
    // Enable state is fixed by system constraints
    qDebug() << "Cannot change enable state";
}

See also

SetEnabled

Implements iprm::IEnableableParam.

OnComponentCreated()

virtual void iprm::CDelegatedEnableableParamComp::OnComponentCreated ( )

overrideprotectedvirtual

Reimplemented from icomp::CComponentBase.

OnComponentDestroyed()

virtual void iprm::CDelegatedEnableableParamComp::OnComponentDestroyed ( )

overrideprotectedvirtual

Reimplemented from icomp::CComponentBase.

Serialize()

virtual bool iprm::CDelegatedEnableableParamComp::Serialize ( iser::IArchive &  archive )

overrideprotectedvirtual

Load or store state of this object as a archive stream.

Type of operation is depending on archive type.

See also

iser::IArchive

Implements iser::ISerializable.

SetEnabled()

virtual bool iprm::CDelegatedEnableableParamComp::SetEnabled ( bool  isEnabled = true )

overrideprotectedvirtual

Set the enabled state.

Changes whether the parameter is enabled or disabled.

Parameters

isEnabled

New enable state. true to enable, false to disable.

Returns

true if the state change was allowed and successful, false otherwise.

Note

Returns false if IsEnablingAllowed() returns false.

Triggers CF_ENABLED notification on successful change.

// Enable
if (param.SetEnabled(true))
{
    qDebug() << "Successfully enabled";
}
 
// Disable
if (param.SetEnabled(false))
{
    qDebug() << "Successfully disabled";
}
 
// Toggle
param.SetEnabled(!param.IsEnabled());

See also

IsEnabled, IsEnablingAllowed, CF_ENABLED

Implements iprm::IEnableableParam.

---

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

• Acf/Include/iprm/CDelegatedEnableableParamComp.h