About dragging and dropping collection properties

In the Web Designer (web client) or in Design mode (Windows client), you can drag and drop collection properties to create bound components on forms. When you drag and drop a collection property into a form, a field (editable component) and its label (static component) are automatically added on the form. For MultiView forms, a corresponding grid column is also added on the principal grid of that form.

When you drop a collection property in a grid, a new grid column is added on that grid.

The type of field and grid column added on the form are based on the property type of the collection property.

Note: 
  • If the component type of the editable component is not appropriate for the property type, then you can use the Component Properties sheet to change the component type, after the drag-and-drop is complete. For example, if a property has a True/False value, select that component and in the Type field of the Component Properties sheet, select CheckBox.
  • The name of the component is in the format <PropertyName><ComponentType>, for example, MyPropertyGridCol, MyPropertyEdit, and MyPropertyStatic. If a component with that name already exists, an incrementing number is added to the end of the name.

You can drag and drop properties in the these areas:

  • Detail View area of a MultiView form
  • Grid component on a form
  • Grid View of a MultiView form

When dragging and dropping collection properties into the Detail View area of a MultiView form, keep these rules in mind:

  • You cannot drag and drop the entire collection into a form.
  • When you drop the property, both the static and the editable components of the property are added on the form.
  • The static component is created on the left side of the point where the drop is initiated, and the editable component is created to the right of that point.
  • If the IDO property contains a list of properties, or if the property class extension contains a list source, then a drop-down list is created.
  • After the field and its label are added on the form, a grid column component is also added at the end of the Grid View.
  • When you drag and drop a subcollection property into a form, a new grid component is created.

When dragging and dropping properties into a container component, such as a FlexLayout or NoteBook component, keep these rules in mind:

  • When you drag and drop a collection property in a FlexLayout component or in a NoteBook tab panel, the new field is rendered in the owner container. When the node is a subcollection, a grid is rendered on the form.
  • When you drag and drop a collection property while holding the CTRL (or the CMD) key, the new field and its label are added on the form, and are wrapped in a FlexLayout component.
  • When you drag and drop the property in a FlexLayout component, the new field becomes a child of that component, and follows the configurations defined on the FlexLayout component.

When dragging and dropping collection properties into grids, keep these rules in mind:

  • You cannot drag and drop the entire collection into a grid.
  • You can drag and drop a collection property only into a primary grid.
  • You cannot drag and drop a subcollection property into a grid.
  • You cannot drag and drop a collection property into a subcollection grid.
  • If you drop the property into a grid, either into a grid component on a form, or into the Grid View of a multiview form, and if the grid is bound to the same collection as the IDO property, then a grid column component is added at the end of the grid.