ThunarVfsInfo

ThunarVfsInfo —

Synopsis


#include <thunar-vfs/thunar-vfs.h>


ThunarVfsInfo* thunar_vfs_info_new_for_path (ThunarVfsPath *path,
                                             GError **error);
ThunarVfsInfo* thunar_vfs_info_ref          (ThunarVfsInfo *info);
void        thunar_vfs_info_unref           (ThunarVfsInfo *info);
gboolean    thunar_vfs_info_execute         (const ThunarVfsInfo *info,
                                             GdkScreen *screen,
                                             GList *path_list,
                                             GError **error);
gboolean    thunar_vfs_info_rename          (ThunarVfsInfo *info,
                                             const gchar *name,
                                             GError **error);
const gchar* thunar_vfs_info_get_hint       (const ThunarVfsInfo *info,
                                             ThunarVfsFileHint hint);
gboolean    thunar_vfs_info_matches         (const ThunarVfsInfo *a,
                                             const ThunarVfsInfo *b);
void        thunar_vfs_info_list_free       (GList *info_list);


Description

Details

thunar_vfs_info_new_for_path ()

ThunarVfsInfo* thunar_vfs_info_new_for_path (ThunarVfsPath *path,
                                             GError **error);

Queries the ThunarVfsInfo for the given path. Returns the ThunarVfsInfo if the operation is successfull, else NULL. In the latter case, error will be set to point to a GError describing the cause of the failure.

path : the ThunarVfsPath of the file whose info should be queried.
error : return location for errors or NULL.
Returns : the ThunarVfsInfo for path or NULL.

thunar_vfs_info_ref ()

ThunarVfsInfo* thunar_vfs_info_ref          (ThunarVfsInfo *info);

Increments the reference count on info by 1 and returns a pointer to info.

info : a ThunarVfsInfo.
Returns : a pointer to info.

thunar_vfs_info_unref ()

void        thunar_vfs_info_unref           (ThunarVfsInfo *info);

Decrements the reference count on info by 1 and if the reference count drops to zero as a result of this operation, the info will be freed completely.

info : a ThunarVfsInfo.

thunar_vfs_info_execute ()

gboolean    thunar_vfs_info_execute         (const ThunarVfsInfo *info,
                                             GdkScreen *screen,
                                             GList *path_list,
                                             GError **error);

Executes the file referred to by info, given path_list as parameters, on the specified screen. info may refer to either a regular, executable file, or a .desktop file, whose type is Application.

info : a ThunarVfsInfo.
screen : a GdkScreen or NULL to use the default GdkScreen.
path_list : the list of ThunarVfsPaths to give as parameters to the file referred to by info on execution.
error : return location for errors or NULL.
Returns : TRUE on success, else FALSE.

thunar_vfs_info_rename ()

gboolean    thunar_vfs_info_rename          (ThunarVfsInfo *info,
                                             const gchar *name,
                                             GError **error);

Tries to rename the file referred to by info to the new name.

The rename operation is smart in that it checks the type of info first, and if info refers to a .desktop file, the file name won't be touched, but instead the Name field of the .desktop will be changed to name. Else, if info refers to a regular file or directory, the file will be given a new name.

info : a ThunarVfsInfo.
name : the new file name in UTF-8 encoding.
error : return location for errors or NULL.
Returns : TRUE on success, else FALSE.

thunar_vfs_info_get_hint ()

const gchar* thunar_vfs_info_get_hint       (const ThunarVfsInfo *info,
                                             ThunarVfsFileHint hint);

If info provides the hint, then the value available for hint will be returned. Else NULL will be returned.

The returned string - if any - is owned by info and must not be freed by the caller. You should thereby note that the returned string is no longer valid after info is finalized.

info : a ThunarVfsInfo.
hint : a ThunarVfsFileHint.
Returns : the string stored for hint on info or NULL.

thunar_vfs_info_matches ()

gboolean    thunar_vfs_info_matches         (const ThunarVfsInfo *a,
                                             const ThunarVfsInfo *b);

Checks whether a and b refer to the same file and share the same properties.

a : a ThunarVfsInfo.
b : a ThunarVfsInfo.
Returns : TRUE if a and b match.

thunar_vfs_info_list_free ()

void        thunar_vfs_info_list_free       (GList *info_list);

Unrefs all ThunarVfsInfos in info_list and frees the list itself.

This method always returns NULL for the convenience of being able to do:

info_list = thunar_vfs_info_list_free (info_list);

info_list : a list ThunarVfsInfos.