HildonFileDetailsDialog

HildonFileDetailsDialog — Hildon file details dialog

Synopsis

                    HildonFileDetailsDialogPrivate;
                    HildonFileDetailsDialog;
GtkWidget*          hildon_file_details_dialog_new      (GtkWindow *parent,
                                                         const gchar *filename);
GtkWidget*          hildon_file_details_dialog_new_with_model
                                                        (GtkWindow *parent,
                                                         HildonFileSystemModel *model);
void                hildon_file_details_dialog_set_file_iter
                                                        (HildonFileDetailsDialog *self,
                                                         GtkTreeIter *iter);
gboolean            hildon_file_details_dialog_get_file_iter
                                                        (HildonFileDetailsDialog *self,
                                                         GtkTreeIter *iter);
GtkWidget*          hildon_file_details_dialog_add_label_with_value
                                                        (HildonFileDetailsDialog *dialog,
                                                         const gchar *label,
                                                         const gchar *value);
gchar*              hildon_format_file_size_for_display (gint64 size);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkWindow
                                       +----GtkDialog
                                             +----HildonFileDetailsDialog

Implemented Interfaces

HildonFileDetailsDialog implements AtkImplementorIface and GtkBuildable.

Properties

  "additional-tab"           GtkWidget*            : Read / Write / Construct
  "additional-tab-label"     gchar*                : Read / Write
  "enable-read-only-checkbox" gboolean              : Read / Write / Construct
  "model"                    HildonFileSystemModel*  : Read / Write
  "show-tabs"                gboolean              : Read / Write / Construct
  "show-type-icon"           gboolean              : Read / Write / Construct

Description

Provides a dialog box for displaying file and folder details.

Details

HildonFileDetailsDialogPrivate

typedef struct _HildonFileDetailsDialogPrivate HildonFileDetailsDialogPrivate;


HildonFileDetailsDialog

typedef struct _HildonFileDetailsDialog HildonFileDetailsDialog;


hildon_file_details_dialog_new ()

GtkWidget*          hildon_file_details_dialog_new      (GtkWindow *parent,
                                                         const gchar *filename);

Warning

hildon_file_details_dialog_new is deprecated and should not be used in newly-written code. use hildon_file_details_dialog_new_with_model() instead.

Creates a new hildon_file_details_dialog AND new underlying HildonFileSystemModel. Be carefull with filename parameter: You don't get any notification if something fails.

parent : the parent window.
filename : the filename.
Returns : a new HildonFileDetailsDialog.

hildon_file_details_dialog_new_with_model ()

GtkWidget*          hildon_file_details_dialog_new_with_model
                                                        (GtkWindow *parent,
                                                         HildonFileSystemModel *model);

This is the preferred way to create HildonFileDetailsDialog. You can use a shared model structure to save loading times (because you probably already have one at your disposal).

parent : the parent window.
model : a HildonFileSystemModel object used to fetch data.
Returns : a new HildonFileDetailsDialog.

hildon_file_details_dialog_set_file_iter ()

void                hildon_file_details_dialog_set_file_iter
                                                        (HildonFileDetailsDialog *self,
                                                         GtkTreeIter *iter);

Sets the dialog to display information about a file defined by given iterator.

self : a HildonFileDetailsDialog.
iter : a GtkTreeIter pointing to desired file.

hildon_file_details_dialog_get_file_iter ()

gboolean            hildon_file_details_dialog_get_file_iter
                                                        (HildonFileDetailsDialog *self,
                                                         GtkTreeIter *iter);

Gets an iterator pointing to displayed file.

self : a HildonFileDetailsDialog.
iter : a GtkTreeIter to be filled.
Returns : TRUE, if dialog is displaying some information.

hildon_file_details_dialog_add_label_with_value ()

GtkWidget*          hildon_file_details_dialog_add_label_with_value
                                                        (HildonFileDetailsDialog *dialog,
                                                         const gchar *label,
                                                         const gchar *value);

Adds an additional row with a label and a string to the dialog.

dialog : the dialog
label : a label string
value : a value string
Returns : a HildonCaption

Since 2.13


hildon_format_file_size_for_display ()

gchar*              hildon_format_file_size_for_display (gint64 size);

Formats a file size in bytes for display in applications.

This function is similar to g_format_file_size_for_display but the translations are from Maemo so might differ slightly.

size : a size in bytes
Returns : a newly allocated string with the formatted size.

Since 2.1.7

Property Details

The "additional-tab" property

  "additional-tab"           GtkWidget*            : Read / Write / Construct

Deprecated: since 2.22: There is no support for tabs in details dialog.


The "additional-tab-label" property

  "additional-tab-label"     gchar*                : Read / Write

Deprecated: since 2.22: There is no support for tabs in details dialog.

Default value: NULL


The "enable-read-only-checkbox" property

  "enable-read-only-checkbox" gboolean              : Read / Write / Construct

Whether or not to enable the read-only checkbox.

Default value: TRUE


The "model" property

  "model"                    HildonFileSystemModel*  : Read / Write

HildonFileSystemModel to use when fetching information.


The "show-tabs" property

  "show-tabs"                gboolean              : Read / Write / Construct

Deprecated: since 2.22: There is no support for tabs in details dialog.

Default value: FALSE


The "show-type-icon" property

  "show-type-icon"           gboolean              : Read / Write / Construct

Whether or not to show the file icon next to the file type

Default value: FALSE