ActivityCodeBehind is code that is associated with a particular Activity node, and has access to the properties of that Activity node. More...

Inheritance diagram for ActivityCodeBehind:

[legend]

Classes
interface	DirectorInterface

interface	StatusChangeHandler
	StatusChangeHandler implements a handler for Activity status change. More...

Public Member Functions
void	close ()
	Close the object, and release native resources.

Public Member Functions inherited from CodeBehind
Iterable< String >	iterateCommands ()
	Gets an Iterable used to iterate commands handled by this code behind object.

Public Member Functions inherited from NodeComponent
String	getName ()
	Gets the value of #NameProperty.

Node	getNode ()
	Returns the node the node component is attached to or null if node component is not attached to a node.

NodeComponentState	getState ()
	Gets the state of node component indicating if component is attached to a node, detached from any node or in process of attaching/detaching.

boolean	isAttached ()
	Indicates whether node component is attached to a node.

boolean	isAttaching ()
	Indicates whether node component is in the process of attaching to a node.

boolean	isAttachingOrAttached ()
	Indicates whether node component is in the process of attaching to a node or already attached.

boolean	isDetached ()
	Indicates whether node component is detached from any node.

boolean	isDetaching ()
	Indicates whether node component currently detaching from the node.

boolean	isDetachingOrDetached ()
	Indicates whether node component is in the process of detaching from the node or already detached.

void	setName (String value)
	Sets the value of #NameProperty.

Public Member Functions inherited from KanziObject
boolean	equals (Object object)

Domain	getDomain ()
	Returns the domain the object belongs to.

Metaclass	getDynamicMetaclass ()
	Returns the metaclass of the dynamic type of the object.

long	getNative ()
	Gets a pointer to the backing C++ instance.

TDataType	getOptionalProperty (PropertyType< TDataType > propertyType)
	Returns the current value of a property type, but does not use the default value if there are no inputs to the property value.

TDataType	getProperty (PropertyType< TDataType > propertyType)
	Returns the current value of a property type.

int	hashCode ()

boolean	hasValue (PropertyType< TDataType > propertyType)
	Evaluates whether there are any inputs into the property value.

boolean	isStale ()
	Test if the object is stale i.e.

void	removeLocalValue (PropertyType< TDataType > propertyType)
	Removes the local value associated with the property.

void	setFlagKeepDuringPatching (PropertyType< TDataType > propertyType)
	Sets the flag to indicate that the property was loaded from KZB.

void	setProperty (PropertyType< TDataType > propertyType, TDataType value)
	Sets the local value of a property type.

ObjectRef< TType >	tryCreateObjectRef (Class< TType > clazz)
	Tries to create an owning ObjectRef instance to this KanziObject.

Static Public Attributes
static final Metaclass	metaclass = ActivityCodeBehindMetadata.metaclass

Static Public Attributes inherited from CodeBehind
static final Metaclass	metaclass = CodeBehindMetadata.metaclass
	The Metaclass for the class.

Static Public Attributes inherited from NodeComponent
static final Metaclass	metaclass
	The Metaclass for the class.

Static Public Attributes inherited from KanziObject
static final Metaclass	metaclass = new AbstractMetaclass("Kanzi.Object")
	The Metaclass for the class.

Protected Member Functions
	ActivityCodeBehind (Domain domain, long handle, Metaclass metaclass)
	Wraps a given native ActivityCodeBehind.

void	initialize ()
	Initializes the ActivityCodeBehind.

void	registerStatusChange (ActivityStatus status, StatusChangeHandler handler)
	Registers a new activity status change handler.

abstract void	registerStatusChangeOverride ()
	Override this method to register status change handlers.

void	unregisterStatusChange (ActivityStatus status)
	Unregisters an activity status change handler.

abstract void	unregisterStatusChangeOverride ()
	Override this method to unregister the registered status change handlers.

Protected Member Functions inherited from CodeBehind
	CodeBehind (Domain domain, long handle, Metaclass metaclass)
	Wraps a given native CodeBehind.

void	registerCommand (String commandName, CodeBehind.CommandHandler handler)
	Registers a new command handler.

abstract void	registerCommandsOverride ()
	Override this method to register commands.

void	unregisterCommand (String commandName)
	Unregisters a command handler.

abstract void	unregisterCommandsOverride ()
	Override this method to unregister the registered commands.

Protected Member Functions inherited from NodeComponent
	NodeComponent (Domain domain, long handle, Metaclass metaclass)
	Wraps a given native Node Component.

void	attachOverride ()
	Called when the Trigger is attached to a node.

void	detachOverride ()
	Called when a Trigger is detached from a Node.

