Base class for Kanzi nodes. More...

Inheritance diagram for Node:

Classes
interface	MessageSubscriptionFunction
	Defines the message handler invoked when a node receives a message it listens to. More...

class	MessageSubscriptionToken
	Message subscription token that identifies a message subscription. More...

Public Member Functions
ObjectRef< TResourceType >	acquireResource (ResourceID resourceId) throws ObjectNotFoundException
	Acquires a resource from the node or the node's closest ancestor having the resource id in the resource dictionary.

ResourceManager.AcquireTask	acquireResourcesAsync (ResourceID resourceId, ResourceManager.AcquireTask.Callback callback)
	Posts an asynchronous task to acquire a resource.

boolean	addAbstractChild (Node child)
	Adds a node as child of this node.

MessageSubscriptionToken	addMessageFilter (MessageType< MessageArgumentsType > messageType, MessageSubscriptionFunction< MessageArgumentsType > messageHandlerFunction)
	Adds a message filter where the filter is a function.

MessageSubscriptionToken	addMessageHandler (MessageType< MessageArgumentsType > messageType, MessageSubscriptionFunction< MessageArgumentsType > messageHandlerFunction)
	Adds a message handler where the handler is a function.

MessageSubscriptionToken	addMessageHandler (MessageType< MessageArgumentsType > messageType, MessageSubscriptionFunction< MessageArgumentsType > messageHandlerFunction, Node messageSourceFilter)
	Adds a message handler where the handler is a function.

void	addNodeComponentWithOwner (NodeComponent component, KanziObject owner)
	Transfers the ownership of a node component to an object node and sets the owner of the node component.

MessageSubscriptionToken	addTunnelingMessageFilter (MessageType< MessageArgumentsType > messageType, MessageSubscriptionFunction< MessageArgumentsType > messageHandlerFunction)
	Adds a message filter where the filter is a function.

MessageSubscriptionToken	addTunnelingMessageHandler (MessageType< MessageArgumentsType > messageType, MessageSubscriptionFunction< MessageArgumentsType > messageHandlerFunction, Node messageSourceFilter)
	Adds a message handler where the handler is a function and you explicitly define the accepted source.

void	attachRecursive ()
	Attaches an object node and its children recursively.

void	clearChangeFlag (PropertyTypeChangeFlag flag)
	Clears a change flag.

void	dispatchMessage (MessageType< MessageArgumentsType > messageType, MessageArgumentsType arguments)
	Dispatches a message from this node with specified arguments.

String	findResourceUrl (ResourceID resourceId)
	Tries to find Resource URL for Resource ID from this node.

Node	getAbstractChild (int index)
	Returns node at given child index.

int	getAbstractChildCount ()
	Returns number of child nodes.

int	getAbstractChildIndex (Node node)
	Returns index of given node in list of child nodes.

float	getActualDepth ()
	Gets the value of NodeMetadata::ActualDepthProperty.

float	getActualHeight ()
	Gets the value of NodeMetadata::ActualHeightProperty.

float	getActualWidth ()
	Gets the value of NodeMetadata::ActualWidthProperty.

float	getDepth ()
	Gets the value of NodeMetadata::DepthProperty.

Vector2	getDepthMargin ()
	Gets the value of NodeMetadata::DepthMarginProperty.

float	getHeight ()
	Gets the value of NodeMetadata::HeightProperty.

Vector2	getHorizontalMargin ()
	Gets the value of NodeMetadata::HorizontalMarginProperty.

String	getLocale ()
	Gets the value of NodeMetadata::LocaleProperty.

String	getName ()
	Gets the value of NodeMetadata::NameProperty.

float	getOpacity ()
	Gets the value of NodeMetadata::OpacityProperty.

Node	getParent ()
	Gets parent of this node.

String	getPath ()
	Gets the value of NodeMetadata::PathProperty.

Resource	getStateManager ()
	Gets the value of NodeMetadata::StateManagerProperty.

Resource	getStyle ()
	Gets the value of NodeMetadata::StyleProperty.

Vector2	getVerticalMargin ()
	Gets the value of NodeMetadata::VerticalMarginProperty.

float	getWidth ()
	Gets the value of NodeMetadata::WidthProperty.

void	invalidateArrange ()
	Invalidates arrange for the node.

void	invalidateDraw ()
	Invalidates draw flag for the node.

void	invalidateFinalTransform ()
	Invalidates final transform for node.

void	invalidateMeasure ()
	Invalidates measure for the node.

void	invalidateRender ()
	Invalidates render for the node.

boolean	isAnyChangeFlagSet (EnumSet< PropertyTypeChangeFlag > flags)
	Checks if any of a set of change flags is set.

boolean	isAnyChildChangeFlagSet (EnumSet< PropertyTypeChangeFlag > flags)
	Checks if any of a set of change flags is set on a child.

