Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Widget Connector
width900
urlhttps://www.youtube.com/watch?v=oXt89u6QGXE
height500

Pinning and unpinning

A key concept behind dragging functionality in forms is pinning and unpinning. Unpinned components are placed into the next available space. Pinned components can be placed anywhere on the form, and you can pin the edges to the edges of the parent component by setting offsets between the top, right, bottom and left edges of the component to those of the parent.

Unpinned components

Unpinned components are placed automatically in the next space available.

...

For further details about how to position unpinned components within a parent component, see Positioning unpinned components

Pinned components

Pinned components can be dragged to anywhere you want in the form. You can "pin" the edges of the component to its parent component. For further details on how to position pinned components on a form, see Positioning pinned components on forms 

Anchor
formBuildingFindComponentParent
formBuildingFindComponentParent
Finding a component's parent

In most cases, a component's parent is fairly obvious - and you can find it by clicking just outside the area of the component. In some cases, it is not obvious. Remember also that with pinned components, you could drag a component from an area, which is its parent, into another area, so that the component now appears in an area that is not actually its parent.

...

  • Open the details for the component; at the top of the details, the name of the parent will be shown - to get more details, click on the quick link Parent to open the details for the parent
  • Right-click on the component in the form and select Find in Explorer - this gives you a useful way of visually seeing what the parent is, and indeed how other components on the form relate to this component

Dropping components onto forms to create content

New layout components can be added to a form by dragging and dropping any of the following:

...

To drop an item onto a form that would normally be created unpinned (see table above) as pinned - hold the Ctrl key down while dragging.

Laying out forms

Anchor
formBuildingPositioningUnpinnedComponents
formBuildingPositioningUnpinnedComponents
Positioning unpinned components

You can drag unpinned components around in their parent component, and they will placed wherever you drop them.

You can also manually control the order of unpinned components by editing the Order field in the details of the component. This is found in the Positional Settings section of the details. The video above gives an example of using both of these methods - dragging, and manual update.

Anchor
formBuildingPositioningPinnedComponents
formBuildingPositioningPinnedComponents
Positioning pinned components

You can drag pinned components to any position on a form.

...

Note that if you set the right or bottom offsets in Positional Settings, this overrides any width or height set for the component.

Mixing pinned and unpinned components

Pinned components can be dragged over unpinned components, so be careful when mixing pinned and unpinned components on a form, Think of these as being laid out in two separate, overlapping layers on the form.

Switching between unpinned and pinned

To change an unpinned component to pinned, press the Ctrl key down and drag it.

To unpin a pinned component, right-click on it and select Unpin Selected Objects. You can select several components at once, and unpin them all using this option. The components will move into the next available space in their respective parent components.

Moving a component to a new parent

To move a component to a new parent, press Shift and drag it to the new parent. Commonly this is used to move components inside an area to a new area.

To confirm that the component has moved to the new parent, remember the techniques to find the parent of a component: Find a component's parent

Preventing components from being dragged

Sometimes, when laying out a form, you may find it interesting to "lock" a component in place, to stop yourself dragging it to a new position by accident. To do this, tick the Prevent Dragging flag in the component details. This is found in the Positional Settings section.