Expression binding source collects expression value sources and executes operations on the values to produce a read result. More...

#include <kanzi/core.ui/binding/expression_binding_source.hpp>

Inheritance diagram for kanzi::ExpressionBindingSource:

[legend]

Public Types
typedef vector< BindingExpressionOpCode >	BindingOperationContainer
	Container for binding expressions.

typedef vector< AbstractExpressionValueSourceSharedPtr >	ValueSourceContainer
	Container for expression value source create info.

Public Member Functions
BindingOperationContainer::iterator	beginBindingOperations ()
	Gets an iterator to the beginning of binding operations.

BindingOperationContainer::const_iterator	beginBindingOperations () const
	Gets an iterator to the beginning of binding operations.

ValueSourceContainer::const_iterator	beginDataSources () const
	Gets an iterator to the beginning of create infos for data source expression value sources.

AbstractBinding::BindingProcessorContainer::iterator	beginOperationProcessors ()
	Gets an iterator to the beginning of binding operation processors.

AbstractBinding::BindingProcessorContainer::const_iterator	beginOperationProcessors () const
	Gets an iterator to the beginning of binding operation processors.

ValueSourceContainer::const_iterator	beginValueSources () const
	Gets an iterator to the beginning of create infos for expression value sources.

BindingOperationContainer::iterator	endBindingOperations ()
	Gets an iterator to the end of binding operations.

BindingOperationContainer::const_iterator	endBindingOperations () const
	Gets an iterator to the end of binding operations.

ValueSourceContainer::const_iterator	endDataSources () const
	Gets an iterator to the end of create infos for data source expression value sources.

AbstractBinding::BindingProcessorContainer::iterator	endOperationProcessors ()
	Gets an iterator to the end of binding operation processors.

AbstractBinding::BindingProcessorContainer::const_iterator	endOperationProcessors () const
	Gets an iterator to the end of binding operation processors.

ValueSourceContainer::const_iterator	endValueSources () const
	Gets an iterator to the end of create infos for expression value sources.

Variant *	getTemporaryRegister (size_t idx)
	Accesses temporary register.

const Variant *	getTemporaryRegister (size_t idx) const
	Accesses temporary register.

bool	hasFixedOperations () const
	Tells if the source contains fixed operations.

bool	isCurrentValueRequired () const
	Tells if current value is required.

Variant *	resolveRegister (BindingExpressionArgumentType argumentType)
	Resolve register by index.

Public Member Functions inherited from kanzi::BindingSource
BindingSourceRuntimePtr	createRuntime ()
	Creates binding source runtime.

virtual	~BindingSource ()
	Destructor.

Static Public Member Functions
static BindingSourcePtr	create (const BindingOperationContainer operations, const AbstractBinding::BindingProcessorContainer operationProcessors, const ValueSourceContainer &valueSources, const ValueSourceContainer &dataSources, const vector< Variant > &constantRegisters, size_t temporaryCount)
	Creates an expression binding source.

static BindingSourcePtr	create (const BindingOperationContainer operations, const ValueSourceContainer &valueSources, const ValueSourceContainer &dataSources, const vector< Variant > &constantRegisters, size_t temporaryCount)
	Creates an expression binding source.

static BindingSourcePtr	create (const BindingOperationContainer operations, const ValueSourceContainer &valueSources, const vector< Variant > &constantRegisters, size_t temporaryCount)
	Creates an expression binding source.

static BindingSourcePtr	create (string_view path, AbstractPropertyType propertyType, PropertyField field)
	Creates an object property binding source.

Protected Member Functions
BindingSourceRuntimePtr	createRuntimeOverride () override
	BindingSource::createRuntime implementation.

	ExpressionBindingSource (const BindingOperationContainer operations, const AbstractBinding::BindingProcessorContainer operationProcessors, const ValueSourceContainer &valueSources, const ValueSourceContainer &dataSources, const vector< Variant > &constantRegisters, size_t temporaryCount)
	Constructor.

Protected Member Functions inherited from kanzi::BindingSource
	BindingSource ()
	Constructor.

Protected Attributes
ValueSourceContainer	m_dataSources
	Data source expression value sources.

bool	m_hasFixedOperations
	Tells whether or not the binding contains fixed operations.

bool	m_isCurrentValueRequired
	Tells if current value is required.

AbstractBinding::BindingProcessorContainer	m_operationProcessors
	Binding operation processors that you can refer to from individual binding ops.

BindingOperationContainer	m_operations
	Binding operations.

vector< Variant >	m_registers [2]
	Registers for the expression binding source.

ValueSourceContainer	m_valueSources
	Expression value sources.

Detailed Description

Expression binding source collects expression value sources and executes operations on the values to produce a read result.

Since: Kanzi 3.7.0

Member Typedef Documentation

◆ ValueSourceContainer

typedef vector<AbstractExpressionValueSourceSharedPtr> kanzi::ExpressionBindingSource::ValueSourceContainer

Container for expression value source create info.

◆ BindingOperationContainer

