GimpUnitMenu

Name

GimpUnitMenu -- Widget for selecting a GimpUnit.

Synopsis



GtkWidget*  gimp_unit_menu_new              (const gchar *format,
                                             GimpUnit unit,
                                             gboolean show_pixels,
                                             gboolean show_percent,
                                             gboolean show_custom);
void        gimp_unit_menu_set_unit         (GimpUnitMenu *gum,
                                             GimpUnit unit);
GimpUnit    gimp_unit_menu_get_unit         (GimpUnitMenu *gum);

Object Hierarchy


  GObject
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkBin
                           +----GtkButton
                                 +----GtkOptionMenu
                                       +----GimpUnitMenu

Signal Prototypes


"unit-changed"
            void        user_function      (GimpUnitMenu *gimpunitmenu,
                                            gpointer user_data);

Description

This widget provides a GtkOptionMenu which contains a list of GimpUnit's.

You can specify the string that will be displayed for each unit by passing a printf-like format string to gimp_unit_menu_new().

The constructor also lets you choose if the menu should contain items for GIMP_UNIT_PIXEL, GIMP_UNIT_PERCENT and a "More..." item which will pop up a dialog for selecting user-defined units.

Whenever the user selects a unit from the menu or the dialog, the "unit_changed" signal will be emitted.

Details

gimp_unit_menu_new ()

GtkWidget*  gimp_unit_menu_new              (const gchar *format,
                                             GimpUnit unit,
                                             gboolean show_pixels,
                                             gboolean show_percent,
                                             gboolean show_custom);

Creates a new GimpUnitMenu widget.

The format string supports the following percent expansions:


gimp_unit_menu_set_unit ()

void        gimp_unit_menu_set_unit         (GimpUnitMenu *gum,
                                             GimpUnit unit);

Sets a new GimpUnit for the specified GimpUnitMenu.


gimp_unit_menu_get_unit ()

GimpUnit    gimp_unit_menu_get_unit         (GimpUnitMenu *gum);

Returns the GimpUnit the user has selected from the GimpUnitMenu.

Signals

The "unit-changed" signal

void        user_function                  (GimpUnitMenu *gimpunitmenu,
                                            gpointer user_data);

This signal is emitted whenever the user selects a GimpUnit from the GimpUnitMenu.

See Also

GimpUnit

GimpSizeEntry

gimp_coordinates_new()