System.Bindings.Helper.TBindings.CreateManagedBinding
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.