load-file

Loads a file into the buffer, return #t if successful, #f otherwise.

The filename used to load the file can be retrieved with get-filename. For a wx:media-edit% instance, the format can be retrieved with get-file-format.

See also set-load-overwrites-styles.

• (send a-mred:hyper-edit load-file filename format relative?) -> void
      filename = null : string or null
      format = wx:const-media-ff-guess : int
      relative? = #f : boolean

  If filename is null, then the internally stored filename will be used; if filename is "" or if the internal name is unset or temporary, then the user will be prompted for a name.

  The possible values for format are listed below. A single set of format values are used for loading and saving files:

  • wx:const-media-ff-guess -- guess the format based on extension and/or contents; when saving a file, this is the same as wx:const-media-ff-std
  • wx:const-media-ff-std -- read/write a standard file
  • wx:const-media-ff-text -- read/write a text file (wx:media-edit% only)
  • wx:const-media-ff-text-force-cr -- read/write a text file (wx:media-edit% only); when writing, change automatic newlines (from word-wrapping) into real carriage returns
  • wx:const-media-ff-same -- read in whatever format was last loaded or saved
  • wx:const-media-ff-copy -- write using whatever format was last loaded or saved, but do not change the modification flag or remember filename (saving only)

  In a wx:media-edit% instance, the format returned from get-file-format is always one of wx:const-media-ff-std, wx:const-media-ff-text, or wx:const-media-ff-text-force-cr.

  If show-errors? is #f, then dialogs reporting save errors are suppressed.

  If filename does not exist, this will call set-filename to set the file name to filename. If filename does exist, it calls the super load-file.

  This method first checks to see if file exists and if it doesn't, it just sets the buffers filename

  Calls super-method, sets hypertags-list and hyperlinks-list with the footer information, installs the clickbacks, and replaces ``h-link-style'' for the file with add-h-link-style. relative? should be #t if the filename is a relative pathname.