boolean	isChangeFlagSet (PropertyTypeChangeFlag flag)
	Checks if a change flag is set.

boolean	isChildChangeFlagSet (PropertyTypeChangeFlag flag)
	Checks if a change flag is set on a child.

boolean	isClipChildren ()
	Gets the value of NodeMetadata::ClipChildrenProperty.

boolean	isEnabled ()
	Gets the value of NodeMetadata::EnabledProperty.

boolean	isFocusable ()
	Gets the value of the NodeMetadata::FocusableProperty.

boolean	isFocused ()
	Sets whether a node is an active focus node and can receive keyboard messages.

boolean	isHitTestable ()
	Gets the value of NodeMetadata::HitTestableProperty.

boolean	isHitTestableContainer ()
	Gets the value of NodeMetadata::HitTestableContainerProperty.

boolean	isHover ()
	Gets the value of NodeMetadata::HoverProperty.

boolean	isInvalidArrange ()
	Check if the node needs arrange.

boolean	isInvalidDraw ()
	Tells if node draw flag is invalid.

boolean	isInvalidFinalTransform ()
	Tells if final transform flag is invalid for node.

boolean	isInvalidMeasure ()
	Check if the node needs measure.

boolean	isInvalidRender ()
	Returns if node render flag is invalid.

boolean	isVisible ()
	Gets the value of NodeMetadata::VisibleProperty.

Iterable< NodeComponent >	iterateNodeComponents ()
	Gets an Iterable object used to iterate the Node Components.

T	lookupNode (String path)
	Returns a node of specified type by looking it up with specified path or alias.

NodeComponent	lookupNodeComponentByName (String name)
	Look up a Node Component by Name.

KanziObject	lookupObject (String path)
	Returns a KanziObject by looking it up with specified path or alias.

void	notifyResourceDictionaryModified ()
	Forces the re-evaluation of resource IDs in a node tree.

boolean	removeAbstractChild (Node child)
	Removes child node from this node.

void	removeBinding (AbstractBindingRuntime bindingRuntime)
	Removes a binding runtime added earlier.

void	removeBindingsWithOwner (KanziObject owner)
	Removes binding runtimes owned by a KanziObject.

void	removeMessageHandler (MessageSubscriptionToken token)
	Removes a message subscription.

void	removeNodeComponentWithOwner (KanziObject owner)
	Removes all node component bindings with the specified owner.

void	setActualDepth (float value)
	Sets the value of NodeMetadata::ActualDepthProperty.

void	setActualHeight (float value)
	Sets the value of NodeMetadata::ActualHeightProperty.

void	setActualWidth (float value)
	Sets the value of NodeMetadata::ActualWidthProperty.

void	setAutoHeight ()
	Sets node to automatically determine height.

void	setAutoWidth ()
	Sets node to automatically determine width.

AbstractBindingRuntime	setBinding (AbstractBinding binding)
	Sets a binding.

AbstractBindingRuntime	setBinding (AbstractBinding binding, PropertyType<?> propertyType)
	Sets a binding.

AbstractBindingRuntime	setBinding (AbstractBinding binding, PropertyType<?> propertyType, PropertyField propertyField)
	Sets a binding.

AbstractBindingRuntime	setBindingWithOwner (AbstractBinding binding, KanziObject owner, PropertyType<?> propertyType)
	Sets a binding with owner.

AbstractBindingRuntime	setBindingWithOwner (AbstractBinding binding, KanziObject owner, PropertyType<?> propertyType, PropertyField propertyField)
	Sets a binding with owner.

void	setChangeFlag (PropertyTypeChangeFlag flag)
	Sets a change flag.

void	setClipChildren (boolean value)
	Sets the value of NodeMetadata::ClipChildrenProperty.

void	setDepth (float value)
	Sets the value of NodeMetadata::DepthProperty.

void	setDepthMargin (Vector2 value)
	Sets the value of NodeMetadata::DepthMarginProperty.

void	setEnabled (boolean value)
	Sets the value of the NodeMetadata::EnabledProperty.

void	setFocusable (boolean value)
	Sets the value of the NodeMetadata::FocusableProperty.

void	setFocused (boolean value)
	Sets the value of the NodeMetadata::FocusedProperty.

void	setHeight (float value)
	Sets the value of NodeMetadata::HeightProperty.

void	setHitTestable (boolean value)
	Sets the value of NodeMetadata::HitTestableProperty.

void	setHitTestableContainer (boolean value)
	Sets the value of NodeMetadata::HitTestableContainerProperty.

void	setHorizontalMargin (Vector2 value)
	Sets the value of NodeMetadata::HorizontalMarginProperty.

void	setHover (boolean value)
	Sets the value of NodeMetadata::HoverProperty.

void	setLocale (String value)
	Sets the value of NodeMetadata::LocaleProperty.

