ParallelActivityHostConcept implementation class. More...

#include <kanzi/ui/node/concept/activity/parallel_activity_host_impl.hpp>

Inheritance diagram for kanzi::ParallelActivityHostImpl< TBaseClass, TDerivedClass >:

Public Types
using	NodeTypeSharedPtr = shared_ptr< TBaseClass >

Public Types inherited from kanzi::ActivityHostConcept
enum	ActivationStatus { ActivationStatus::PreparingForActivation, ActivationStatus::ParallelAnimation, ActivationStatus::ExclusiveAnimation }
	Specifies possible stages for internal tracking of activation of an Activity. More...

using	ActivityInfoContainer = vector< ActivityInfo >

enum	DeactivationStatus { DeactivationStatus::ExclusiveAnimation, DeactivationStatus::ParallelAnimation, DeactivationStatus::WaitingForRelease }
	Specifies possible stages for internal tracking of deactivation of an Activity. More...

enum	FocusLostFlag { FocusLostFlag::FocusLossObserved, FocusLostFlag::NoFocusLossObserved }
	An Activity Host uses this enum to keep track of whether it has lost focus during Activity switching. More...

Public Types inherited from kanzi::ParallelActivityHostConcept
using	ParallelActivityHostContent = vector< ActivityInParallelHostInfo >
	Container for the content information for a ParallelActivityHost. More...

Public Member Functions
void	activate (const ActivityHostConcept::ActivityInfo &activityInfo, string_view restOfActivationPath)
	Activates a child Activity node. More...

void	deactivate (string_view name)
	Deactivates a child Activity node. More...

void	deserialize (string_view data) override
	ActivityElement::deserialize implementation. More...

void	onFinishedExclusiveDeactivatingAnimationInternal (const ActivityConcept::StatusChangedInternalMessageArguments &args)
	Message handler for FinishedExclusiveDeactivatingAnimationInternal message. More...

void	onFinishedParallelActivatingAnimationInternal (const ActivityConcept::StatusChangedInternalMessageArguments &args)
	Message handler for FinishedParallelActivatingAnimationInternal message. More...

void	onFinishedParallelDeactivatingAnimationInternal (const ActivityConcept::StatusChangedInternalMessageArguments &args)
	Message handler for FinishedParallelDeactivatingAnimationInternal message. More...

void	setActivationModifier (string_view activityName, BindingTokenWeakPtr weakModifier) override
	ActivityHostConcept::setActivationModifier implementation. More...

Public Member Functions inherited from kanzi::ActivityHostConceptImpl< TBaseClass, TDerivedClass >
void	notifyChildrenNodeTreeAvailable () override
	ActivityElement::notifyChildrenNodeTreeAvailable implementation. More...

string	serialize () override
	ActivityElement::serialize implementation. More...

Public Member Functions inherited from kanzi::ActivityElementImpl< TBaseClass, TDerivedClass >
Node *	getNode () override
	Gets the underlying Node object. More...

const Node *	getNode () const override
	Gets the underlying Node object. More...

Public Member Functions inherited from kanzi::ActivityElement
Node *	findChildHost (string_view hostName)
	Finds a child Activity Host by name. More...

vector< string >	getCommands () const
	Gets the list of commands handled by code behind of this activity element. More...

ActivityHistoryManager *	getHistoryManager () const
	Gets the history manager of this activity element. More...

ActivityElement *	getParentElement ()
	Gets the parent ActivityElement type node. More...

bool	isLeafActivityNode () const
	Returns whether an ActivityElement has a child Activity Host. More...

const Node *	restoreLastFocusedNode ()
	Restores the focus to a child node of this Activity node, if the Activity node: More...

void	setCodeBehind (const Metaclass *metaclass)
	Instantiates and attaches a code behind object by specifying its metaclass. More...

void	setCodeBehind (CodeBehindSharedPtr codeBehind)
	Attaches a code behind object. More...

