gwy_adjustment_get_int()

#define gwy_adjustment_get_int(adj) ((gint)floor(gtk_adjustment_get_value(GTK_ADJUSTMENT(adj)) + 0.5))

Gets a properly rounded integer value from an adjustment, cast to gint.

gwy_gtkgrid_attach_adjbar()

GtkWidget *
gwy_gtkgrid_attach_adjbar (GtkGrid *grid,
                           gint row,
                           const gchar *name,
                           const gchar *units,
                           GObject *pivot,
                           GwyHScaleStyle style);

Attaches an adjustment bar with spinbutton and labels, or something else, to a grid row.

The group of controls takes three grid columns: adjustment bar, spinbutton and units.

You can use functions gwy_gtkgrid_hscale_get_scale(), gwy_gtkgrid_hscale_get_check(), etc. to get the various widgets from pivot later.

The function usually does the right thing but what exactly happens with various style values is a bit convoluted.

gwy_gtkgrid_hscale_set_sensitive()

void
gwy_gtkgrid_hscale_set_sensitive (GObject *pivot,
                                  gboolean sensitive);

Sets sensitivity of a group of controls created by gwy_gtkgrid_attach_adjbar().

For controls without an enable/disable check button controls the sensitivity as expected. If the hscale was created with GWY_HSCALE_CHECK you usually manage its sensitivity by setting state of the check button instead. Only use this function when you want to enable/disable the entire group of controls, including the check button.

gwy_gtkgrid_hscale_get_scale()

GtkWidget *
gwy_gtkgrid_hscale_get_scale (GObject *pivot);

Gets the horizontal scale associated with a pivot object.

May return NULL if constructed with GWY_HSCALE_NO_SCALE, GWY_HSCALE_WIDGET, or GWY_HSCALE_WIDGET_NO_EXPAND.

gwy_gtkgrid_hscale_get_check()

GtkWidget *
gwy_gtkgrid_hscale_get_check (GObject *pivot);

Gets the check button associated with a pivot object.

May return NULL if not constructed with GWY_HSCALE_CHECK.

gwy_gtkgrid_hscale_get_label()

GtkWidget *
gwy_gtkgrid_hscale_get_label (GObject *pivot);

Gets the (left) label associated with a pivot object.

May return NULL if constructed with GWY_HSCALE_CHECK.

gwy_gtkgrid_hscale_get_units()

GtkWidget *
gwy_gtkgrid_hscale_get_units (GObject *pivot);

Gets the units label associated with a pivot object.

May return NULL if constructed without units.

gwy_gtkgrid_hscale_get_middle_widget()

GtkWidget *
gwy_gtkgrid_hscale_get_middle_widget (GObject *pivot);

Gets the middle widget associated with a pivot object.

gwy_mask_color_selector_run()

void
gwy_mask_color_selector_run (const gchar *dialog_title,
                             GtkWindow *parent,
                             GwyColorButton *color_button,
                             GwyDict *container,
                             GQuark quark);

Creates and runs a color selector dialog for a mask.

Note this function does not return anything, it runs the color selection dialog modally and returns when it is finished.

gwy_list_store_row_changed()

void
gwy_list_store_row_changed (GtkListStore *store,
                            GtkTreeIter *iter,
                            GtkTreePath *path,
                            gint row);

Convenience function to emit "GtkTreeModel::row-changed" signal on a tree store.

At least one of iter , path , row must be set to identify the row to emit "row-changed" on, and usually exactly one should be set. The remaining information necessary to call gtk_tree_model_row_changed() is inferred automatically.

The behaviour of this function is undefined for specified, but inconsistent iter , path , and row .

gwy_label_new_header()

GtkWidget *
gwy_label_new_header (const gchar *text);

Creates a bold, left aligned label.

The purpose of this function is to avoid propagation of too much markup to translations (and to reduce code clutter by avoiding dummy constructor and left-aligning automatically).

gwy_create_stock_like_button()

GtkWidget *
gwy_create_stock_like_button (const gchar *label_text,
                              const gchar *icon_name);

Creates a button that looks like a stock button, but can have different label text.

The button created by this function always have an icon if it exists, regardless of user preferences.

gwy_create_image_menu_item()

GtkWidget *
gwy_create_image_menu_item (const gchar *label_text,
                            const gchar *icon_name,
                            gboolean always_show);

Creates a menu item with image.

This function either wraps the deprecated GtkImageMenuItem and contains the deprecation in one place, or it reimplements menu items with images by other means. The returned widget is a subclass of GtkMenuItem.

The icon can later be changed by gwy_set_image_menu_item_icon().

gwy_set_image_menu_item_icon()

void
gwy_set_image_menu_item_icon (GtkMenuItem *item,
                              const gchar *icon_name);