AbstractBindingRuntime	setModifierBinding (AbstractBinding binding, PropertyType<?> propertyType)
	Sets a modifier binding.

AbstractBindingRuntime	setModifierBinding (AbstractBinding binding, PropertyType<?> propertyType, PropertyField propertyField)
	Sets a modifier binding.

AbstractBindingRuntime	setModifierBindingWithOwner (AbstractBinding binding, KanziObject owner, PropertyType<?> propertyType)
	Sets a modifier binding with owner.

AbstractBindingRuntime	setModifierBindingWithOwner (AbstractBinding binding, KanziObject owner, PropertyType<?> propertyType, PropertyField propertyField)
	Sets a modifier binding with owner.

void	setName (String name)
	Sets the value of NodeMetadata::NameProperty.

void	setOpacity (float value)
	Sets the value of NodeMetadata::OpacityProperty.

void	setStateManager (Resource value)
	Sets the value of NodeMetadata::StateManagerProperty.

void	setStyle (Resource value)
	Sets the value of NodeMetadata::StyleProperty.

void	setVerticalMargin (Vector2 value)
	Sets the value of NodeMetadata::VerticalMarginProperty.

void	setVisible (boolean value)
	Sets the value of NodeMetadata::VisibleProperty.

void	setWidth (float value)
	Sets the value of NodeMetadata::WidthProperty.

ObjectRef< TResourceType >	tryAcquireResource (ResourceID resourceId)
	Acquires a resource from the node or the node's closest ancestor having the resource id in the resource dictionary.

void	validateArrange ()
	Validates arrange for the node.

void	validateDraw ()
	Validates draw flags for the node.

void	validateMeasure ()
	Validates measure for the node.

void	validateRender ()
	Validates render for the node.

Public Member Functions inherited from NodeProxy
ResourceDictionary	acquireResourceDictionary ()
	Gets a resource dictionary of a node.

boolean	addAbstractChildOverride (Node child)

void	addAnonymousResource (Resource resource)
	Adds anonymous resource (such as style) for object node resources.

void	addInputManipulator (InputManipulator inputManipulator)
	Transfers the ownership and attaches an input manipulator to an object node.

void	addNodeComponent (NodeComponent nodeComponent)
	Transfers the ownership of a node component to an object node.

void	addResource (ResourceID resourceId, String resourceUrl)
	Adds a resource manager resource to an object node.

void	addResourceDictionary (ResourceDictionary resourceDictionary)
	Adds a nested resource dictionary to the resource dictionary of a node.

void	clearChangeFlag (long flag)
	Clears a change flag.

boolean	containsResource (ResourceID resourceID)
	Returns if object node resource dictionary contains the resource with given ID.

void	detachRecursive ()
	Detaches a node and its descendants.

int	getAbstractChildCountOverride ()

int	getAbstractChildIndexOverride (Node node)

Node	getAbstractChildOverride (int index)

long	getChangeFlags ()
	Get current change flags.

long	getChildChangeFlags ()
	Get current child change flags.

ResourceDictionary	getResourceDictionary ()
	If a node has a resource dictionary, returns the resource dictionary of that node.

boolean	isAttached ()
	Gets the attached status.

boolean	isAttaching ()
	Gets the attaching status.

boolean	isDetaching ()
	Gets the detaching status.

boolean	isEffectivelyEnabled ()
	Returns the value of EffectivelyEnabledProperty.

boolean	isEffectivelyFocusable ()
	Returns whether a node is focusable.

boolean	isEffectivelyVisible ()
	Returns whether a node and its ancestor nodes are visible.

boolean	isInitialized ()
	Gets the initialized status.

boolean	isNamed (String name)
	Checks if the node has the given name.

boolean	removeAbstractChildOverride (Node child)

void	removeAnonymousResource (Resource resource)
	Removes anonymous resource from object node resources.

void	removeInputManipulator (InputManipulator inputManipulator)
	Removes the ownership and detaches an input manipulator from an object node.

void	removeNodeComponent (NodeComponent nodeComponent)
	Removes the ownership of a node component from an object node.

void	removeResource (ResourceID resourceId)
	Removes a resource with given ID from object node resource dictionary.

void	setChangeFlag (long flag)
	Sets a change flag.

void	setResourceDictionary (ResourceDictionary resourceDictionary)
	Replaces the resource dictionary of a node.

Node	trySetFocus ()
	Tries to move the focus to this node.

Node	trySetFocus (FocusFallback fallbackOption)
	Tries to set the focus to the newFocusNode using FocusManager.trySetFocus() but with a fallback behavior in case the node does not gain focus.

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 = com.rightware.kanzi.metadata.NodeMetadata.metaclass
	The Metaclass for the class.

Static Public Attributes inherited from NodeProxy
static final Metaclass	metaclass = com.rightware.kanzi.metadata.NodeMetadata.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.

