Top | ![]() |
![]() |
![]() |
![]() |
void | fm_dir_tree_model_add_root () |
guint | fm_dir_tree_model_get_icon_size () |
gboolean | fm_dir_tree_model_get_show_hidden () |
void | fm_dir_tree_model_load_row () |
FmDirTreeModel * | fm_dir_tree_model_new () |
void | fm_dir_tree_model_set_icon_size () |
void | fm_dir_tree_model_set_show_hidden () |
void | fm_dir_tree_model_unload_row () |
const char * | fm_dir_tree_row_get_disp_name () |
FmFileInfo * | fm_dir_tree_row_get_file_info () |
FmPath * | fm_dir_tree_row_get_file_path () |
GdkPixbuf * | fm_dir_tree_row_get_icon () |
gboolean | fm_dir_tree_row_is_loaded () |
include
: libfm/fm-gtk.h
The FmDirTreeModel represents tree of folders which can be used by FmDirTreeView to create tree-like expandable list of directories.
void fm_dir_tree_model_add_root (FmDirTreeModel *model
,FmFileInfo *root
,GtkTreeIter *iter
);
Adds a root node for file root
into model
. If iter
is not NULL
then on return it will be set to new row data.
model |
the model instance |
|
root |
a root path to add |
|
iter |
pointer to iterator to set. |
[allow-none] |
Since: 0.1.16
guint
fm_dir_tree_model_get_icon_size (FmDirTreeModel *model
);
Retrieves size of icons which are associated with rows.
Before 1.0.0 this API had name fm_dir_tree_get_icon_size.
Since: 0.1.16
gboolean
fm_dir_tree_model_get_show_hidden (FmDirTreeModel *model
);
void fm_dir_tree_model_load_row (FmDirTreeModel *model
,GtkTreeIter *it
,GtkTreePath *tp
);
If row with iterator it
has its children already retrieved then
does nothing. Else starts retrieving of list of children for row
with iterator it
and path tp
. When children are loaded then a
“row-loaded” signal will be emitted. The folder
associated with the row will be monitored for changes in children
after that.
This API is used when the row is expanded in the view.
Before 1.0.0 this API had name fm_dir_tree_model_expand_row.
See also: fm_dir_tree_row_is_loaded()
, fm_dir_tree_model_unload_row()
.
Since: 0.1.16
FmDirTreeModel *
fm_dir_tree_model_new (void
);
Creates new FmDirTreeModel instance.
Since: 0.1.16
void fm_dir_tree_model_set_icon_size (FmDirTreeModel *model
,guint icon_size
);
Sets size of icons which are associated with rows.
Since: 0.1.16
void fm_dir_tree_model_set_show_hidden (FmDirTreeModel *model
,gboolean show_hidden
);
void fm_dir_tree_model_unload_row (FmDirTreeModel *model
,GtkTreeIter *it
,GtkTreePath *tp
);
If children of row with iterator it
are retrieved or monitored
then stops monitoring the folder and forgets children of the row.
This API is used when the row is collapsed in the view.
Before 1.0.0 this API had name fm_dir_tree_model_collapse_row.
Since: 0.1.16
const char * fm_dir_tree_row_get_disp_name (FmDirTreeModel *model
,GtkTreeIter *iter
);
Retrieves display name of file associated with row of iter
in model
.
Returned data are owned by model
and should be not freed by caller.
Since: 1.0.0
FmFileInfo * fm_dir_tree_row_get_file_info (FmDirTreeModel *model
,GtkTreeIter *iter
);
Retrieves info for file associated with row of iter
in model
.
Returned data are owned by model
and should be not freed by caller.
Since: 1.0.0
FmPath * fm_dir_tree_row_get_file_path (FmDirTreeModel *model
,GtkTreeIter *iter
);
Retrieves FmPath for file associated with row of iter
in model
.
Returned data are owned by model
and should be not freed by caller.
Since: 1.0.0
GdkPixbuf * fm_dir_tree_row_get_icon (FmDirTreeModel *model
,GtkTreeIter *iter
);
Retrieves an icon associated with row of iter
in model
. Returned
data are owned by model
and should be not freed by caller.
Since: 1.0.0
gboolean fm_dir_tree_row_is_loaded (FmDirTreeModel *model
,GtkTreeIter *iter
);
Checks if the row has its children already retrieved. This check may
need be done since any duplicate calls to fm_dir_tree_model_load_row()
will not emit any duplicate “row-loaded” signal.
Since: 1.0.0
struct FmDirTreeModelClass { GObjectClass parent_class; void (*row_loaded)(FmDirTreeModel* model, GtkTreePath* row); };
Columns of dir tree model
(GdkPixbuf *) icon |
||
(char *) displayed name |
||
(FmFileInfo *) file info |
||
(FmPath *) file path |
||
(FmFolder *) folder object |
“row-loaded”
signalvoid user_function (FmDirTreeModel *model, GtkTreePath *row, gpointer user_data)
The “row-loaded” signal is emitted when content of
folder row
is completely retrieved. It may happen either
after call to fm_dir_tree_model_load_row()
or in time of that call (in case if the folder was already cached in
memory).
See also: fm_dir_tree_model_unload_row()
.
model |
dir tree model instance that received the signal |
|
row |
path to folder row that is ready |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
Since: 1.0.0