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