Additional Inherited Members
Static Public Member Functions inherited from NodeProxy
static boolean	isUnboundedLayoutValue (float layoutValue)
	Indicates whether a value is an unbound layout value.

static boolean	isValidLayoutValue (float value)
	Indicates whether a value is valid layout value.

static float	unboundedLayoutValue ()
	Returns an unbounded layout value.

Public Attributes inherited from NodeMetadata
DynamicPropertyType< Float >	ActualDepthProperty
	The calculated size of the node in depth direction when used in a layout.

DynamicPropertyType< Float >	ActualHeightProperty
	The calculated height of the node when used in a layout.

DynamicPropertyType< Float >	ActualWidthProperty
	The calculated width of the node when used in a layout.

DynamicPropertyType< Boolean >	ClipChildrenProperty
	Sets whether to clip the child nodes of this node.

DynamicPropertyType< NodeEnums.ContentStretch >	ContentStretchProperty
	Sets how the content that belongs to this node is stretched (as opposed to manipulating the actual node size).

DynamicPropertyType< Boolean >	CreatedFromKZBProperty
	Kanzi internally uses this property to distinguish objects like bindings and triggers created in code from objects that are loaded from a kzb file.

DynamicPropertyType< NodeEnums.DepthAlignment >	DepthAlignmentProperty
	The alignment in depth direction the node should use when it resides under a layout.

DynamicPropertyType< Vector2 >	DepthMarginProperty
	Sets the depth distance between this node and other nodes that are adjacent to this node in a layout.

DynamicPropertyType< Float >	DepthProperty = new DynamicPropertyType<>("Node.Depth", Float.class)
	The size of the node in depth direction when used in a layout.

DynamicPropertyType< Boolean >	EffectivelyEnabledProperty
	Indicates whether this node and its ancestor nodes are enabled.

DynamicPropertyType< Boolean >	EnabledProperty
	Whether this node is enabled.

DynamicPropertyType< Boolean >	FocusableProperty
	Indicates whether the node can receive focus.

DynamicPropertyType< Boolean >	FocusedProperty
	Indicates whether the node has the key focus.

DynamicPropertyType< FocusState >	FocusStateProperty
	Reports the focus state of a node:

DynamicPropertyType< Resource >	FontFamilyProperty
	The font family used to render the text.

DynamicPropertyType< Float >	HeightProperty
	The height of the node when used in a layout.

DynamicPropertyType< Boolean >	HitTestableContainerProperty
	When enabled, Kanzi uses the layout bounds as geometry for hit testing.

DynamicPropertyType< Boolean >	HitTestableProperty
	When enabled, the node can be hit tested.

DynamicPropertyType< NodeEnums.HorizontalAlignment >	HorizontalAlignmentProperty
	The alignment in horizontal direction the node should use when it resides under a layout.

DynamicPropertyType< Vector2 >	HorizontalMarginProperty
	Sets the horizontal space between this node and other nodes that are adjacent to this node in a layout.

DynamicPropertyType< Boolean >	HoverProperty
	Indicates whether a node is the foremost hit testable node under the cursor.

DynamicPropertyType< String >	LocaleProperty
	The locale of the node.

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

DynamicPropertyType< String >	NameProperty = new DynamicPropertyType<>("Node.Name", String.class)
	Node name.

DynamicPropertyType< Float >	OpacityProperty
	Opacity of the node.

DynamicPropertyType< String >	PathProperty = new DynamicPropertyType<>("Node.Path", String.class)
	Full path to the node.

DynamicPropertyType< Float >	Projection2DTo3DScaleProperty
	Sets the scale factor to project pixels to 3D size.

DynamicPropertyType< Resource >	StateManagerProperty
	Sets the State Manager to the node.

DynamicPropertyType< Resource >	StyleProperty
	Sets a style to the node.

DynamicPropertyType< NodeEnums.VerticalAlignment >	VerticalAlignmentProperty
	The alignment in vertical direction the node should use when it resides under a layout.

DynamicPropertyType< Vector2 >	VerticalMarginProperty
	Sets the vertical space between this node and other nodes that are adjacent to this node in a layout.

DynamicPropertyType< Float >	VisibleAmountInParentProperty
	Sets the amount the node is inside its parent.

DynamicPropertyType< Boolean >	VisibleProperty
	When disabled, Kanzi does not render the node.

DynamicPropertyType< Float >	WidthProperty = new DynamicPropertyType<>("Node.Width", Float.class)
	The width of the node when used in a layout.

Detailed Description

Base class for Kanzi nodes.

Member Function Documentation

◆ acquireResource()

ObjectRef< TResourceType > acquireResource ( ResourceID resourceId ) throws ObjectNotFoundException

Acquires a resource from the node or the node's closest ancestor having the resource id in the resource dictionary.

If the resource id maps to a resource url, but the url doesn't map to any resource, throws an exception.

Parameters

resourceId Name of the resource.

Returns: The acquired resource

