Bindings are set using the DataSource property, the DataSource property of the supplied IPContainer, and optionally the DataPropertyName and BoundToMasterGrid properties of this grid. There are several ways in which the bound object or collection can be determined from these properties.

If the DataSource property is set specifically, then the set object or collection becomes the item bound to this container. The controls within the container, including nested PContainers, are bound to properties of the bound object or collection elements. This is achieved by each IPControl calling SetBindings for all contained controls. The remaining scenarios outlined here assume SetBindings is being called in this way.

If the BoundToMasterGrid property is false, then the bound item (object or collection) is determined by the DataPropertyName property. If this is empty, then the bound item is the same as that of the supplied parent PContainer. If it is not empty, then the bound item is that in the named property of the item bound to the parent PContainer.

If the BoundToMasterGrid property is true, then the parent PContainer must be bound to a collection, which will be shown in the master grid. The DataPropertyName must be a property of the elements of that collection. Every time the user selects a new row in the master grid, this PContainer is re-bound to the value of the indicated property in the new row.