void	setLastFocusedNodePath ()
	Sets the last focused node path of this Activity node to the currently focused child node, if the Activity node: More...

virtual	~ActivityElement ()=default
	Destructor. More...

Public Member Functions inherited from kanzi::ActivityHostConcept
virtual	~ActivityHostConcept ()=default
	Destructor. More...

Public Member Functions inherited from kanzi::ParallelActivityHostConcept
virtual	~ParallelActivityHostConcept ()=default
	Destructor. More...

Static Public Member Functions
static PropertyTypeEditorInfoSharedPtr	makeEditorInfo ()

Static Public Member Functions inherited from kanzi::ActivityElement
static string	getFirstElement (string_view activationSequence)
	Gets the first element of the activation sequence. More...

static string	getRestToForward (string_view activationSequence)
	Gets the remainder of the activation sequence. More...

template<typename Type >
static bool	isActivityElement (const Type &object)
	Checks if and object is an ActivityElement. More...

static PropertyTypeEditorInfoSharedPtr	makeEditorInfo ()

Static Public Member Functions inherited from kanzi::ActivityHostConcept
template<typename Type >
static bool	isActivityHost (const Type &object)
	Determines if an object is an ActivityHost. More...

static PropertyTypeEditorInfoSharedPtr	makeEditorInfo ()

Static Public Member Functions inherited from kanzi::ParallelActivityHostConcept
static PropertyTypeEditorInfoSharedPtr	makeEditorInfo ()
	Returns the PropertyType editor information for a Parallel Activity Host Concept. More...

Protected Member Functions
vector< NodeWeakPtr >	getActiveOrAttachedActivating () override
	ActivityHostConceptImpl::getActiveOrAttachedActivating implementation. More...

optional< ActivityHostConcept::ActivityInfo >	getActivityInfo (string_view name) const override
	ActivityHostConceptImpl::getActivityInfo implementation. More...

vector< NodeWeakPtr >	getAttachedActivityNodes () override
	ActivityHostConceptImpl::getAttachedActivityNodes implementation. More...

void	initialize ()
	Initializes this parallel activity host. More...

void	onDetached () override
	Node::onDetached implementation. More...

	ParallelActivityHostImpl (Domain *domain, string_view name)
	Constructor. More...

Protected Member Functions inherited from kanzi::ActivityHostConceptImpl< TBaseClass, TDerivedClass >
	ActivityHostConceptImpl (Domain *domain, string_view name)
	Constructor. More...

void	initialize ()
	Initializes this Activity Host Concept. More...

void	registerInParentActivityElement () final
	ActivityElement::registerInParentActivityElement implementation. More...

void	unregisterInParentActivityElement () final
	ActivityElement::unregisterInParentActivityElement implementation. More...

virtual	~ActivityHostConceptImpl ()=default
	Destructor. More...

Protected Member Functions inherited from kanzi::ActivityElementImpl< TBaseClass, TDerivedClass >
	ActivityElementImpl (Domain *domain, string_view name)
	Constructor. More...

void	initialize ()
	Initializes the activity element. More...

void	onAttached () override
	Node::onAttached implementation. More...

virtual void	onAttachedOverride ()
	Overrides the onAttached method. More...

void	onDetached () override
	Node::onDetached implementation. More...

void	onNodePropertyChanged (AbstractPropertyType propertyType, PropertyNotificationReason reason) override
	Node::onNodePropertyChanged implementation. More...

	~ActivityElementImpl () override=default
	Destructor. More...

Protected Member Functions inherited from kanzi::ActivityElement
optional< ActivityBrowserController::ActivityID >	getActivityID () const
	Gets the unique ID that is used by the implementation of the Activity Browser. More...

string	getPathInParent ()
	Gets the activation path of this activity element relative to its parent. More...

void	initialize ()
	Initializes the activity element. More...

bool	isRootActivityElement () const
	Returns whether an ActivityElement is the root Activity Host node of the Screen node. More...

