| Top |  |  |  |  | 
| const gchar * | gwy_app_get_current_directory () | 
| void | gwy_app_set_current_directory () | 
| GwyContainer * | gwy_app_file_load () | 
| void | gwy_app_file_open () | 
| void | gwy_app_file_merge () | 
| gboolean | gwy_app_file_write () | 
| void | gwy_app_file_save () | 
| void | gwy_app_file_save_as () | 
| void | gwy_app_file_close () | 
| gboolean | gwy_app_file_confirm_overwrite () | 
High-level functions gwy_app_file_load() and gwy_app_file_write() wrap low-level file handling functions from gwymodule-file and handle registration of loaded containers in data
browser, showing windows, remembering file types, or the differenced between save and export.
They are complemented by application-level functions gwy_app_file_open(), gwy_app_file_save(), and
gwy_app_file_save_as() that perform the corresponding operations of File menu.  These are probably not of general
interest.
Beside that, functions to maintain application-level idea of current directory are provided:
gwy_app_get_current_directory(), gwy_app_set_current_directory().  They should be used in place of system chdir()
which has various unwanted side-effect, like change of the directory where core is dumped on segfault.
const gchar *
gwy_app_get_current_directory (void);
Returns what the app uses as `current directory'.
Warning: This function is probably temporary.
 A string in GLib file name encoding that should not be modified neither freed, valid only until next call
to gwy_app_set_current_directory().  It ends with a G_DIR_SEPARATOR_S.
void
gwy_app_set_current_directory (const gchar *directory);
Sets what the app should use as `current directory'.
Warning: This function is probably temporary.
GwyContainer * gwy_app_file_load (const gchar *filename_utf8,const gchar *filename_sys,const gchar *name);
Loads a file into application (a high-level function).
At least one of filename_utf8
, filename_sys
 must be non-NULL.
The file is loaded in interactive mode, modules can ask for user input. Upon a successful load all necessary setup tasks are performed. If the load fails, an error dialog is presented.
| filename_utf8 | Name of file to load, in UTF-8. | |
| filename_sys | Name of file to load, in GLib encoding. | |
| name | File type to open file as, but normally  | 
 Container of the just loaded file on success, NULL on failure. The caller does not own the reference, the
container is only owned by the data browser.
void
gwy_app_file_open (void);
Opens a user-selected file (very high-level app function).
void
gwy_app_file_merge (void);
Merges a user-selected file (very high-level app function).
Since: 2.7
gboolean gwy_app_file_write (GwyContainer *data,const gchar *filename_utf8,const gchar *filename_sys,const gchar *name);
Writes container to a file (a high-level function).
At least one of filename_utf8
, filename_sys
 must be non-NULL.
The file is saved in interactive mode, modules can ask for user input. If the write fails, an error dialog is presented.
| data | Data to write. | |
| filename_utf8 | Name of file to write data to, in UTF-8. | |
| filename_sys | Name of file to write data to, in GLib encoding. | |
| name | File type to save file as, but normally  | 
void
gwy_app_file_save (void);
Saves current data to a file (very high-level app function).
May fall back to gwy_app_file_save_as() when current data has no file name associated with it, or the format it was
loaded from is not saveable.
void
gwy_app_file_save_as (void);
Saves current data to a user-selected file (very high-level app function).
void
gwy_app_file_close (void);
Closes the current file file (very high-level app function).
Since: 2.45