Exceptions

ObjectNotFoundException Throws a ObjectNotFoundException when the resourceId is not found.

◆ acquireResourcesAsync()

ResourceManager.AcquireTask acquireResourcesAsync	(	ResourceID	resourceId,
		ResourceManager.AcquireTask.Callback	callback )

Posts an asynchronous task to acquire a resource.

Parameters

resourceId	Name of the resource.
callback	Callback function that this function calls when resource loading is completed.

Returns: Handle to the async load task. You can pass the handle to ResourceManager::wait(ResourceManager.AcquireTask) to wait for the completion of the load.

◆ addAbstractChild()

boolean addAbstractChild ( Node child )

Adds a node as child of this node.

Parameters

child Node to add as child.

Returns: True if operation was successful, otherwise false.

◆ addMessageFilter()

MessageSubscriptionToken addMessageFilter	(	MessageType< MessageArgumentsType >	messageType,
		MessageSubscriptionFunction< MessageArgumentsType >	messageHandlerFunction )

Adds a message filter where the filter is a function.

The filter is invoked when a message of messageType bubbles through the node the filter is added to.

Parameters

messageType	The message type to listen to.
messageHandlerFunction	The function invoked when the node that owns the filter receives a matching message.
<MessageArgumentsType>	The message arguments class associated with the message type.

Returns: The MessageSubscriptionToken which identifies the added filter.

◆ addMessageHandler() [1/2]

MessageSubscriptionToken addMessageHandler	(	MessageType< MessageArgumentsType >	messageType,
		MessageSubscriptionFunction< MessageArgumentsType >	messageHandlerFunction )

Adds a message handler where the handler is a function.

The handler is invoked when a message of messageType is signaled in the node the handler is added to.

Parameters

messageType	The message type to listen to.
messageHandlerFunction	The function invoked when the node that owns the handler receives a matching message. The source of the message has to be the node itself.
<MessageArgumentsType>	The message arguments class associated with the message type.

Returns: The MessageSubscriptionToken which identifies the added handler.

◆ addMessageHandler() [2/2]

MessageSubscriptionToken addMessageHandler	(	MessageType< MessageArgumentsType >	messageType,
		MessageSubscriptionFunction< MessageArgumentsType >	messageHandlerFunction,
		Node	messageSourceFilter )

Adds a message handler where the handler is a function.

The handler is invoked when a message of messageType from the source specified is signaled in the node the handler is added to.

Parameters

messageType	The message type to listen to.
messageHandlerFunction	The function invoked when the node that owns the handler receives a matching message.
messageSourceFilter	The handler will only be called when the message is from this source.
<MessageArgumentsType>	The message arguments class associated with the message type.

Returns: The MessageSubscriptionToken which identifies the added handler.

◆ addNodeComponentWithOwner()

void addNodeComponentWithOwner	(	NodeComponent	component,
		KanziObject	owner )

Transfers the ownership of a node component to an object node and sets the owner of the node component.

Parameters

component	The component being added.
owner	The Kanzi object that owns the lifetime of the component.

◆ addTunnelingMessageFilter()

MessageSubscriptionToken addTunnelingMessageFilter	(	MessageType< MessageArgumentsType >	messageType,
		MessageSubscriptionFunction< MessageArgumentsType >	messageHandlerFunction )

Adds a message filter where the filter is a function.

The filter is invoked when a message of messageType tunnels through the node to which you add this filter.

Parameters

messageType	The message type to listen to.
messageHandlerFunction	The function invoked when the node that owns the filter receives a matching message.
<MessageArgumentsType>	The message arguments class associated with the message type.

Returns: The MessageSubscriptionToken which identifies the added filter.

◆ addTunnelingMessageHandler()

MessageSubscriptionToken addTunnelingMessageHandler	(	MessageType< MessageArgumentsType >	messageType,
		MessageSubscriptionFunction< MessageArgumentsType >	messageHandlerFunction,
		Node	messageSourceFilter )

Adds a message handler where the handler is a function and you explicitly define the accepted source.

The handler is invoked when a message of messageType tunnels through the node to which you add the handler, but only when you dispatch it from the given source node.

Parameters

messageType	The message type to listen to.
messageHandlerFunction	The function invoked when the node that owns the handler receives a matching message. The source of the message has to be the node itself.
messageSourceFilter	Source node of the messages.
<MessageArgumentsType>	The message arguments class associated with the message type.

Returns: The MessageSubscriptionToken which identifies the added handler.

◆ attachRecursive()

void attachRecursive ( )

Attaches an object node and its children recursively.

Reimplemented from NodeProxy.

◆ clearChangeFlag()

void clearChangeFlag ( PropertyTypeChangeFlag flag )

Clears a change flag.

Parameters

flag	The flag to clear

◆ dispatchMessage()

void dispatchMessage	(	MessageType< MessageArgumentsType >	messageType,
		MessageArgumentsType	arguments )