void	onForceTrigger (const ActivityBrowserController::ForceTriggerMessageArguments &args)
	Message handler for ActivityBrowserController::ForceTriggerMessage. More...

void	onNodeInfoTreeAvailable (const ActivityBrowserController::NodeInfoTreeAvailableArguments &)
	Message handler for ActivityBrowserController::NodeInfoTreeAvailableMessage. More...

void	registerChildHost (string_view hostPath)
	Registers a child host in this activity element. More...

void	setActivityID (optional< ActivityBrowserController::ActivityID > activityID)
	Sets the unique ID that is used by the implementation of the Activity Browser. More...

void	unregisterChildHost (string_view hostName)
	Unregisters a child host from this activity element. More...

void	updateActivityBrowserProperties ()
	Triggers the Activity Browser to update the properties of the Activity Element. More...

Additional Inherited Members
Static Public Attributes inherited from kanzi::ActivityElement
static PropertyType< bool >	AttachedProperty

Static Public Attributes inherited from kanzi::ActivityHostConcept
static MessageType< ActivationMessageArguments >	ActivateActivityMessage
	You can send ActivateActivity to the Activity Host to activate an Activity. More...

static MessageType< ActivationMessageArguments >	DeactivateActivityMessage
	You can send DeactivateActivity to the Activity Host to deactivate an Activity. More...

static MessageType< ActivityPrefabMessageArguments >	ActivityPrefabAttachedMessage
	An Activity Host sends this message when it attaches the prefab of the Activity that is activated. More...

static MessageType< ActivityPrefabMessageArguments >	ActivityPrefabDetachedMessage
	An Activity Host sends this message when it attaches the prefab of the Activity that is activated. More...

static MessageType< RegisterActivityElementInternalMessageArguments >	RegisterHostInternalMessage
	Internal message sent by an Activity Host to its parent Activity or Activity Host to register the Activity Host in the parent. More...

static MessageType< UnregisterActivityElementInternalMessageArguments >	UnregisterHostInternalMessage
	Internal message sent by an Activity Host to its parent Activity or Activity Host to unregister the Activity Host from the parent. More...

static MessageType< ActivityHostConceptInternalArguments >	RestoreFocusInternalMessage
	Internal message sent by an Activity Host to its ancestor parent Activity Hosts to trigger the focus resolving. More...

Static Public Attributes inherited from kanzi::ParallelActivityHostConcept
static PropertyType< bool >	BringActivatedToFrontProperty
	Sets whether to show the activated Activity in front within its Parallel Activity Host. More...

static PropertyType< bool >	ActivationStackProperty
	Sets whether a Parallel Activity Host keeps a child Activity node active to satisfy the request from both ActivateActivityMessage activation and ApplyActivationAction mechanism. More...

static PropertyType< string >	ParallelActivityHostContentProperty
	Describes the content of a Parallel Activity Host node. More...

Protected Attributes inherited from kanzi::ActivityHostConceptImpl< TBaseClass, TDerivedClass >
FocusLostFlag	m_focusLostDuringSwitching
	Indicates whether this Activity Host lost focus during Activity switching, resulting in the loss of the active focus. More...

Detailed Description

template<typename TBaseClass, typename TDerivedClass>
class kanzi::ParallelActivityHostImpl< TBaseClass, TDerivedClass >

ParallelActivityHostConcept implementation class.

This is a helper class for parallel activity hosts.

Member Typedef Documentation

◆ NodeTypeSharedPtr

template<typename TBaseClass, typename TDerivedClass>

using kanzi::ParallelActivityHostImpl< TBaseClass, TDerivedClass >::NodeTypeSharedPtr = shared_ptr<TBaseClass>

Constructor & Destructor Documentation

◆ ParallelActivityHostImpl()

template<typename TBaseClass , typename TDerivedClass >

kanzi::ParallelActivityHostImpl< TBaseClass, TDerivedClass >::ParallelActivityHostImpl	(	Domain *	domain,
		string_view	name
	)

explicitprotected

Constructor.

Parameters

