When some script - or Smile itself - requests the value of an object's whole property, Smile sends the store event to the object's script. This happens in particular when the user saves a text window, a dialog window, or a graphic window.

You handle store with a handler such as:

on store the_object
    -- do whatever is required before the object is saved
end prepare

where the_object is a reference to the owner of the script, the object which is being saved. The store event is intended to let you perform any update or clean-up which may be required before saving your object. For instance, before saving some kind of plot, you may want to get rid of some temporary, now superfluous data.