Sets the icon of a menu item with image.

gwy_set_image_menu_item_pixbuf()

void
gwy_set_image_menu_item_pixbuf (GtkMenuItem *item,
                                GdkPixbuf *pixbuf);

Sets the image of a menu item with image to a pixbuf.

gwy_stock_label()

const gchar *
gwy_stock_label (GwyStockItem item);

Obtains a predefined common label.

The returned string is already translated.

The label goes together with the icon obtained with gwy_stock_icon_name() and response code obtained with gwy_stock_response().

gwy_stock_icon_name()

const gchar *
gwy_stock_icon_name (GwyStockItem item);

Obtains a predefined common icon name.

Not all items have an associated icon name. The function may return NULL.

The icon goes together with the label obtained with gwy_stock_label() and response code obtained with gwy_stock_response().

gwy_stock_response()

gint
gwy_stock_response (GwyStockItem item);

Obtains a predefined dialog response.

The response is from GwyResponseType enum and goes together with the label obtained with gwy_stock_label() and icon obtained with gwy_stock_icon_name().

gwy_stock_add_button_to_dialog()

GtkWidget *
gwy_stock_add_button_to_dialog (GtkDialog *dialog,
                                GwyStockItem item);

Adds a standard button to a dialog.

The button may actually have an icon or it may not, depending on user preferences. Create a button directly with gwy_create_stock_like_button() if the button must have an icon.

gwy_create_stock_button()

GtkWidget *
gwy_create_stock_button (GwyStockItem item);

Creates a standard button.

See gwy_stock_add_button_to_dialog() if you want to add a standard button to a dialog. The button created by this function always has an icon if the stock item has one associtated, regardless of user preferences.

gwy_widget_get_activate_on_unfocus()

gboolean
gwy_widget_get_activate_on_unfocus (GtkWidget *widget);

Obtains the activate-on-unfocus state of a widget.

gwy_widget_set_activate_on_unfocus()

void
gwy_widget_set_activate_on_unfocus (GtkWidget *widget,
                                    gboolean activate);

Sets the activate-on-unfocus state of a widget.

When it is enabled, signal "GtkWidget::activate" is emited whenever focus leaves the widget.

gwy_widget_sync_sensitivity()

void
gwy_widget_sync_sensitivity (GtkWidget *master,
                             GtkWidget *slave);

Make widget's sensitivity follow the sensitivity of another widget.

The sensitivity of slave is set according to master 's effective sensitivity (as returned by GTK_WIDGET_IS_SENSITIVE()), i.e. it does not just synchronize GtkWidget:sensitive property.

gwy_widget_is_hbox()

gboolean
gwy_widget_is_hbox (GtkWidget *widget);

Checks if a widget is a GTK+ horizontal box.

The function checks whether the widget is a GtkBox and also whether it is horizontal. The latter can change in principle, so the check should to be used when it makes sense.

gwy_add_button_to_dialog()

GtkWidget *
gwy_add_button_to_dialog (GtkDialog *dialog,
                          const gchar *label_text,
                          const gchar *icon_name,
                          gint response_id);

Adds a button with an icon to a dialog.

The button may actually have an icon or it may not, depending on user preferences. Create a button directly with gwy_create_stock_like_button() if the button must have an icon.

gwy_set_message_label()

void
gwy_set_message_label (GtkLabel *label,
                       const gchar *text,
                       GtkMessageType type,
                       gboolean is_markup);

Sets the text of a label according to message type style.

gwy_set_widget_margins()

void
gwy_set_widget_margins (GtkWidget *widget,
                        gint start,
                        gint end,
                        gint top,
                        gint bottom);

Set multiple widget margins.

This is a convenience wrapper for multiple calls to gtk_widget_set_margin_start() and similar functions.

gwy_get_screen_size()

gboolean
gwy_get_screen_size (GtkWidget *widget,
                     gint *width,
                     gint *height);

Gets the working area size of widget's screen.

If widget is NULL, the default screen is substituted. The function can be used to check whether we might be going to to create an unreasonably large window. If, for whatever reason, we cannot obtain the screen size, the function still sets the width and height to reasonable values.

gwy_strip_menu_item_label()

gchar *
gwy_strip_menu_item_label (gchar *label);

Removes mnemonics and ellipses from a label string.

The label should not contain XML. Pango markup is currently preserved, but it may be stripped in future, so the behaviour is undefined.

The label should not contain arbitrary content like file names. Odd labels can arise.

enum GwyStockItem

Type of predefined labels.

enum GwyHScaleStyle

Options controlling gwy_table_attach_adjbar() and gwy_table_attach_hscale() behaviour.

enum GwyResponseType

Type of predefined dialog response types.