void	removeNodeComponentMessageFilter (Node.MessageSubscriptionToken token)
	Removes message handler added via `com.rightware.kanzi.NodeComponent#addNodeComponentMessageHandler` function.

Static Protected Member Functions
static< Derived extends NodeComponent > ObjectRef< Derived >	createDerived (Domain domain, String name, Metaclass metaclass)
	Creates a derived class instance.

Additional Inherited Members
Public Attributes inherited from NodeComponentMetadata
AbstractMetaclass	metaclass = new AbstractMetaclass("Kanzi.NodeComponent")
	Metaclass for NodeComponent.

DynamicPropertyType< String >	NameProperty
	Name.

Public Attributes inherited from CodeBehindMetadata
DynamicPropertyType< String >	CodeBehindSourceProperty
	Sets the metaclass name of the code behind class for this node.

AbstractMetaclass	metaclass = new AbstractMetaclass("Kanzi.CodeBehind")
	Metaclass for CodeBehind.

Public Attributes inherited from ActivityCodeBehindMetadata
AbstractMetaclass	metaclass = new AbstractMetaclass("Kanzi.ActivityCodeBehind")
	Metaclass for ActivityCodeBehind.

Detailed Description

ActivityCodeBehind is code that is associated with a particular Activity node, and has access to the properties of that Activity node.

You can use this to:

React to changes of the status of an Activity.
Connect to a remote service when an Activity node is activated and save data and disconnect when an Activity node is deactivated.
Install Kanzi command handlers and define their implementations, such as increase the volume when the user presses a button.
Implement complex UI interaction, such as drag-and-drop of data between UI elements.

All Activity code behind classes inherit from this class.

See also: CodeBehind, Activity2D, Activity3D.

Constructor & Destructor Documentation

◆ ActivityCodeBehind()

ActivityCodeBehind	(	Domain	domain,
		long	handle,
		Metaclass	metaclass )

protected

Wraps a given native ActivityCodeBehind.

Called by com.rightware.kanzi.KanziObject#connectObject(long) when connecting to a native ActivityCodeBehind.

Parameters

domain	UI Domain where the object belongs.
handle	Native object that is backing the object.
metaclass	Metaclass data for the object.

Member Function Documentation

◆ close()

void close ( )

Close the object, and release native resources.

Reimplemented from CodeBehind.

◆ createDerived()

static< Derived extends NodeComponent > ObjectRef< Derived > createDerived	(	Domain	domain,
		String	name,
		Metaclass	metaclass )

staticprotected

Creates a derived class instance.

Call this method as part of the create method for a derived class.

Parameters

domain	UI Domain where this object belongs.
name	Name of the object
metaclass	Metaclass data of the object.

Returns: An ObjectRef that holds the created instance.

Reimplemented from CodeBehind.

◆ initialize()

void initialize ( )

protected

Initializes the ActivityCodeBehind.

Reimplemented from CodeBehind.

◆ registerStatusChange()

void registerStatusChange	(	ActivityStatus	status,
		StatusChangeHandler	handler )

protected

Registers a new activity status change handler.

You must be called in com.rightware.kanzi.ActivityCodeBehind#registerStatusChangeOverride.

Parameters

status	Possible state of the activity nodes during activate and deactivate process.
handler	The handler functor for the command.

◆ registerStatusChangeOverride()

abstract void registerStatusChangeOverride ( )

abstractprotected

Override this method to register status change handlers.

You must register every state change using com.rightware.kanzi.ActivityCodeBehind#registerStatusChange. Kanzi registers the status change when it attaches the Activity that uses this code behind.

See also: ActivityStatus, com.rightware.kanzi.ActivityCodeBehind#unregisterStatusChangeOverride

◆ unregisterStatusChange()

void unregisterStatusChange ( ActivityStatus status )

protected

Unregisters an activity status change handler.

You must be called in com.rightware.kanzi.ActivityCodeBehind#unregisterStatusChangeOverride.

Parameters

status Possible state of the activity nodes during activate and deactivate process.

◆ unregisterStatusChangeOverride()

abstract void unregisterStatusChangeOverride ( )

abstractprotected

Override this method to unregister the registered status change handlers.

You must unregister every status change handler using com.rightware.kanzi.ActivityCodeBehind#unregisterStatusChange. Kanzi unregisters the status change when it detaches the Activity that uses this code behind.

See also: ActivityStatus, com.rightware.kanzi.ActivityCodeBehind#registerStatusChangeOverride

Classes

Public Member Functions

Static Public Attributes

Protected Member Functions

Static Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ActivityCodeBehind()

Member Function Documentation

◆ close()

◆ createDerived()

◆ initialize()

◆ registerStatusChange()

◆ registerStatusChangeOverride()

◆ unregisterStatusChange()

◆ unregisterStatusChangeOverride()