ActivityElement is the base class for all Activity and Activity Host classes. More...

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

Inheritance diagram for kanzi::ActivityElement:

Public Member Functions
virtual void	deserialize (string_view data)
	Deserializes the activity element from a byte buffer. More...

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...

virtual Node *	getNode ()=0
	Gets the underlying Node object. More...

virtual const Node *	getNode () const =0
	Gets the underlying Node object. 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...

virtual string	serialize ()
	Serializes the activity element to a byte buffer. 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...

Static Public Member Functions
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 Attributes
Properties
Use this property to check whether an ActivityElement type node is attached or not. The default value is false.
static PropertyType< bool >	AttachedProperty

Protected Member Functions
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...

virtual void	notifyChildrenNodeTreeAvailable ()
	Notifies child activity elements that node info tree is available. 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...

virtual void	registerInParentActivityElement ()=0
	Derived classes implement this function to register themselves in the parent during the construction of the activity graph. 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...

virtual void	unregisterInParentActivityElement ()=0
	Derived classes implement this function to unregister themselves from the parent during the destruction of the activity graph. More...

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

Detailed Description

ActivityElement is the base class for all Activity and Activity Host classes.

ActivityElement provides the way to manipulate the activity graph in a uniform manner. ActivityElement provides this base functionality to all Activity and Activity Host classes:

Access the parent Activity Element.
Access the child Activity Host nodes.
Access the underlying Node object.
Code Behind.
Serialization and History Manager.

Constructor & Destructor Documentation

◆ ~ActivityElement()

virtual kanzi::ActivityElement::~ActivityElement ( )

virtualdefault

Destructor.

Member Function Documentation

◆ makeEditorInfo()

static PropertyTypeEditorInfoSharedPtr kanzi::ActivityElement::makeEditorInfo ( )

static

◆ getNode() [1/2]

virtual Node* kanzi::ActivityElement::getNode ( )

pure virtual

Gets the underlying Node object.

Returns: The underlying Node object pointer.

◆ getNode() [2/2]

virtual const Node* kanzi::ActivityElement::getNode ( ) const

pure virtual

Gets the underlying Node object.

Returns: The underlying Node object pointer.

◆ serialize()

virtual string kanzi::ActivityElement::serialize ( )

virtual

Serializes the activity element to a byte buffer.

Returns: The byte buffer containing the serialized data.

Reimplemented in kanzi::ActivityHostConceptImpl< TBaseClass, TDerivedClass >, kanzi::ActivityHostConceptImpl< ContentLayout2D, DataDrivenExclusiveActivityHost2D >, kanzi::ActivityHostConceptImpl< ContentLayout3D, ParallelActivityHost3D >, kanzi::ActivityHostConceptImpl< ContentLayout2D, ParallelActivityHost2D >, kanzi::ActivityHostConceptImpl< ContentLayout3D, DataDrivenExclusiveActivityHost3D >, kanzi::ActivityHostConceptImpl< ContentLayout2D, ExclusiveActivityHost2D >, and kanzi::ActivityHostConceptImpl< ContentLayout3D, ExclusiveActivityHost3D >.

◆ deserialize()

virtual void kanzi::ActivityElement::deserialize ( string_view data )

virtual

Deserializes the activity element from a byte buffer.

Parameters

data	The byte buffer containing the serialized data.

Reimplemented in kanzi::ActivityHostConceptImpl< TBaseClass, TDerivedClass >, kanzi::ActivityHostConceptImpl< ContentLayout2D, DataDrivenExclusiveActivityHost2D >, kanzi::ActivityHostConceptImpl< ContentLayout3D, ParallelActivityHost3D >, kanzi::ActivityHostConceptImpl< ContentLayout2D, ParallelActivityHost2D >, kanzi::ActivityHostConceptImpl< ContentLayout3D, DataDrivenExclusiveActivityHost3D >, kanzi::ActivityHostConceptImpl< ContentLayout2D, ExclusiveActivityHost2D >, kanzi::ActivityHostConceptImpl< ContentLayout3D, ExclusiveActivityHost3D >, kanzi::ParallelActivityHostImpl< TBaseClass, TDerivedClass >, kanzi::ParallelActivityHostImpl< ContentLayout3D, ParallelActivityHost3D >, kanzi::ParallelActivityHostImpl< ContentLayout2D, ParallelActivityHost2D >, kanzi::ExclusiveActivityHostImpl< TBaseClass, TDerivedClass >, kanzi::ExclusiveActivityHostImpl< ContentLayout2D, ExclusiveActivityHost2D >, and kanzi::ExclusiveActivityHostImpl< ContentLayout3D, ExclusiveActivityHost3D >.

◆ setCodeBehind() [1/2]

void kanzi::ActivityElement::setCodeBehind ( const Metaclass * metaclass )

Instantiates and attaches a code behind object by specifying its metaclass.

Parameters

metaclass The metaclass of the code behind class you want to instantiate and attach.

