System.Bindings.Helper.TBindings.CreateManagedBinding

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

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

C++

__classmethod System::Bindings::Expression::TBindingExpression* __fastcall CreateManagedBinding(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, System::Bindings::Manager::TBindingManager* Manager = (System::Bindings::Manager::TBindingManager*)(0x0), TCreateOptions Options = (TCreateOptions() << TCreateOption::coNotifyOutput ))/* overload */;
__classmethod System::Bindings::Expression::TBindingExpression* __fastcall CreateManagedBinding(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, System::Bindings::Manager::TBindingManager* Manager = (System::Bindings::Manager::TBindingManager*)(0x0), TCreateOptions Options = (TCreateOptions() << TCreateOption::coNotifyOutput ))/* 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 a managed binding expression.

CreateManagedBinding is a helper method that creates a managed binding expression. There are two CreateManagedBinding overloaded methods.

Call the first CreateManagedBinding 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.
Manager Manager in which to create the binding expression object. Root AppManager is used if Manager is unprovided.
Evaluate Specifies whether the binding expression should be evaluated initially.

Call the second CreateManagedBinding 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.
Manager Manager in which to create the binding expression object. Root AppManager is used if Manager is unprovided.
Evaluate Specifies whether the binding expression should be evaluated initially.

A managed binding expression is an expression that belongs to a manager and sends the notifications through that manager. A managed binding expression is automatically notified based on dependencies, with respect to other existing bindings. So every time an object or a property used by this managed binding expression changes, the notification is sent automatically. Managed binding expressions are automatically destroyed.

See Also