GimpMemsizeEntry

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

Synopsis




struct      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
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkBox
                           +----GtkHBox
                                 +----GimpMemsizeEntry

Implemented Interfaces

GimpMemsizeEntry implements AtkImplementorIface.

Signal Prototypes


"value-changed"
            void        user_function      (GimpMemsizeEntry *gimpmemsizeentry,
                                            gpointer user_data);

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

struct GimpMemsizeEntry

struct GimpMemsizeEntry;

The GimpSizeEntry struct is considered private.

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).

Signals

The "value-changed" signal

void        user_function                  (GimpMemsizeEntry *gimpmemsizeentry,
                                            gpointer user_data);

`gimpmemsizeentry` :	the object which received the signal.
`user_data` :	user data set when the signal handler was connected.