![]() |
![]() |
![]() |
Libbrasero-burn Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#define BRASERO_DND_TARGET_DATA_TRACK_REFERENCE_LIST enum BraseroTrackDataCfgColumn; BraseroTrackDataCfg; BraseroTrackDataCfg * brasero_track_data_cfg_new (void); gboolean brasero_track_data_cfg_add (BraseroTrackDataCfg *track, const gchar *uri, GtkTreePath *parent); GtkTreePath * brasero_track_data_cfg_add_empty_directory (BraseroTrackDataCfg *track, const gchar *name, GtkTreePath *parent); gboolean brasero_track_data_cfg_remove (BraseroTrackDataCfg *track, GtkTreePath *treepath); gboolean brasero_track_data_cfg_rename (BraseroTrackDataCfg *track, const gchar *newname, GtkTreePath *treepath); gboolean brasero_track_data_cfg_reset (BraseroTrackDataCfg *track); gboolean brasero_track_data_cfg_load_medium (BraseroTrackDataCfg *track, BraseroMedium *medium, GError **error); void brasero_track_data_cfg_unload_current_medium (BraseroTrackDataCfg *track); BraseroMedium * brasero_track_data_cfg_get_current_medium (BraseroTrackDataCfg *track); GSList * brasero_track_data_cfg_get_available_media (BraseroTrackDataCfg *track); void brasero_track_data_cfg_dont_filter_uri (BraseroTrackDataCfg *track, const gchar *uri); GSList * brasero_track_data_cfg_get_restored_list (BraseroTrackDataCfg *track); void brasero_track_data_cfg_restore (BraseroTrackDataCfg *track, GtkTreePath *treepath); GtkTreeModel * brasero_track_data_cfg_get_filtered_model (BraseroTrackDataCfg *track); BraseroBurnResult brasero_track_data_cfg_span (BraseroTrackDataCfg *track, goffset sectors, BraseroTrackData *new_track); BraseroBurnResult brasero_track_data_cfg_span_again (BraseroTrackDataCfg *track); BraseroBurnResult brasero_track_data_cfg_span_possible (BraseroTrackDataCfg *track, goffset sectors); void brasero_track_data_cfg_span_stop (BraseroTrackDataCfg *track); GIcon * brasero_track_data_cfg_get_icon (BraseroTrackDataCfg *track); gchar * brasero_track_data_cfg_get_icon_path (BraseroTrackDataCfg *track); gboolean brasero_track_data_cfg_set_icon (BraseroTrackDataCfg *track, const gchar *icon_path, GError **error);
#define BRASERO_DND_TARGET_DATA_TRACK_REFERENCE_LIST "GTK_TREE_MODEL_ROW"
typedef enum { BRASERO_DATA_TREE_MODEL_NAME = 0, BRASERO_DATA_TREE_MODEL_URI, BRASERO_DATA_TREE_MODEL_MIME_DESC, BRASERO_DATA_TREE_MODEL_MIME_ICON, BRASERO_DATA_TREE_MODEL_SIZE, BRASERO_DATA_TREE_MODEL_SHOW_PERCENT, BRASERO_DATA_TREE_MODEL_PERCENT, BRASERO_DATA_TREE_MODEL_STYLE, BRASERO_DATA_TREE_MODEL_COLOR, BRASERO_DATA_TREE_MODEL_EDITABLE, BRASERO_DATA_TREE_MODEL_IS_FILE, BRASERO_DATA_TREE_MODEL_IS_LOADING, BRASERO_DATA_TREE_MODEL_IS_IMPORTED, BRASERO_DATA_TREE_MODEL_COL_NUM } BraseroTrackDataCfgColumn;
BraseroTrackDataCfg * brasero_track_data_cfg_new (void);
Creates a new BraseroTrackDataCfg.
Returns : |
a new BraseroTrackDataCfg. |
gboolean brasero_track_data_cfg_add (BraseroTrackDataCfg *track, const gchar *uri, GtkTreePath *parent);
Add a new file (with uri
as URI) under a directory (parent
).
If parent
is NULL, the file is added to the root.
Also if uri
is the path of a directory, this directory will be explored
and all its children added to the tree.
|
a BraseroTrackDataCfg |
|
a gchar |
|
a GtkTreePath or NULL |
Returns : |
a gboolean. TRUE if the operation was successful, FALSE otherwise |
GtkTreePath * brasero_track_data_cfg_add_empty_directory (BraseroTrackDataCfg *track, const gchar *name, GtkTreePath *parent);
Add a new empty directory (with name
as name) under another directory (parent
).
If parent
is NULL, the file is added to the root.
|
a BraseroTrackDataCfg |
|
a gchar |
|
a GtkTreePath or NULL |
Returns : |
a GtkTreePath which should be destroyed when not needed; NULL if the operation was not successful. |
gboolean brasero_track_data_cfg_remove (BraseroTrackDataCfg *track, GtkTreePath *treepath);
Removes a file or a directory (as well as its children) from the tree. NOTE: some files cannot be removed like files from an imported session.
|
a BraseroTrackDataCfg |
|
a GtkTreePath |
Returns : |
a gboolean. TRUE if the operation was successful, FALSE otherwise |
gboolean brasero_track_data_cfg_rename (BraseroTrackDataCfg *track, const gchar *newname, GtkTreePath *treepath);
Renames the file in the tree pointed by treepath
.
|
a BraseroTrackDataCfg |
|
a gchar |
|
a GtkTreePath |
Returns : |
a gboolean. TRUE if the operation was successful, FALSE otherwise |
gboolean brasero_track_data_cfg_reset (BraseroTrackDataCfg *track);
Completely empties track
and unloads any currently loaded session
|
a BraseroTrackDataCfg |
Returns : |
a gboolean. TRUE if the operation was successful, FALSE otherwise |
gboolean brasero_track_data_cfg_load_medium (BraseroTrackDataCfg *track, BraseroMedium *medium, GError **error);
Tries to load the contents of the last session of medium
so all its files will be included in the tree
to perform a merge between files from the session and new added files.
Errors are stored in error
.
|
a BraseroTrackDataCfg |
|
a BraseroMedium |
|
a GError |
Returns : |
a gboolean. TRUE if the operation was successful, FALSE otherwise |
void brasero_track_data_cfg_unload_current_medium (BraseroTrackDataCfg *track);
Unload the contents of the last session of the currently loaded medium.
See brasero_track_data_cfg_load_medium()
.
|
a BraseroTrackDataCfg |
BraseroMedium * brasero_track_data_cfg_get_current_medium (BraseroTrackDataCfg *track);
Gets the currently loaded medium.
|
a BraseroTrackDataCfg |
Returns : |
a BraseroMedium. NULL if no medium are currently loaded. Do not unref when the BraseroMedium is not needed anymore. |
GSList * brasero_track_data_cfg_get_available_media (BraseroTrackDataCfg *track);
Gets a list of all the media that can be appended with new data and which have a session that can be loaded.
|
a BraseroTrackDataCfg |
Returns : |
a GSList of BraseroMedium. Free the list and unref its contents when the list is not needed anymore. |
void brasero_track_data_cfg_dont_filter_uri (BraseroTrackDataCfg *track, const gchar *uri);
Prevents uri
to be filtered while automatic exploration
of added directories is performed.
|
a BraseroTrackDataCfg |
|
a gchar |
GSList * brasero_track_data_cfg_get_restored_list (BraseroTrackDataCfg *track);
Gets a list of URIs (as gchar *) that were restored with brasero_track_data_cfg_restore()
.
|
a BraseroTrackDataCfg |
Returns : |
a GSList; free the list and its contents when not needed anymore. |
void brasero_track_data_cfg_restore (BraseroTrackDataCfg *track, GtkTreePath *treepath);
Removes a file from the filtered file list (see brasero_track_data_cfg_get_filtered_model()
)
and re-adds it wherever it should be in the tree.
treepath
is a GtkTreePath associated with the GtkTreeModel which holds the
filtered files not the main tree.
|
a BraseroTrackDataCfg |
|
a GtkTreePath |
GtkTreeModel * brasero_track_data_cfg_get_filtered_model (BraseroTrackDataCfg *track);
Gets a GtkTreeModel which contains all the files that were automatically filtered while added directories were explored.
|
a BraseroTrackDataCfg |
Returns : |
a GtkTreeModel. Unref when not needed. |
BraseroBurnResult brasero_track_data_cfg_span (BraseroTrackDataCfg *track, goffset sectors, BraseroTrackData *new_track);
Creates a new BraseroTrackData (stored in new_track
) from the files contained in track
. The sum of their sizes
does not exceed sectors
. This allows to burn a tree on multiple discs. This function can be
called repeatedly; in this case if some files were left out after the previous calls, the newly created BraseroTrackData
is created with all or part of the remaining files.
|
a BraseroTrackDataCfg |
|
a goffset |
|
a BraseroTrackData |
Returns : |
a BraseroBurnResult. BRASERO_BURN_OK if there is not anymore data. BRASERO_BURN_RETRY if the operation was successful and a new BraseroTrackDataCfg was created. BRASERO_BURN_ERR otherwise. |
BraseroBurnResult brasero_track_data_cfg_span_again (BraseroTrackDataCfg *track);
Checks whether some files were not included during calls to brasero_track_data_cfg_span()
.
|
a BraseroTrackDataCfg |
Returns : |
a BraseroBurnResult. BRASERO_BURN_OK if there is not anymore data. BRASERO_BURN_RETRY if the operation was successful and a new BraseroTrackDataCfg was created. BRASERO_BURN_ERR otherwise. |
BraseroBurnResult brasero_track_data_cfg_span_possible (BraseroTrackDataCfg *track, goffset sectors);
Checks if a new BraseroTrackData can be created from the files remaining in the tree
after calls to brasero_track_data_cfg_span()
.
|
a BraseroTrackDataCfg |
|
a goffset |
Returns : |
a BraseroBurnResult. BRASERO_BURN_OK if there is not anymore data. BRASERO_BURN_RETRY if the operation was successful and a new BraseroTrackDataCfg was created. BRASERO_BURN_ERR otherwise. |
void brasero_track_data_cfg_span_stop (BraseroTrackDataCfg *track);
Resets the list of files that were included after calls to brasero_track_data_cfg_span()
.
|
a BraseroTrackDataCfg |
GIcon * brasero_track_data_cfg_get_icon (BraseroTrackDataCfg *track);
Returns the currently selected icon.
|
a BraseroTrackDataCfg |
Returns : |
a GIcon or NULL. |
gchar * brasero_track_data_cfg_get_icon_path (BraseroTrackDataCfg *track);
Returns a path pointing to the currently selected icon file.
|
a BraseroTrackDataCfg |
Returns : |
a gchar or NULL. |
gboolean brasero_track_data_cfg_set_icon (BraseroTrackDataCfg *track, const gchar *icon_path, GError **error);
Sets the current icon.
|
a BraseroTrackDataCfg |
|
a gchar |
|
a GError |
Returns : |
a gboolean. TRUE if the operation was successful, FALSE otherwise |