LiveBindings Wizard

The LiveBindings Wizard button () is always available in the LiveBindings Designer.

Use the LiveBindings Wizard to seamlessly create new LiveBindings expressions and connections between various components. Using the LiveBindings Wizard, you can create a binding between existing components, or you can spawn new components directly within the wizard, already bound as you want. You can use the LiveBindings Wizard when developing either VCL or FireMonkey applications.

Click the LiveBindings Wizard button in the LiveBindings Designer. In this case, the LiveBindings Wizard is not context sensitive.
Right-click a form or a component in the Form Designer, and select the LiveBindings Wizard command from the context menu (provided that you enabled it). In this case the LiveBindings Wizard is context sensitive; that is:
- If you start the wizard by right-clicking an existing component, you are prompted to select an action (related to binding) involving this component and other components.
- Otherwise, you are prompted to select an action related to a new component that the wizard creates for you.

Context-Sensitive Wizard Pages

The context-sensitive LiveBindings Wizard is invokable through the right-click menu on a form or on any control on that form. Depending on your selection of binding tasks in the first wizard page, one or more of the wizard pages described below are accessible for you in the LiveBindings Wizard.

Binding Task Page

In the first step of the context-sensitive wizard, you are prompted to select a binding task. You can:

Link a control to a field.
Link a control to a component property.
Link a property of a component to a control.
Link a property of a component to a field.

Depending on your selection, the left-hand field of the wizard updates accordingly, to list the steps or pages you need to follow to create your new binding.

Select your type of binding task, then click Next.

Data Source Page

The Data source page is available only if your binding task is to link a control to a field, to link a property of a component to a field, or to create a data source.

Select either a component name from an existing source or choose to create a new source using a TPrototypeBindSource as the base class. After you specify your choice, click Next.

Field Page

The Field page is available only if your binding task is to link a control to a field or to link a property of a component to a field.

Select either a field's name from the list or add a new field, then click Next.

Options Page

The Options page is available only if your binding task is to link a control with a field or to link a property of a component with a field.

Here you are prompted to add a data source navigator or a control label attached to your control. A control label can be added only if the wizard supports labels on those controls. All FireMonkey controls do support such labels, except for the TGrid control.

If you are binding a field, Options is the last page of the wizard; in this case, click Finish to complete the wizard and the LiveBinding.
Otherwise, click Next.

Component Property Page

This page is only available if your binding task is to link a control to a component property, to link a property of a component to a control, or to link a property of a component to a field.

You are prompted to select the component that has the property you want to bind (if you have invoked the LiveBindings Wizard from an existing component, that component already has focus in the combobox). Then you need to select the property of this control that you want to further bind to your selected control.

Control Page

The Control page is only available if your binding task is to link a property of a component to a control.

You are prompted to select from a list of existing controls or to create a new control. As Control is the last wizard page, click Finish to complete your binding expression.

Context-Insensitive Wizard Pages

The context insensitive LiveBindings Wizard is invokable only through the LiveBindings Wizard command button in the LiveBindings Designer. These pages are similar to the context-sensitive ones, but in the Binding Task page there is also a Create a data source option.

Binding Task Page

In the first step of the context-insensitive wizard, you are prompted to select a binding task. You can:

Link a control to a field.
Link a grid to a data source.
Link a property of a component to a control.
Link a property of a component to a field.
Create a data source.

Depending on your selection, the left-hand field of the wizard updates accordingly, to list the steps or pages you need to follow to create your new binding.

Select your type of binding task, then click Next.

The rest of the pages are identical to those described above in the context-sensitive section of this topic, in concordance to the task you have chosen in the first place.