◆ setCodeBehind() [2/2]

void kanzi::ActivityElement::setCodeBehind ( CodeBehindSharedPtr codeBehind )

Attaches a code behind object.

Parameters

codeBehind The code behind object you want to attach.

◆ getCommands()

vector<string> kanzi::ActivityElement::getCommands ( ) const

Gets the list of commands handled by code behind of this activity element.

Returns: Returns the list of commands handled by code behind of this activity element.

◆ getHistoryManager()

ActivityHistoryManager* kanzi::ActivityElement::getHistoryManager ( ) const

Gets the history manager of this activity element.

Returns: The history manager.

◆ getParentElement()

ActivityElement* kanzi::ActivityElement::getParentElement ( )

Gets the parent ActivityElement type node.

Returns: The parent element or nullptr if this is the root element.

◆ findChildHost()

Node* kanzi::ActivityElement::findChildHost ( string_view hostName )

Finds a child Activity Host by name.

Parameters

hostName The name of the child Activity Host to find.

Returns: The pointer to the child Activity Host if found, nullptr otherwise.

◆ isLeafActivityNode()

bool kanzi::ActivityElement::isLeafActivityNode ( ) const

Returns whether an ActivityElement has a child Activity Host.

Returns: If this ActivityElement is a leaf Activity node, true, otherwise false.

Since: Kanzi 3.9.0

◆ restoreLastFocusedNode()

const Node* kanzi::ActivityElement::restoreLastFocusedNode ( )

Restores the focus to a child node of this Activity node, if the Activity node:

Is a focus scope node
Has serialized the last focused node

If Kanzi successfully restores the focus, it clears the value of the Kanzi internal property FocusScopeCore::LastFocusedNodePathProperty.

Returns: Returns the pointer to the child node to which the focus was restored. If the focus was not restored, returns nullptr.

Since: Kanzi 3.9.0

◆ setLastFocusedNodePath()

void kanzi::ActivityElement::setLastFocusedNodePath ( )

Sets the last focused node path of this Activity node to the currently focused child node, if the Activity node:

Is a focus scope node
Has ActivityConcept::SaveLastFocusedNodeProperty set to true

Since: Kanzi 3.9.0

◆ isActivityElement()

template<typename Type >

bool kanzi::ActivityElement::isActivityElement ( const Type & object )

static

Checks if and object is an ActivityElement.

Parameters

object Object you want to check.

Returns: Returns true if the object is an ActivityElement, false otherwise.

◆ getFirstElement()

static string kanzi::ActivityElement::getFirstElement ( string_view activationSequence )

static

Gets the first element of the activation sequence.

Parameters

activationSequence Activation sequence to parse.

Returns: Returns the first element.

◆ getRestToForward()

static string kanzi::ActivityElement::getRestToForward ( string_view activationSequence )

static

Gets the remainder of the activation sequence.

Parameters

activationSequence Activation sequence to parse.

Returns: Returns the remainder of the sequence.

◆ registerInParentActivityElement()

virtual void kanzi::ActivityElement::registerInParentActivityElement ( )

protectedpure virtual

Derived classes implement this function to register themselves in the parent during the construction of the activity graph.

Implemented in kanzi::ActivityHostConceptImpl< TBaseClass, TDerivedClass >, kanzi::ActivityHostConceptImpl< ContentLayout2D, DataDrivenExclusiveActivityHost2D >, kanzi::ActivityHostConceptImpl< ContentLayout3D, ParallelActivityHost3D >, kanzi::ActivityHostConceptImpl< ContentLayout2D, ParallelActivityHost2D >, kanzi::ActivityHostConceptImpl< ContentLayout3D, DataDrivenExclusiveActivityHost3D >, kanzi::ActivityHostConceptImpl< ContentLayout2D, ExclusiveActivityHost2D >, kanzi::ActivityHostConceptImpl< ContentLayout3D, ExclusiveActivityHost3D >, kanzi::ActivityConceptImpl< TBaseClass, TDerivedClass >, kanzi::ActivityConceptImpl< ContentLayout2D, Activity2D >, and kanzi::ActivityConceptImpl< ContentLayout3D, Activity3D >.

◆ unregisterInParentActivityElement()

virtual void kanzi::ActivityElement::unregisterInParentActivityElement ( )

protectedpure virtual

Derived classes implement this function to unregister themselves from the parent during the destruction of the activity graph.