Dispatches a message from this node with specified arguments.

Parameters

messageType	The type of the dispatched message.
arguments	The arguments of the dispatched message.
<MessageArgumentsType>	The message arguments class associated with the message type.

◆ findResourceUrl()

String findResourceUrl ( ResourceID resourceId )

Tries to find Resource URL for Resource ID from this node.

Parameters

resourceId Resource id to find.

Returns: Resource url of resource, can be null if resource was not found.

◆ getAbstractChild()

Node getAbstractChild ( int index )

Returns node at given child index.

Parameters

index Index of the node to get.

Returns: Node at given child index.

◆ getAbstractChildCount()

int getAbstractChildCount ( )

Returns number of child nodes.

Returns: Number of child nodes.

◆ getAbstractChildIndex()

int getAbstractChildIndex ( Node node )

Returns index of given node in list of child nodes.

Parameters

node	Node to get child index.

Returns: Index of given node in list of child nodes.

◆ getActualDepth()

float getActualDepth ( )

Gets the value of NodeMetadata::ActualDepthProperty.

Returns: Current value.

◆ getActualHeight()

float getActualHeight ( )

Gets the value of NodeMetadata::ActualHeightProperty.

Returns: Current value.

◆ getActualWidth()

float getActualWidth ( )

Gets the value of NodeMetadata::ActualWidthProperty.

Returns: Current value.

◆ getDepth()

float getDepth ( )

Gets the value of NodeMetadata::DepthProperty.

Returns: Current value.

◆ getDepthMargin()

Vector2 getDepthMargin ( )

Gets the value of NodeMetadata::DepthMarginProperty.

Returns: Current value.

◆ getHeight()

float getHeight ( )

Gets the value of NodeMetadata::HeightProperty.

Returns: Current value.

◆ getHorizontalMargin()

Vector2 getHorizontalMargin ( )

Gets the value of NodeMetadata::HorizontalMarginProperty.

Returns: Current value.

◆ getLocale()

String getLocale ( )

Gets the value of NodeMetadata::LocaleProperty.

Returns: Current value.

◆ getName()

String getName ( )

Gets the value of NodeMetadata::NameProperty.

Returns: Name of the node.

◆ getOpacity()

float getOpacity ( )

Gets the value of NodeMetadata::OpacityProperty.

Returns: Current value.

◆ getParent()

Node getParent ( )

Gets parent of this node.

Returns: Parent of this node.

◆ getPath()

String getPath ( )

Gets the value of NodeMetadata::PathProperty.

Returns: Path of the node.

◆ getStateManager()

Resource getStateManager ( )

Gets the value of NodeMetadata::StateManagerProperty.

Returns: Current value of NodeMetadata::StateManagerProperty.

◆ getStyle()

Resource getStyle ( )

Gets the value of NodeMetadata::StyleProperty.

Returns: Current value of the NodeMetadata::StyleProperty.

◆ getVerticalMargin()

Vector2 getVerticalMargin ( )

Gets the value of NodeMetadata::VerticalMarginProperty.

Returns: Current value.

◆ getWidth()

float getWidth ( )

Gets the value of NodeMetadata::WidthProperty.

Returns: Current value.

◆ isAnyChangeFlagSet()

boolean isAnyChangeFlagSet ( EnumSet< PropertyTypeChangeFlag > flags )

Checks if any of a set of change flags is set.

Parameters

flags The set of flags to check

Returns: True if any of the flags is set, else false.

◆ isAnyChildChangeFlagSet()

boolean isAnyChildChangeFlagSet ( EnumSet< PropertyTypeChangeFlag > flags )

Checks if any of a set of change flags is set on a child.

Parameters

flags The set of flags to check

Returns: True if any of the flags is set, else false.

◆ isChangeFlagSet()

boolean isChangeFlagSet ( PropertyTypeChangeFlag flag )

Checks if a change flag is set.

Parameters

flag	The flag to check

Returns: True if the flag is set, else false.

◆ isChildChangeFlagSet()

boolean isChildChangeFlagSet ( PropertyTypeChangeFlag flag )

Checks if a change flag is set on a child.

Parameters

flag	The flag to check

Returns: True if the flag is set, else false.

◆ isClipChildren()

boolean isClipChildren ( )

Gets the value of NodeMetadata::ClipChildrenProperty.

Returns: Current value.

◆ isEnabled()

boolean isEnabled ( )

Gets the value of NodeMetadata::EnabledProperty.

Returns: Current value.

◆ isFocusable()

boolean isFocusable ( )

Gets the value of the NodeMetadata::FocusableProperty.

Returns: Current value.

◆ isFocused()

boolean isFocused ( )

Sets whether a node is an active focus node and can receive keyboard messages.

In a Kanzi application only one node at a time can have active focus. The default value is false.

