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-wx:media-buffer load-file filename format show-errors?) -> boolean
      filename = null : string or null
      format = wx:const-media-ff-guess : small integer
      show-errors? = #t : 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.