GimpButton

GimpButton — A GtkButton with a little extra functionality.

Synopsis

                    GimpButton;
GtkWidget *         gimp_button_new                     (void);
void                gimp_button_extended_clicked        (GimpButton *button,
                                                         GdkModifierType state);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkButton
                                       +----GimpButton
                                             +----GimpColorButton

Implemented Interfaces

GimpButton implements AtkImplementorIface, GtkBuildable and GtkActivatable.

Signals

  "extended-clicked"                               : Run First

Description

GimpButton adds an extra signal to the GtkButton widget that allows to distinguish a normal click from a click that was performed with modifier keys pressed.

Details

GimpButton

typedef struct _GimpButton GimpButton;


gimp_button_new ()

GtkWidget *         gimp_button_new                     (void);

Creates a new GimpButton widget.

Returns :

A pointer to the new GimpButton widget.

gimp_button_extended_clicked ()

void                gimp_button_extended_clicked        (GimpButton *button,
                                                         GdkModifierType state);

Emits the button's "extended_clicked" signal.

button :

a GimpButton.

state :

a state as found in GdkEventButton->state, e.g. GDK_SHIFT_MASK.

Signal Details

The "extended-clicked" signal

void                user_function                      (GimpButton     *gimpbutton,
                                                        GdkModifierType arg1,
                                                        gpointer        user_data)       : Run First

This signal is emitted when the button is clicked with a modifier key pressed.

gimpbutton :

the object that received the signal.

arg1 :

the state of modifier keys when the button was clicked

user_data :

user data set when the signal handler was connected.