company logo

PropertyHandle :: Save - Store instance

The function stores all modification made on the selected instance and updates made on instances in subordinated property handles. Within a transaction the the function will write the updates to the transaction buffer. Modifications are stored to the database when the transaction is closed (Commit()).

The function is called automatically when changing the selection for a property handle and modifications have been made on the instance.

Return value:  Success ( logical  )

Implementation details

logical PropertyHandle  :: Save ( char savopt=NO, logical switchopt=NO )
  • savopt - Store option

    This option indicates that instances, that have been modified meanwhile by another user, can be overwritten (YES). When passing NO for this option the function returns an error when the instance has been updated by another user after reading it into the application.

    Default: NO
  • switchopt - Unselected option

    The option forces the function to deselect the selected instance in the property handle after terminating the function.

    Default: NO