createOccurrence()

Arguments

Index—the index the new occurrence should have.

Return value

Return—the newly created uniface.Occurrence object of this Entity, or null if no occurrence was created.

Exceptions

The following exceptions may be thrown:

• uniface.InvalidDataObjectException
• uniface.OccurrenceCreationException

Description

The new Occurrence is inserted between this Entity's Occurrences, such that the new Occurrence's index is the supplied index. If the supplied index is negative, then this function acts as if the index were this Entity's Occurrence count. If the supplied index is greater than this Entity's Occurrence count then no new Occurrence is created.

It is not possible to create a new occurrences if the entity contains fields that have the Is Static and Is Control property set to F and it is read-only, either because the field syntax is read-only or the widget is read-only. For more information, see Read-Only Fields in Dynamic Server Pages.