System.Bindings.Helper.TBindings.CreateUnmanagedBinding

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

class function CreateUnmanagedBinding(  const InputScopes: array of IScope; const BindExprStr: string; const OutputScopes: array of IScope; const OutputExpr: string; const OutputConverter: IValueRefConverter; BindingEventRec: TBindingEventRec; Options: TCreateOptions = [coNotifyOutput]): TBindingExpression; overload;
class function CreateUnmanagedBinding(  const InputScopes: array of IScope; const BindExprStr: string; const OutputScopes: array of IScope; const OutputExpr: string; const OutputConverter: IValueRefConverter; Options: TCreateOptions = []): TBindingExpression; overload;

C++

__classmethod System::Bindings::Expression::TBindingExpression* __fastcall CreateUnmanagedBinding(const System::Bindings::Evalprotocol::_di_IScope *InputScopes, const int InputScopes_High, const System::UnicodeString BindExprStr, const System::Bindings::Evalprotocol::_di_IScope *OutputScopes, const int OutputScopes_High, const System::UnicodeString OutputExpr, const System::Bindings::Outputs::_di_IValueRefConverter OutputConverter, const TBindingEventRec &BindingEventRec, TCreateOptions Options = (TCreateOptions() << TCreateOption::coNotifyOutput ))/* overload */;
__classmethod System::Bindings::Expression::TBindingExpression* __fastcall CreateUnmanagedBinding(const System::Bindings::Evalprotocol::_di_IScope *InputScopes, const int InputScopes_High, const System::UnicodeString BindExprStr, const System::Bindings::Evalprotocol::_di_IScope *OutputScopes, const int OutputScopes_High, const System::UnicodeString OutputExpr, const System::Bindings::Outputs::_di_IValueRefConverter OutputConverter, TCreateOptions Options = TCreateOptions() )/* overload */;

Properties

Type Visibility Source Unit Parent
function public
System.Bindings.Helper.pas
System.Bindings.Helper.hpp
System.Bindings.Helper TBindings

Description

Helper function to create an unmanaged binding expression.

CreateUnmanagedBinding is a helper method that creates an unmanaged binding expression. There are two CreateUnmanagedBinding overloaded methods.

Call the first CreateUnmanagedBinding overloaded method with the parameters described below:

Parameter Meaning
InputScopes Array of input scopes used for lookups of the binding expression string.
BindExprStr String expression to be evaluated by the binding engine.
OutputScopes Array of output scopes used for lookups of the output assignment location.
OutputExpr String expression to be evaluated with the OutputScopes to determine assignment location.
OutputConverter Output converters to use with the binding expression. All default converters are used if OutputConverter is nil.
BindingEventRec Record containing binding expression events.
Evaluate Specifies whether the binding expression should be evaluated initially.

Call the second CreateUnmanagedBinding overloaded method with the parameters described below:

Parameter Meaning
InputScopes Array of input scopes used for lookups of the binding expression string.
BindExprStr String expression to be evaluated by the binding engine.
OutputScopes Array of output scopes used for lookups of the output assignment location.
OutputExpr String expression to be evaluated with the OutputScopes to determine assignment location.
OutputConverter Output converters to use with the binding expression. All default converters are used if OutputConverter is nil.
Evaluate Specifies whether the binding expression should be evaluated initially.

An unmanaged binding expression is stand-alone and does not belong to a manager. An unmanaged binding expression is not evaluated automatically and does not trigger other existing bindings. It assigns the calculated expression value to the designated outputs when evaluated manually. Unmanaged binding expressions are not automatically destroyed, therefore you have to manually destroy them.

See Also