3.6 The DUIM-OLE-SERVER module

load-frame-from-storage

Open generic function

Summary

Restores data saved by save-frame-to-storage.

Signature

load-frame-from-storage frame stream => ()

Arguments

frame: An instance of <embeddable-frame>.
stream: An instance of <storage-istream>.

Values

None.

Library

duim-ole-server

Module

duim-ole-server

Description

Restores data saved by save-frame-to-storage. Server applications must provide a method on this function. The default method does nothing.

Server applications do not call this method explicitly; instead it is called by the DUIM-OLE-Server library.

The following example loads three <integer> values back from the compound document:

  define method load-frame-from-storage 
    (frame :: <foo-frame>,
     stream :: <storage-istream>) => ()
      frame.foo := istream-read-integer(stream);
      frame.bar := istream-read-integer(stream);
      frame.baz := istream-read-integer(stream);
      values()
  end method;

The function istream-read-integer, page 309, reads a value written by istream-write-integer, page 308; while istream-read-int16, page 310, reads a value written by istream-write-int16, page 308; and IStream/Read corresponds to IStream/Write.