GimpMemSizeEntry

GimpMemSizeEntry — A composite widget that allows to enter a memory size.

Synopsis

                    GimpMemsizeEntry;
GtkWidget *         gimp_memsize_entry_new              (guint64 value,
                                                         guint64 lower,
                                                         guint64 upper);
void                gimp_memsize_entry_set_value        (GimpMemsizeEntry *entry,
                                                         guint64 value);
guint64             gimp_memsize_entry_get_value        (GimpMemsizeEntry *entry);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBox
                                 +----GimpMemsizeEntry

Implemented Interfaces

GimpMemsizeEntry implements AtkImplementorIface, GtkBuildable and GtkOrientable.

Signals

  "value-changed"                                  : Run First

Description

Similar to a GimpSizeEntry but instead of lengths, this widget is used to let the user enter memory sizes. An option menu allows to switch between Kilobytes, Megabytes and Gigabytes. Used in the GIMP preferences dialog.

Details

GimpMemsizeEntry

typedef struct _GimpMemsizeEntry GimpMemsizeEntry;


gimp_memsize_entry_new ()

GtkWidget *         gimp_memsize_entry_new              (guint64 value,
                                                         guint64 lower,
                                                         guint64 upper);

Creates a new GimpMemsizeEntry which is a GtkHBox with a GtkSpinButton and a GtkOptionMenu all setup to allow the user to enter memory sizes.

value :

the initial value (in Bytes)

lower :

the lower limit for the value (in Bytes)

upper :

the upper limit for the value (in Bytes)

Returns :

Pointer to the new GimpMemsizeEntry.

gimp_memsize_entry_set_value ()

void                gimp_memsize_entry_set_value        (GimpMemsizeEntry *entry,
                                                         guint64 value);

Sets the entry's value. Please note that the GimpMemsizeEntry rounds the value to full Kilobytes.

entry :

a GimpMemsizeEntry

value :

the new value (in Bytes)

gimp_memsize_entry_get_value ()

guint64             gimp_memsize_entry_get_value        (GimpMemsizeEntry *entry);

Retrieves the current value from a GimpMemsizeEntry.

entry :

a GimpMemsizeEntry

Returns :

the current value of entry (in Bytes).

Signal Details

The "value-changed" signal

void                user_function                      (GimpMemsizeEntry *gimpmemsizeentry,
                                                        gpointer          user_data)             : Run First

gimpmemsizeentry :

the object which received the signal.

user_data :

user data set when the signal handler was connected.