| Top |
| GtkSourceBuffer * | buffer | Read / Write / Construct Only |
| GtkSourceCompressionType | compression-type | Read / Write / Construct |
| GtkSourceEncoding * | encoding | Read / Write / Construct |
| GtkSourceFile * | file | Read / Write / Construct Only |
| GtkSourceFileSaverFlags | flags | Read / Write / Construct |
| GFile * | location | Read / Write / Construct Only |
| GtkSourceNewlineType | newline-type | Read / Write / Construct |
A GtkSourceFileSaver object permits to save a GtkSourceBuffer into a GFile.
A file saver should be used only for one save operation, including errors
handling. If an error occurs, you can reconfigure the saver and relaunch the
operation with gtk_source_file_saver_save_async().
GtkSourceFileSaver * gtk_source_file_saver_new (GtkSourceBuffer *buffer,GtkSourceFile *file);
Creates a new GtkSourceFileSaver object. The buffer
will be saved to the
GtkSourceFile's location.
This constructor is suitable for a simple "save" operation, when the file
already contains a non-NULL “location”.
Since 3.14
GtkSourceFileSaver * gtk_source_file_saver_new_with_target (GtkSourceBuffer *buffer,GtkSourceFile *file,GFile *target_location);
Creates a new GtkSourceFileSaver object with a target location. When the
file saving is finished successfully, target_location
is set to the file
's
“location” property. If an error occurs, the previous valid
location is still available in GtkSourceFile.
This constructor is suitable for a "save as" operation, or for saving a new buffer for the first time.
buffer |
the GtkSourceBuffer to save. |
|
file |
the GtkSourceFile. |
|
target_location |
the GFile where to save the buffer to. |
Since 3.14
GtkSourceBuffer *
gtk_source_file_saver_get_buffer (GtkSourceFileSaver *saver);
Since 3.14
GtkSourceFile *
gtk_source_file_saver_get_file (GtkSourceFileSaver *saver);
Since 3.14
GFile *
gtk_source_file_saver_get_location (GtkSourceFileSaver *saver);
Since 3.14
void gtk_source_file_saver_set_encoding (GtkSourceFileSaver *saver,const GtkSourceEncoding *encoding);
Sets the encoding. If encoding
is NULL, the UTF-8 encoding will be set.
By default the encoding is taken from the GtkSourceFile.
Since 3.14
const GtkSourceEncoding *
gtk_source_file_saver_get_encoding (GtkSourceFileSaver *saver);
Since 3.14
void gtk_source_file_saver_set_newline_type (GtkSourceFileSaver *saver,GtkSourceNewlineType newline_type);
Sets the newline type. By default the newline type is taken from the GtkSourceFile.
Since 3.14
GtkSourceNewlineType
gtk_source_file_saver_get_newline_type
(GtkSourceFileSaver *saver);
Since 3.14
void gtk_source_file_saver_set_compression_type (GtkSourceFileSaver *saver,GtkSourceCompressionType compression_type);
Sets the compression type. By default the compression type is taken from the GtkSourceFile.
Since 3.14
GtkSourceCompressionType
gtk_source_file_saver_get_compression_type
(GtkSourceFileSaver *saver);
Since 3.14
void gtk_source_file_saver_set_flags (GtkSourceFileSaver *saver,GtkSourceFileSaverFlags flags);
Since 3.14
GtkSourceFileSaverFlags
gtk_source_file_saver_get_flags (GtkSourceFileSaver *saver);
Since 3.14
void gtk_source_file_saver_save_async (GtkSourceFileSaver *saver,gint io_priority,GCancellable *cancellable,GFileProgressCallback progress_callback,gpointer progress_callback_data,GDestroyNotify progress_callback_notify,GAsyncReadyCallback callback,gpointer user_data);
Saves asynchronously the buffer into the file. See the GAsyncResult documentation to know how to use this function.
saver |
||
io_priority |
the I/O priority of the request. E.g. |
|
cancellable |
optional GCancellable object, |
[nullable] |
progress_callback |
function to call back with
progress information, or |
[scope notified][nullable] |
progress_callback_data |
user data to pass to |
[closure] |
progress_callback_notify |
function to call on
|
[nullable] |
callback |
a GAsyncReadyCallback to call when the request is satisfied. |
[scope async] |
user_data |
user data to pass to |
Since 3.14
gboolean gtk_source_file_saver_save_finish (GtkSourceFileSaver *saver,GAsyncResult *result,GError **error);
Finishes a file saving started with gtk_source_file_saver_save_async().
If the file has been saved successfully, the following GtkSourceFile properties will be updated: the location, the encoding, the newline type and the compression type.
Since 3.14
#define GTK_SOURCE_FILE_SAVER_ERROR gtk_source_file_saver_error_quark ()
An error code used with the GTK_SOURCE_FILE_SAVER_ERROR domain.
Since 3.14
Flags to define the behavior of a GtkSourceFileSaver.
Since 3.14
“buffer” property“buffer” GtkSourceBuffer *
The GtkSourceBuffer to save. The GtkSourceFileSaver object has a weak reference to the buffer.
Flags: Read / Write / Construct Only
Since 3.14
“compression-type” property“compression-type” GtkSourceCompressionType
The compression type.
Flags: Read / Write / Construct
Default value: GTK_SOURCE_COMPRESSION_TYPE_NONE
Since 3.14
“encoding” property“encoding” GtkSourceEncoding *
The file's encoding.
Flags: Read / Write / Construct
Since 3.14
“file” property“file” GtkSourceFile *
The GtkSourceFile. The GtkSourceFileSaver object has a weak reference to the file.
Flags: Read / Write / Construct Only
Since 3.14
“flags” property“flags” GtkSourceFileSaverFlags
File saving flags.
Flags: Read / Write / Construct
Since 3.14
“location” property“location” GFile *
The GFile where to save the buffer. By default the location is taken from the GtkSourceFile at construction time.
Flags: Read / Write / Construct Only
Since 3.14
“newline-type” property“newline-type” GtkSourceNewlineType
The newline type.
Flags: Read / Write / Construct
Default value: GTK_SOURCE_NEWLINE_TYPE_LF
Since 3.14