Implemented in kanzi::ActivityHostConceptImpl< TBaseClass, TDerivedClass >, kanzi::ActivityHostConceptImpl< ContentLayout2D, DataDrivenExclusiveActivityHost2D >, kanzi::ActivityHostConceptImpl< ContentLayout3D, ParallelActivityHost3D >, kanzi::ActivityHostConceptImpl< ContentLayout2D, ParallelActivityHost2D >, kanzi::ActivityHostConceptImpl< ContentLayout3D, DataDrivenExclusiveActivityHost3D >, kanzi::ActivityHostConceptImpl< ContentLayout2D, ExclusiveActivityHost2D >, kanzi::ActivityHostConceptImpl< ContentLayout3D, ExclusiveActivityHost3D >, kanzi::ActivityConceptImpl< TBaseClass, TDerivedClass >, kanzi::ActivityConceptImpl< ContentLayout2D, Activity2D >, and kanzi::ActivityConceptImpl< ContentLayout3D, Activity3D >.

◆ initialize()

void kanzi::ActivityElement::initialize ( )

protected

Initializes the activity element.

You must call this function in derived classes.

◆ registerChildHost()

void kanzi::ActivityElement::registerChildHost ( string_view hostPath )

protected

Registers a child host in this activity element.

Parameters

hostPath The node tree path to the host to register.

◆ unregisterChildHost()

void kanzi::ActivityElement::unregisterChildHost ( string_view hostName )

protected

Unregisters a child host from this activity element.

Parameters

hostName The name of the host to unregister.

◆ notifyChildrenNodeTreeAvailable()

virtual void kanzi::ActivityElement::notifyChildrenNodeTreeAvailable ( )

protectedvirtual

Notifies child activity elements that node info tree is available.

Reimplemented in kanzi::ActivityHostConceptImpl< TBaseClass, TDerivedClass >, kanzi::ActivityHostConceptImpl< ContentLayout2D, DataDrivenExclusiveActivityHost2D >, kanzi::ActivityHostConceptImpl< ContentLayout3D, ParallelActivityHost3D >, kanzi::ActivityHostConceptImpl< ContentLayout2D, ParallelActivityHost2D >, kanzi::ActivityHostConceptImpl< ContentLayout3D, DataDrivenExclusiveActivityHost3D >, kanzi::ActivityHostConceptImpl< ContentLayout2D, ExclusiveActivityHost2D >, and kanzi::ActivityHostConceptImpl< ContentLayout3D, ExclusiveActivityHost3D >.

◆ getActivityID()

optional<ActivityBrowserController::ActivityID> kanzi::ActivityElement::getActivityID ( ) const

protected

Gets the unique ID that is used by the implementation of the Activity Browser.

◆ setActivityID()

void kanzi::ActivityElement::setActivityID ( optional< ActivityBrowserController::ActivityID > activityID )

protected

Sets the unique ID that is used by the implementation of the Activity Browser.

◆ getPathInParent()

string kanzi::ActivityElement::getPathInParent ( )

protected

Gets the activation path of this activity element relative to its parent.

◆ updateActivityBrowserProperties()

void kanzi::ActivityElement::updateActivityBrowserProperties ( )

protected

Triggers the Activity Browser to update the properties of the Activity Element.

◆ isRootActivityElement()

bool kanzi::ActivityElement::isRootActivityElement ( ) const

protected

Returns whether an ActivityElement is the root Activity Host node of the Screen node.

Returns: If this ActivityElement is the root Activity Host, true, otherwise false.

Since: Kanzi 3.9.0

◆ onNodeInfoTreeAvailable()

void kanzi::ActivityElement::onNodeInfoTreeAvailable ( const ActivityBrowserController::NodeInfoTreeAvailableArguments & )

protected

Message handler for ActivityBrowserController::NodeInfoTreeAvailableMessage.

Performs connection to the Activity Browser data model.

◆ onForceTrigger()

void kanzi::ActivityElement::onForceTrigger ( const ActivityBrowserController::ForceTriggerMessageArguments & args )

protected

Message handler for ActivityBrowserController::ForceTriggerMessage.

Forces a trigger to execute.

Member Data Documentation

◆ AttachedProperty

PropertyType<bool> kanzi::ActivityElement::AttachedProperty

static

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

kanzi/ui/node/concept/activity/activity_element.hpp

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ~ActivityElement()

Member Function Documentation

◆ makeEditorInfo()

◆ getNode() [1/2]

◆ getNode() [2/2]

◆ serialize()

◆ deserialize()

◆ setCodeBehind() [1/2]

◆ setCodeBehind() [2/2]

◆ getCommands()

◆ getHistoryManager()

◆ getParentElement()

◆ findChildHost()

◆ isLeafActivityNode()

◆ restoreLastFocusedNode()

◆ setLastFocusedNodePath()

◆ isActivityElement()

◆ getFirstElement()

◆ getRestToForward()

◆ registerInParentActivityElement()

◆ unregisterInParentActivityElement()

◆ initialize()

◆ registerChildHost()

◆ unregisterChildHost()

◆ notifyChildrenNodeTreeAvailable()

◆ getActivityID()

◆ setActivityID()

◆ getPathInParent()

◆ updateActivityBrowserProperties()

◆ isRootActivityElement()

◆ onNodeInfoTreeAvailable()

◆ onForceTrigger()

Member Data Documentation

◆ AttachedProperty