Returns: Current value of NodeMetadata::FocusedProperty.

◆ isHitTestable()

boolean isHitTestable ( )

Gets the value of NodeMetadata::HitTestableProperty.

Returns: Current value.

◆ isHitTestableContainer()

boolean isHitTestableContainer ( )

Gets the value of NodeMetadata::HitTestableContainerProperty.

Returns: Current value.

◆ isHover()

boolean isHover ( )

Gets the value of NodeMetadata::HoverProperty.

Returns: Current value.

◆ isInvalidArrange()

boolean isInvalidArrange ( )

Check if the node needs arrange.

Returns: True if the arrange change flag is set, else false.

◆ isInvalidDraw()

boolean isInvalidDraw ( )

Tells if node draw flag is invalid.

Returns: True if the Draw change flag is set, else false.

◆ isInvalidFinalTransform()

boolean isInvalidFinalTransform ( )

Tells if final transform flag is invalid for node.

Returns: True if the final transform change flag is set, else false.

◆ isInvalidMeasure()

boolean isInvalidMeasure ( )

Check if the node needs measure.

Returns: True if the measure change flag is set, else false.

◆ isInvalidRender()

boolean isInvalidRender ( )

Returns if node render flag is invalid.

Returns: True if the render change flag is set, else false.

◆ isVisible()

boolean isVisible ( )

Gets the value of NodeMetadata::VisibleProperty.

Returns: Current value.

◆ iterateNodeComponents()

Iterable< NodeComponent > iterateNodeComponents ( )

Gets an Iterable object used to iterate the Node Components.

Returns: An iterable of Node Components.

◆ lookupNode()

T lookupNode ( String path )

Returns a node of specified type by looking it up with specified path or alias.

Parameters

path	Path to use for relative lookup.
<T>	Type of the node.

Returns: Node that was found, or null if the node was not found.

Exceptions

IllegalArgumentException Throws an IllegalArgumentException if the path is malformed.

◆ lookupNodeComponentByName()

NodeComponent lookupNodeComponentByName ( String name )

Look up a Node Component by Name.

Parameters

name	The search name

Returns: The Node Component that has been found, or null if no node component was found.

◆ lookupObject()

KanziObject lookupObject ( String path )

Returns a KanziObject by looking it up with specified path or alias.

Object found may be another node or a resource within a node.

Parameters

path	Relative path to use for lookup.

Returns: Item found as KanziObject. May be null if no object found.

Exceptions

IllegalArgumentException Throws an IllegalArgumentException if the path is malformed.

Reimplemented from NodeProxy.

◆ notifyResourceDictionaryModified()

void notifyResourceDictionaryModified ( )

Forces the re-evaluation of resource IDs in a node tree.

If you modify a resource dictionary of a node that is already attached, you can use this function to update the resource properties. Note that you need to use this function only if you modify the dictionary directly through com.rightware.kanzi.Node#getResourceDictionary() or com.rightware.kanzi.Node#acquireResourceDictionary(). If you use other Node class functions like addResource(ResourceID, String) or com.rightware.kanzi.Node#setResourceDictionary(ResourceDictionary), you do not need to call this function.

Reimplemented from NodeProxy.

◆ removeAbstractChild()

boolean removeAbstractChild ( Node child )

Removes child node from this node.

Parameters

child Child node to remove.

Returns: True if the operation was successful, otherwise false.

binding Binding to set.

Returns: Binding runtime created for the binding.

◆ setBinding() [2/3]

AbstractBindingRuntime setBinding	(	AbstractBinding	binding,
		PropertyType<?>	propertyType )

Sets a binding.

Local precedence is used.

Parameters

binding	Binding to set.
propertyType	Target property type.

Returns: Binding runtime created for the binding.

◆ setBinding() [3/3]

AbstractBindingRuntime setBinding	(	AbstractBinding	binding,
		PropertyType<?>	propertyType,
		PropertyField	propertyField )

Sets a binding.

Local precedence is used.

Parameters

binding	Binding to set.
propertyType	Target property type.
propertyField	Property field.

Returns: Binding runtime created for the binding.

◆ setBindingWithOwner() [1/2]

AbstractBindingRuntime setBindingWithOwner	(	AbstractBinding	binding,
		KanziObject	owner,
		PropertyType<?>	propertyType )

Sets a binding with owner.

Local precedence is used.

Parameters

binding	Binding to set.
owner	The Kanzi Object owning this binding.
propertyType	Target property type.

Returns: Binding runtime created for the binding.

◆ setBindingWithOwner() [2/2]

AbstractBindingRuntime setBindingWithOwner	(	AbstractBinding	binding,
		KanziObject	owner,
		PropertyType<?>	propertyType,
		PropertyField	propertyField )

Sets a binding with owner.

Local precedence is used.

Parameters

binding	Binding to set.
owner	The Kanzi Object owning this binding.
propertyType	Target property type.
propertyField	Property field.

