|  |  | 
gtk.Dialog(gtk.Window)
SaveBox
StringSaver(SaveBox, Saveable)
gtk.VBox(gtk.Box)
SaveArea
rox.UserAbort(exceptions.Exception)
AbortSave
Saveable
SaveFilter
 
 
| class AbortSave(rox.UserAbort)
 |  |  | Raise this to cancel a save. If a message is given, it is displayed in a normal alert box (not in the report_exception style). If the
 message is None, no message is shown (you should have already shown
 it!)
 
 |  |  | Methods defined here: 
 __init__(self, message)
 show(self)
 |  
 
| class SaveArea(gtk.VBox)
 |  |  | A SaveArea contains the widgets used in a save box. You can use this to put a savebox area in a larger window.
 
 |  |  | Methods defined here: 
 __init__(self, document, uri, type)'document' must be a subclass of Saveable.'uri' is the file's current location, or a simple name (eg 'TextFile')
 if it has never been saved.
 'type' is the MIME-type to use (eg 'text/plain').
 confirm_new_path(self, path)User wants to save to this path. If it's different to the original path,check that it doesn't exist and ask for confirmation if it does.
 If document.save_last_stat is set, compare with os.stat for an existing file
 and warn about changes.
 Returns true to go ahead with the save.
 drag_begin(self, drag_box, context)
 drag_data_get(self, widget, context, selection_data, info, time)
 drag_end(self, widget, context)
 save_done(self)
 save_to_file_in_entry(self)Call this when the user clicks on an OK button you provide.
 set_type(self, type, icon=None)Change the icon and drag target to 'type'.If 'icon' is given (as a GtkImage) then that icon is used,
 otherwise an appropriate icon for the type is used.
 set_uri(self, uri)Data is safely saved somewhere. Update the document's URI and save_last_stat (for local saves).URI is not escaped. Internal.
 |  
 
| class SaveBox(gtk.Dialog)
 |  |  | A SaveBox is a GtkDialog that contains a SaveArea and, optionally, a Discard button. Calls rox.toplevel_(un)ref automatically.
 
 |  |  | Methods defined here: 
 __init__(self, document, uri, type='text/plain', discard=False, parent=None)See SaveArea.__init__.parent was added in version 2.0.5. To support older versions, use set_transient_for.
 If discard is True then an extra discard button is added to the dialog.
 build_main_area(self)Place self.save_area somewhere in self.vbox. Override thisfor more complicated layouts.
 set_save_in_progress(self, in_progress)Called when saving starts and ends. Shade/unshade any widgets asrequired. Make sure you call the default method too!
 Not called if box is destroyed from a recursive mainloop inside
 a save_to_* function.
 set_type(self, type, icon=None)See SaveArea's method of the same name.
 |  
 
| class SaveFilter(Saveable)
 |  |  | This Saveable runs a process in the background to generate the save data. Any python streams can be used as the input to and
 output from the process.
 
 The output from the subprocess is saved to the output stream (either
 directly, for fileno() streams, or via another temporary file).
 
 If the process returns a non-zero exit status or writes to stderr,
 the save fails (messages written to stderr are displayed).
 
 |  |  | Methods defined here: 
 save_cancelled(self)Send SIGTERM to the child processes.
 save_to_stream(self, stream)
 set_stdin(self, stream)Use 'stream' as stdin for the process. If stream is not aseekable fileno() stream then it is copied to a temporary file
 at this point. If None, the child process will get /dev/null on
 stdin.
 |  
 
| class Saveable
 |  |  | This class describes the interface that an object must provide to work with the SaveBox/SaveArea widgets. Inherit from it if you
 want to save. All methods can be overridden, but normally only
 save_to_stream() needs to be. You can also set save_last_stat to
 the result of os.stat(filename) when loading a file to make ROX-Lib
 restore permissions and warn about other programs editing the file.
 
 |  |  | Methods defined here: 
 can_save_to_file(self)Indicates whether we have a working save_to_stream or save_to_filemethod (ie, whether we can save to files). Default method checks that
 one of these two methods has been overridden.
 can_save_to_selection(self)Indicates whether we have a working save_to_stream or save_to_selectionmethod (ie, whether we can save to selections). Default methods checks that
 one of these two methods has been overridden.
 discard(self)Discard button clicked, or document safely saved. Only called if a SaveBox was created with discard=1.
 The user doesn't want the document any more, even if it's modified and unsaved.
 Delete it.
 save_cancelled(self)If you multitask during a save (using a recursive mainloop) then theuser may click on the Cancel button. This function gets called if so, and
 should cause the recursive mainloop to return.
 save_done(self)Time to close the savebox. Default method does nothing.
 save_set_permissions(self, path)The default save_to_file() creates files with the mode 0600(user read/write only). After saving has finished, it calls this
 method to set the final permissions. The save_set_permissions():
 - sets it to 0666 masked with the umask (if save_mode is None), or
 - sets it to save_last_stat.st_mode (not masked) otherwise.
 save_to_file(self, path)Write data to file. Raise an exception on error.The default creates a temporary file, uses save_to_stream() to
 write to it, then renames it over the original. If the temporary file
 can't be created, it writes directly over the original.
 save_to_selection(self, selection_data)Write data to the selection. The default method uses save_to_stream().
 save_to_stream(self, stream)Write the data to save to the stream. When saving to alocal file, stream will be the actual file, otherwise it is a
 cStringIO object.
 set_uri(self, uri)When the data is safely saved somewhere this is calledwith its new name. Mark your data as unmodified and update
 the filename for next time. Saving to another application
 won't call this method. Default method does nothing.
 The URI may be in the form of a URI or a local path.
 It is UTF-8, not escaped (% really means %).
 |  
 |