typedef vector<BindingExpressionOpCode> kanzi::ExpressionBindingSource::BindingOperationContainer

Container for binding expressions.

Constructor & Destructor Documentation

◆ ExpressionBindingSource()

kanzi::ExpressionBindingSource::ExpressionBindingSource	(	const BindingOperationContainer	operations,
		const AbstractBinding::BindingProcessorContainer	operationProcessors,
		const ValueSourceContainer &	valueSources,
		const ValueSourceContainer &	dataSources,
		const vector< Variant > &	constantRegisters,
		size_t	temporaryCount )

protected

Constructor.

Parameters

operations	Binding operations.
operationProcessors	Binding processors for the binding operations.
valueSources	Binding expression value sources for the expression binding source.
dataSources	Binding expression data sources for the expression binding source.
constantRegisters	Constant registers.
temporaryCount	Number of temporary registers.

Member Function Documentation

◆ create() [1/4]

static BindingSourcePtr kanzi::ExpressionBindingSource::create	(	const BindingOperationContainer	operations,
		const AbstractBinding::BindingProcessorContainer	operationProcessors,
		const ValueSourceContainer &	valueSources,
		const ValueSourceContainer &	dataSources,
		const vector< Variant > &	constantRegisters,
		size_t	temporaryCount )

static

Creates an expression binding source.

Parameters

operations	Binding operations.
operationProcessors	Binding processors for the binding operations.
valueSources	Binding expression value sources for the expression binding source.
dataSources	Binding expression data sources for the expression binding source.
constantRegisters	Constant registers.
temporaryCount	Number of temporary registers.

Returns: The created expression binding source.

◆ create() [2/4]

static BindingSourcePtr kanzi::ExpressionBindingSource::create	(	const BindingOperationContainer	operations,
		const ValueSourceContainer &	valueSources,
		const ValueSourceContainer &	dataSources,
		const vector< Variant > &	constantRegisters,
		size_t	temporaryCount )

inlinestatic

Creates an expression binding source.

No operation binding processors are specified.

Parameters

operations	Binding operations.
valueSources	Binding expression value sources for the expression binding source.
dataSources	Binding expression data sources for the expression binding source.
constantRegisters	Constant registers.
temporaryCount	Number of temporary registers.

Returns: The created expression binding source.

◆ create() [3/4]

static BindingSourcePtr kanzi::ExpressionBindingSource::create	(	const BindingOperationContainer	operations,
		const ValueSourceContainer &	valueSources,
		const vector< Variant > &	constantRegisters,
		size_t	temporaryCount )

inlinestatic

Creates an expression binding source.

No operation binding processors or data sources are specified.

Parameters

operations	Binding operations.
valueSources	Binding expression value sources for the expression binding source.
constantRegisters	Constant registers.
temporaryCount	Number of temporary registers.

Returns: The created expression binding source.

◆ create() [4/4]

static BindingSourcePtr kanzi::ExpressionBindingSource::create	(	string_view	path,
		AbstractPropertyType	propertyType,
		PropertyField	field )

static

Creates an object property binding source.

Creates one WRITE directive.

Parameters

path	Path to object.
propertyType	Property type to listen to.
field	Property field to read.

Returns: The created object property binding source.

◆ beginValueSources()

ValueSourceContainer::const_iterator kanzi::ExpressionBindingSource::beginValueSources ( ) const

inline

Gets an iterator to the beginning of create infos for expression value sources.

Returns: Const iterator.

◆ endValueSources()

ValueSourceContainer::const_iterator kanzi::ExpressionBindingSource::endValueSources ( ) const

inline

Gets an iterator to the end of create infos for expression value sources.

Returns: Const iterator.

◆ beginDataSources()

ValueSourceContainer::const_iterator kanzi::ExpressionBindingSource::beginDataSources ( ) const

inline

Gets an iterator to the beginning of create infos for data source expression value sources.

Returns: Const iterator.

◆ endDataSources()

ValueSourceContainer::const_iterator kanzi::ExpressionBindingSource::endDataSources ( ) const

inline

Gets an iterator to the end of create infos for data source expression value sources.

Returns: Const iterator.

◆ beginBindingOperations() [1/2]

BindingOperationContainer::iterator kanzi::ExpressionBindingSource::beginBindingOperations ( )

inline

Gets an iterator to the beginning of binding operations.

Returns: Iterator.

◆ beginBindingOperations() [2/2]

BindingOperationContainer::const_iterator kanzi::ExpressionBindingSource::beginBindingOperations ( ) const

inline

Gets an iterator to the beginning of binding operations.

Returns: Iterator.

◆ endBindingOperations() [1/2]

BindingOperationContainer::iterator kanzi::ExpressionBindingSource::endBindingOperations ( )

inline

Gets an iterator to the end of binding operations.

Returns: Iterator.

◆ endBindingOperations() [2/2]

BindingOperationContainer::const_iterator kanzi::ExpressionBindingSource::endBindingOperations ( ) const

inline

Gets an iterator to the end of binding operations.