Returns: Binding runtime created for the binding.

◆ setChangeFlag()

void setChangeFlag ( PropertyTypeChangeFlag flag )

Sets a change flag.

Parameters

flag	The flag to set

◆ setModifierBinding() [1/2]

AbstractBindingRuntime setModifierBinding	(	AbstractBinding	binding,
		PropertyType<?>	propertyType )

Sets a modifier binding.

As opposed to value source created by setBinding(), creates a property modifier binding.

Parameters

binding	Binding to set.
propertyType	Target property type.

Returns: Binding runtime created for the binding.

◆ setModifierBinding() [2/2]

AbstractBindingRuntime setModifierBinding	(	AbstractBinding	binding,
		PropertyType<?>	propertyType,
		PropertyField	propertyField )

Sets a modifier binding.

As opposed to value source created by setBinding(), creates a property modifier binding.

Parameters

binding	Binding to set.
propertyType	Target property type.
propertyField	Property field.

Returns: Binding runtime created for the binding.

◆ setModifierBindingWithOwner() [1/2]

AbstractBindingRuntime setModifierBindingWithOwner	(	AbstractBinding	binding,
		KanziObject	owner,
		PropertyType<?>	propertyType )

Sets a modifier binding with owner.

As opposed to value source created by setBinding(), creates a property modifier binding.

Parameters

binding	Binding to set.
owner	The Kanzi Object owning this binding.
propertyType	Target property type.

Returns: Binding runtime created for the binding.

◆ setModifierBindingWithOwner() [2/2]

AbstractBindingRuntime setModifierBindingWithOwner	(	AbstractBinding	binding,
		KanziObject	owner,
		PropertyType<?>	propertyType,
		PropertyField	propertyField )

Sets a modifier binding with owner.

As opposed to value source created by setBinding(), creates a property modifier binding.

Parameters

binding	Binding to set.
owner	The Kanzi Object owning this binding.
propertyType	Target property type.
propertyField	Property field.

Returns: Binding runtime created for the binding.

◆ setName()

void setName ( String name )

Sets the value of NodeMetadata::NameProperty.

Parameters

name	New name to assign.

◆ tryAcquireResource()

ObjectRef< TResourceType > tryAcquireResource ( ResourceID resourceId )

Acquires a resource from the node or the node's closest ancestor having the resource id in the resource dictionary.

Parameters

resourceId Name of the resource.

Returns: The acquired resource, or null if the resource id or resource url doesn't map to any resource.

Classes

Public Member Functions

Static Public Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ acquireResource()

◆ acquireResourcesAsync()

◆ addAbstractChild()

◆ addMessageFilter()

◆ addMessageHandler() [1/2]

◆ addMessageHandler() [2/2]

◆ addNodeComponentWithOwner()

◆ addTunnelingMessageFilter()

◆ addTunnelingMessageHandler()

◆ attachRecursive()

◆ clearChangeFlag()

◆ dispatchMessage()

◆ findResourceUrl()

◆ getAbstractChild()

◆ getAbstractChildCount()

◆ getAbstractChildIndex()

◆ getActualDepth()

◆ getActualHeight()

◆ getActualWidth()

◆ getDepth()

◆ getDepthMargin()

◆ getHeight()

◆ getHorizontalMargin()

◆ getLocale()

◆ getName()

◆ getOpacity()

◆ getParent()

◆ getPath()

◆ getStateManager()

◆ getStyle()

◆ getVerticalMargin()

◆ getWidth()

◆ isAnyChangeFlagSet()

◆ isAnyChildChangeFlagSet()

◆ isChangeFlagSet()

◆ isChildChangeFlagSet()

◆ isClipChildren()

◆ isEnabled()

◆ isFocusable()

◆ isFocused()

◆ isHitTestable()

◆ isHitTestableContainer()

◆ isHover()

◆ isInvalidArrange()

◆ isInvalidDraw()

◆ isInvalidFinalTransform()

◆ isInvalidMeasure()

◆ isInvalidRender()

◆ isVisible()

◆ iterateNodeComponents()

◆ lookupNode()

◆ lookupNodeComponentByName()

◆ lookupObject()

◆ notifyResourceDictionaryModified()

◆ removeAbstractChild()

◆ removeBinding()

◆ removeBindingsWithOwner()

◆ removeMessageHandler()

◆ removeNodeComponentWithOwner()

◆ setActualDepth()

◆ setActualHeight()

◆ setActualWidth()

◆ setBinding() [1/3]

◆ setBinding() [2/3]

◆ setBinding() [3/3]

◆ setBindingWithOwner() [1/2]

◆ setBindingWithOwner() [2/2]

◆ setChangeFlag()

◆ setClipChildren()

◆ setDepth()

◆ setDepthMargin()

◆ setEnabled()

◆ setFocusable()

◆ setFocused()