Layout of Repeated Occurrences
In Form components, it is common to display multiple occurrences of an entity.
Each entity frame has an occurrence icon (
) that is displayed when the entity is selected. You can create repetitions by dragging
this icon, either vertically or horizontally. Every repetition has the same dimensions and contains
the same fields as the first drawn entity. If a parent entity is repeated, its child entities are
also implicitly repeated.
Note: If you are using the grid widget, you only need to draw one occurrence that is the size that the grid should occupy. For more information, see Using the Grid Widget.
At runtime, Uniface displays occurrences only when they are populated, or when an empty occurrence is created.
Every component entity and field has a position expressed in terms of an x and y axis on the component canvas. Fields in repeated occurrences have an offset instead of an absolute position. This offset specifies the distance between one repetition and the next, from top to bottom. By default, offsets are bound to the width and height of component entities, so the value of the offset matches the width or height of the entity.
In form components, it is possible to disassociate the field offset from the entity offset at runtime using $paintedfieldproperties. This makes it possible for repeating occurrences to occupy less area than the first occurrence, or even to have fields overlay each other.