domain	The domain the new node belongs to.
name	The name of the node.

Member Function Documentation

◆ makeEditorInfo()

template<typename TBaseClass , typename TDerivedClass >

PropertyTypeEditorInfoSharedPtr kanzi::ParallelActivityHostImpl< TBaseClass, TDerivedClass >::makeEditorInfo ( )

static

◆ deserialize()

template<typename TBaseClass , typename TDerivedClass >

void kanzi::ParallelActivityHostImpl< TBaseClass, TDerivedClass >::deserialize ( string_view data )

overridevirtual

ActivityElement::deserialize implementation.

Deserializes the currently active child Activity nodes.

Reimplemented from kanzi::ActivityHostConceptImpl< TBaseClass, TDerivedClass >.

◆ onFinishedParallelActivatingAnimationInternal()

template<typename TBaseClass , typename TDerivedClass >

void kanzi::ParallelActivityHostImpl< TBaseClass, TDerivedClass >::onFinishedParallelActivatingAnimationInternal ( const ActivityConcept::StatusChangedInternalMessageArguments & args )

Message handler for FinishedParallelActivatingAnimationInternal message.

Parameters

args	Message arguments.

◆ onFinishedParallelDeactivatingAnimationInternal()

template<typename TBaseClass , typename TDerivedClass >

void kanzi::ParallelActivityHostImpl< TBaseClass, TDerivedClass >::onFinishedParallelDeactivatingAnimationInternal ( const ActivityConcept::StatusChangedInternalMessageArguments & args )

Message handler for FinishedParallelDeactivatingAnimationInternal message.

Parameters

args	Message arguments.

◆ onFinishedExclusiveDeactivatingAnimationInternal()

template<typename TBaseClass , typename TDerivedClass >

void kanzi::ParallelActivityHostImpl< TBaseClass, TDerivedClass >::onFinishedExclusiveDeactivatingAnimationInternal ( const ActivityConcept::StatusChangedInternalMessageArguments & args )

Message handler for FinishedExclusiveDeactivatingAnimationInternal message.

Parameters

args	Message arguments.

◆ setActivationModifier()

template<typename TBaseClass , typename TDerivedClass >

void kanzi::ParallelActivityHostImpl< TBaseClass, TDerivedClass >::setActivationModifier	(	string_view	activityName,
		BindingTokenWeakPtr	weakModifier
	)

overridevirtual

ActivityHostConcept::setActivationModifier implementation.

Implements kanzi::ActivityHostConcept.

◆ activate()

template<typename TBaseClass , typename TDerivedClass >

void kanzi::ParallelActivityHostImpl< TBaseClass, TDerivedClass >::activate	(	const ActivityHostConcept::ActivityInfo &	activityInfo,
		string_view	restOfActivationPath
	)

Activates a child Activity node.

Parameters

activityInfo	The Activity information of the node to activate.
restOfActivationPath	The path of the activation sequence to forward to the activated Activity node, once the given Activity node is activated.

◆ deactivate()

template<typename TBaseClass , typename TDerivedClass >

void kanzi::ParallelActivityHostImpl< TBaseClass, TDerivedClass >::deactivate ( string_view name )

Deactivates a child Activity node.

Parameters

name	The name of the Activity node to deactivate.

◆ initialize()

template<typename TBaseClass , typename TDerivedClass >

void kanzi::ParallelActivityHostImpl< TBaseClass, TDerivedClass >::initialize ( )

protected

Initializes this parallel activity host.

◆ onDetached()

template<typename TBaseClass , typename TDerivedClass >

void kanzi::ParallelActivityHostImpl< TBaseClass, TDerivedClass >::onDetached ( )

overrideprotected

Node::onDetached implementation.

◆ getActivityInfo()

template<typename TBaseClass , typename TDerivedClass >

optional< ActivityHostConcept::ActivityInfo > kanzi::ParallelActivityHostImpl< TBaseClass, TDerivedClass >::getActivityInfo ( string_view name ) const