Returns: Const iterator.

◆ beginOperationProcessors() [1/2]

AbstractBinding::BindingProcessorContainer::iterator kanzi::ExpressionBindingSource::beginOperationProcessors ( )

inline

Gets an iterator to the beginning of binding operation processors.

Returns: Iterator.

◆ beginOperationProcessors() [2/2]

AbstractBinding::BindingProcessorContainer::const_iterator kanzi::ExpressionBindingSource::beginOperationProcessors ( ) const

inline

Gets an iterator to the beginning of binding operation processors.

Returns: Const iterator.

◆ endOperationProcessors() [1/2]

AbstractBinding::BindingProcessorContainer::iterator kanzi::ExpressionBindingSource::endOperationProcessors ( )

inline

Gets an iterator to the end of binding operation processors.

Returns: Iterator.

◆ endOperationProcessors() [2/2]

AbstractBinding::BindingProcessorContainer::const_iterator kanzi::ExpressionBindingSource::endOperationProcessors ( ) const

inline

Gets an iterator to the end of binding operation processors.

Returns: Const iterator.

◆ getTemporaryRegister() [1/2]

Variant * kanzi::ExpressionBindingSource::getTemporaryRegister ( size_t idx )

inline

Accesses temporary register.

Parameters

idx Index.

Returns: Reference to temporary register.

◆ getTemporaryRegister() [2/2]

const Variant * kanzi::ExpressionBindingSource::getTemporaryRegister ( size_t idx ) const

inline

Accesses temporary register.

Parameters

idx Index.

Returns: Reference to temporary register.

◆ isCurrentValueRequired()

bool kanzi::ExpressionBindingSource::isCurrentValueRequired ( ) const

inline

Tells if current value is required.

If current value is required, the binding can only be executed when the value has been provided.

Returns: True if current value is required, false otherwise.

◆ hasFixedOperations()

bool kanzi::ExpressionBindingSource::hasFixedOperations ( ) const

inline

Tells if the source contains fixed operations.

Fixed operations imply manual execution, and will not trigger the binding when source value changes.

Returns: True if there are fixed ops, false otherwise.

◆ resolveRegister()

Variant * kanzi::ExpressionBindingSource::resolveRegister ( BindingExpressionArgumentType argumentType )

Resolve register by index.

Parameters

argumentType Argument to resolve.

Returns: Pointer to variant.

◆ createRuntimeOverride()

BindingSourceRuntimePtr kanzi::ExpressionBindingSource::createRuntimeOverride ( )

overrideprotectedvirtual

BindingSource::createRuntime implementation.

Implements kanzi::BindingSource.

Member Data Documentation

◆ m_operations

BindingOperationContainer kanzi::ExpressionBindingSource::m_operations

protected

Binding operations.

◆ m_operationProcessors

AbstractBinding::BindingProcessorContainer kanzi::ExpressionBindingSource::m_operationProcessors

protected

Binding operation processors that you can refer to from individual binding ops.

This is separate from the normal binding processors.

◆ m_registers

vector<Variant> kanzi::ExpressionBindingSource::m_registers[2]

protected

Registers for the expression binding source.

Index 0 are the temporary registers, index 1 are the constant registers.

◆ m_valueSources

ValueSourceContainer kanzi::ExpressionBindingSource::m_valueSources

protected

Expression value sources.

◆ m_dataSources

ValueSourceContainer kanzi::ExpressionBindingSource::m_dataSources

protected

Data source expression value sources.

◆ m_isCurrentValueRequired

bool kanzi::ExpressionBindingSource::m_isCurrentValueRequired

protected

Tells if current value is required.

◆ m_hasFixedOperations

bool kanzi::ExpressionBindingSource::m_hasFixedOperations

protected

Tells whether or not the binding contains fixed operations.

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

kanzi/core.ui/binding/expression_binding_source.hpp

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ ValueSourceContainer

◆ BindingOperationContainer

Constructor & Destructor Documentation

◆ ExpressionBindingSource()

Member Function Documentation

◆ create() [1/4]

◆ create() [2/4]

◆ create() [3/4]

◆ create() [4/4]

◆ beginValueSources()

◆ endValueSources()

◆ beginDataSources()

◆ endDataSources()

◆ beginBindingOperations() [1/2]

◆ beginBindingOperations() [2/2]

◆ endBindingOperations() [1/2]

◆ endBindingOperations() [2/2]

◆ beginOperationProcessors() [1/2]

◆ beginOperationProcessors() [2/2]

◆ endOperationProcessors() [1/2]

◆ endOperationProcessors() [2/2]

◆ getTemporaryRegister() [1/2]

◆ getTemporaryRegister() [2/2]

◆ isCurrentValueRequired()

◆ hasFixedOperations()

◆ resolveRegister()

◆ createRuntimeOverride()

Member Data Documentation

◆ m_operations

◆ m_operationProcessors

◆ m_registers

◆ m_valueSources

◆ m_dataSources

◆ m_isCurrentValueRequired

◆ m_hasFixedOperations