ForwardingAction Class Reference

ForwardingAction is the base class for the action classes that read and send arguments, such as SetPropertyAction or DispatchMessageAction. More...

Inheritance diagram for ForwardingAction:

Public Member Functions
void	close ()
	Close the object, and release native resources.
Public Member Functions inherited from Action
void	close ()
	Close the object, and release native resources.
Duration	getDelay ()
	Returns the delay that Kanzi waits before it invokes an action. More...
Trigger	getTrigger ()
	Returns the pointer to a trigger to which an action is attached. More...
void	invoke ()
	Invokes the action.
void	setDelay (Duration duration)
	Sets the delay that Kanzi waits before it invokes an action. More...
Public Member Functions inherited from ActionBase
String	getName ()
	Gets the name of an action. More...
Public Member Functions inherited from KanziObject
boolean	equals (Object object)
Domain	getDomain ()
	Returns the domain the object belongs to. More...
Metaclass	getDynamicMetaclass ()
	Returns the metaclass of the dynamic type of the object. More...
boolean	isStale ()
	Test if the object is stale i.e. More...
void	removeLocalValue (PropertyType propertyType)
	Removes the local value associated with the property. More...

Static Public Attributes
static final Metaclass	metaclass
	The Metaclass for the class. More...
Static Public Attributes inherited from Action
static final Metaclass	metaclass = com.rightware.kanzi.metadata.ActionMetadata.metaclass
	The Metaclass for the class.
Static Public Attributes inherited from ActionBase
static final Metaclass	metaclass
	The Metaclass for the class. More...
Static Public Attributes inherited from KanziObject
static final Metaclass	metaclass = new AbstractMetaclass("Kanzi.Object")
	The Metaclass for the class.

Protected Member Functions
	ForwardingAction (Domain domain, long handle, Metaclass metaclass)
	Wraps a given native ForwardingAction. More...
void	initialize ()
	Initializes the ForwardingAction.
void	onAttach ()
	Callback called by Kanzi during attach.
void	onDelayedInvoke ()
	Callback called by Kanzi when the action is invoked by trigger with delay, after the delay duration expires. More...
void	onDetach ()
	Callback called by Kanzi during detach.
void	onInvoke ()
	Callback called by Kanzi when the action is invoked by its trigger without delay. More...
void	onPrepareDelayedInvoke ()
	Callback called by Kanzi when the action is invoked by its trigger with delay. More...
void	onUnprepareDelayedInvoke ()
	Kanzi calls this callback when an action is invoked by trigger with delay, after Action#onDelayedInvoke() callback, or when it cancels a delayed execution. More...
Protected Member Functions inherited from Action
	Action (Domain domain, long handle, Metaclass metaclass)
	Wraps a given native Action. More...
void	initialize ()
	Initializes the Action.
void	onAttach ()
	Callback called by Kanzi during attach.
void	onDelayedInvoke ()
	Callback called by Kanzi when the action is invoked by trigger with delay, after the delay duration expires. More...
void	onDetach ()
	Callback called by Kanzi during detach.
void	onInvoke ()
	Callback called by Kanzi when the action is invoked by its trigger without delay. More...
void	onPrepareDelayedInvoke ()
	Callback called by Kanzi when the action is invoked by its trigger with delay. More...
void	onUnprepareDelayedInvoke ()
	Kanzi calls this callback when an action is invoked by trigger with delay, after Action#onDelayedInvoke() callback, or when it cancels a delayed execution. More...

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

Additional Inherited Members
Public Attributes inherited from ActionBaseMetadata
AbstractMetaclass	metaclass = new AbstractMetaclass("Kanzi.ActionBase")
	Metaclass for ActionBase.
Public Attributes inherited from ActionMetadata
DynamicPropertyType< Integer >	DelayProperty
	The time in milliseconds after which Kanzi invokes the action. More...
AbstractMetaclass	metaclass = new AbstractMetaclass("Kanzi.Action")
	Metaclass for Action.
Public Attributes inherited from ForwardingActionMetadata
AbstractMetaclass	metaclass = new AbstractMetaclass("Kanzi.ForwardingAction")
	Metaclass for ForwardingAction.

Detailed Description

ForwardingAction is the base class for the action classes that read and send arguments, such as SetPropertyAction or DispatchMessageAction.

ForwardingAction contains functionality to read arguments from sources, such as messages, properties or set values, and allows the inheriting action class to use these values. This usually means sending messages or setting values of properties.

Constructor & Destructor Documentation

ForwardingAction()

ForwardingAction ( Domain  domain, long  handle, Metaclass  metaclass  )

protected

Wraps a given native ForwardingAction.

Called by KanziObject#connectObject(long) when connecting to a native action.

Parameters

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

Member Function Documentation

createDerived()

static <Derived extends Action> 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 action belongs.
name	Name of the action
metaclass	Metaclass data of the action.

Returns

An ObjectRef that holds the created instance.

onDelayedInvoke()

void onDelayedInvoke ( )

protected

Callback called by Kanzi when the action is invoked by trigger with delay, after the delay duration expires.

Use this to execute an action with delay.

onInvoke()

void onInvoke ( )

protected

Callback called by Kanzi when the action is invoked by its trigger without delay.

Use this to execute an action without delay.

onPrepareDelayedInvoke()

void onPrepareDelayedInvoke ( )

protected

Callback called by Kanzi when the action is invoked by its trigger with delay.

Use this to prepare for delayed execution.

onUnprepareDelayedInvoke()

void onUnprepareDelayedInvoke ( )

protected

Kanzi calls this callback when an action is invoked by trigger with delay, after Action#onDelayedInvoke() callback, or when it cancels a delayed execution.

An example of cancellation of delayed execution is when you detach the action before the execution is done. Use this function to roll back any preparations made for a delayed execution.

Member Data Documentation

metaclass

final Metaclass metaclass

static

Initial value:

=
        com.rightware.kanzi.metadata.ForwardingActionMetadata.metaclass

The Metaclass for the class.