3.6 The DUIM-OLE-SERVER module

note-embedded-data-changed

Function

Summary

A server application should call this function on its frame object whenever a change is made to either the embedded object's persistent data or to the image that should appear in the container.

Signature

note-embedded-data-changed frame => ()

Arguments

frame: An instance of <embeddable-frame>.

Values

None.

Library

duim-ole-server

Module

duim-ole-server

Description

A server application should call this function on its frame object whenever a change is made to either the embedded object's persistent data or to the image that should appear in the container. The function ensures that save-frame-to-storage is called as necessary and that the container's display of the embedded object is refreshed as necessary. It has no effect if the program is not running under OLE.

This function is implemented as follows:

define method note-embedded-data-changed (frame :: 
  <embeddable-frame>) => ()
    frame.embedded-data-changed? := #t; 
      // need to save data

    note-embedded-image-changed(frame); 
      // update image in container
end method;

If you prefer, your application can use the two elements of this function separately. The slot embedded-data-changed? indicates whether save-frame-to-storage needs to be called, and is automatically set to #f when either it or load-frame-from-storage is called.