hildon-file-system-info

hildon-file-system-info

Synopsis

                    HildonFileSystemInfoHandle;
                    HildonFileSystemInfo;
void                (*HildonFileSystemInfoCallback)     (HildonFileSystemInfoHandle *handle,
                                                         HildonFileSystemInfo *info,
                                                         const GError *error,
                                                         gpointer data);
HildonFileSystemInfoHandle* hildon_file_system_info_async_new
                                                        (const gchar *uri,
                                                         HildonFileSystemInfoCallback callback,
                                                         gpointer data);
const gchar*        hildon_file_system_info_get_display_name
                                                        (HildonFileSystemInfo *info);
GdkPixbuf*          hildon_file_system_info_get_icon    (HildonFileSystemInfo *info,
                                                         GtkWidget *ref_widget);
GdkPixbuf*          hildon_file_system_info_get_icon_at_size
                                                        (HildonFileSystemInfo *info,
                                                         GtkWidget *ref_widget,
                                                         gint size);
void                hildon_file_system_info_async_cancel
                                                        (HildonFileSystemInfoHandle *handle);
HildonFileSystemInfo* hildon_file_system_info_new       (const gchar *uri,
                                                         GError **error);
void                hildon_file_system_info_free        (HildonFileSystemInfo *info);

Description

Details

HildonFileSystemInfoHandle

typedef struct _HildonFileSystemInfoHandle HildonFileSystemInfoHandle;


HildonFileSystemInfo

typedef struct _HildonFileSystemInfo HildonFileSystemInfo;


HildonFileSystemInfoCallback ()

void                (*HildonFileSystemInfoCallback)     (HildonFileSystemInfoHandle *handle,
                                                         HildonFileSystemInfo *info,
                                                         const GError *error,
                                                         gpointer data);

handle :
info :
error :
data :

hildon_file_system_info_async_new ()

HildonFileSystemInfoHandle* hildon_file_system_info_async_new
                                                        (const gchar *uri,
                                                         HildonFileSystemInfoCallback callback,
                                                         gpointer data);

This function is used to query file statistics (the same ones shown in the file selection widgets). Currently name and icon are supported.

The info structure is only valid while the callback is running. You must not free it yourself.

The handle is valid until the callback has returned or until hildon_file_system_info_async_cancel has been called on it. Once the callback has been entered, you can no longer call hildon_file_system_info_async_cancel.

uri : an URI string.
callback : a pointer to callback function to be invoked when file information is available.
data : User data for callback function.
Returns : a HildonFileSystemInfoHandle or NULL if an error was before setting up asyncronous operation.

hildon_file_system_info_get_display_name ()

const gchar*        hildon_file_system_info_get_display_name
                                                        (HildonFileSystemInfo *info);

Gets user visible name of the location. All special places are named using the current locale.

info : a HildonFileSystemInfo pointer.
Returns : Visible name of the location. The value is owned by HildonFileSystemInfo and there is no need to free it.

hildon_file_system_info_get_icon ()

GdkPixbuf*          hildon_file_system_info_get_icon    (HildonFileSystemInfo *info,
                                                         GtkWidget *ref_widget);

ref_widget: Any widget on the same screen as the new icon. Gets icon for the location. All special places have their special icons. Note that this function is just a special case of hildon_file_system_info_get_icon_at_size.

info : a HildonFileSystemInfo pointer.
ref_widget :
Returns : a GdkPixbuf. The value is owned by HildonFileSystemInfo and there is no need to free it.

hildon_file_system_info_get_icon_at_size ()

GdkPixbuf*          hildon_file_system_info_get_icon_at_size
                                                        (HildonFileSystemInfo *info,
                                                         GtkWidget *ref_widget,
                                                         gint size);

Gets icon for the location. All special places have their special icons.

info : a HildonFileSystemInfo pointer.
ref_widget : Any widget on the same screen as the new icon.
size : Desired size of the icon.
Returns : a GdkPixbuf. The value is owned by HildonFileSystemInfo and there is no need to free it.

hildon_file_system_info_async_cancel ()

void                hildon_file_system_info_async_cancel
                                                        (HildonFileSystemInfoHandle *handle);

handle :

hildon_file_system_info_new ()

HildonFileSystemInfo* hildon_file_system_info_new       (const gchar *uri,
                                                         GError **error);

Warning

hildon_file_system_info_new is deprecated and should not be used in newly-written code.

uri :
error :
Returns :

hildon_file_system_info_free ()

void                hildon_file_system_info_free        (HildonFileSystemInfo *info);

Warning

hildon_file_system_info_free is deprecated and should not be used in newly-written code.

info :