Kanzi Engine API
kanzi::ParallelActivityHostConcept Class Reference

This is the base class for Parallel Activity Host nodes. More...

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

Inheritance diagram for kanzi::ParallelActivityHostConcept:
[legend]

Classes

struct  ActivityInParallelHostInfo
 Stores information that identifies an Activity node under a ParallelActivityHost. More...
 
class  ActivityInParallelHostPrefabLoader
 Extends ActivityPrefabLoader with a specialized behavior for child Activity nodes of a ParallelExclusiveActivityHost. More...
 

Public Types

using ParallelActivityHostContent = vector< ActivityInParallelHostInfo >
 Container for the content information for a ParallelActivityHost. More...
 

Public Member Functions

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

Static Public Member Functions

static PropertyTypeEditorInfoSharedPtr makeEditorInfo ()
 Returns the PropertyType editor information for a Parallel Activity Host Concept. More...
 

Static Public Attributes

Properties

Sets whether to move the activated Activity node to the front within the direct Parallel Activity Host node.

The default value is false.

static PropertyType< bool > BringActivatedToFrontProperty
 
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...
 

Detailed Description

This is the base class for Parallel Activity Host nodes.

See also
ParallelActivityHost2D, ParallelActivityHost3D.

Member Typedef Documentation

Container for the content information for a ParallelActivityHost.

For each child Activity node contains this information:

  • The Activity node name
  • The path to the prefab of the Activity node
  • Whether the Activity node is active when its ParallelActivityHost is activated
  • The priority layer value
See also
ParallelActivityHostContentProperty.
Since
Kanzi 3.9.0

Constructor & Destructor Documentation

virtual kanzi::ParallelActivityHostConcept::~ParallelActivityHostConcept ( )
virtualdefault

Destructor.

Member Function Documentation

static PropertyTypeEditorInfoSharedPtr kanzi::ParallelActivityHostConcept::makeEditorInfo ( )
static

Returns the PropertyType editor information for a Parallel Activity Host Concept.

Returns
The PropertyType editor information for the Parallel Activity Host Concept.

Member Data Documentation

PropertyType<bool> kanzi::ParallelActivityHostConcept::BringActivatedToFrontProperty
static
PropertyType<bool> kanzi::ParallelActivityHostConcept::ActivationStackProperty
static

Sets whether a Parallel Activity Host keeps a child Activity node active to satisfy the request from both ActivateActivityMessage activation and ApplyActivationAction mechanism.

To activate an Activity node, the ApplyActivationAction mechanism sets a property modifier for the ActivationStackProperty.

Set this property on child Activity nodes of a Parallel Activity Host. The default value is false.

Since
Kanzi 3.9.0
PropertyType<string> kanzi::ParallelActivityHostConcept::ParallelActivityHostContentProperty
static

Describes the content of a Parallel Activity Host node.

The Parallel Activity Host uses this content to instantiate Activity node prefabs and control the status and lifetime of its child Activity nodes.

Kanzi Studio user cannot directly edit this property. The ActivityBrowserController sets the value of this property according to the changes done to the state of the Activity Tree in the ActivityBrowser.

The expected format for the property value is a list of Activity node descriptions. Each description contains:

  • The name of the Activity node.
  • A boolean value describing whether the Activity node is going to be active on the ParallelActivityHost activation. When set to true the Activity node is going to be active, when set to false, the Activity node is not going to be active.
  • The path to the prefab of the Activity node.
  • The priority layer value of the Activity node. The priority layer value decides the z-order of the child Activity node. The child Activity node with a higher priority value, is displayed on the top of a child Activity node with the lower priority value. The z-order of the child Activity nodes with the same priority value depends on their order of addition to the Activity Host. The latest added child Activity node is always displayed on top on the existing child Activity nodes with the same priority value.

The values in this property must be separated by a comma.

Syntax: {{<child-activity-name>,<controller-property-value>,<activity-prefab-path>,<priority-layer-number>},{<child-activity-name>,<controller-property-value>,<activity-prefab-path>,<priority-layer-number>},...} Example: {{name1,1,path1,0},{name2,0,path2,1}}.

By default this property value is empty, that is, the Activity Host does not contain any content.

Since
Kanzi 3.9.0

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