GimpChainButton -- Widget to visually connect two entry widgets.
This widget provides a button showing either a linked or a broken
chain that can be used to link two entries, spinbuttons, colors
or other GUI elements and show that they may be locked. Use it for
example to connect X and Y ratios to provide the possibility of a
constrained aspect ratio.
The GimpChainButton only gives visual feedback, it does not really
connect widgets. You have to take care of locking the values yourself
by checking the state of the GimpChainButton whenever a value changes
in one of the connected widgets and adjusting the other value if
#define GIMP_CHAIN_BUTTON(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_CHAIN_BUTTON, GimpChainButton))
Checks if the passed pointer is a pointer to a GimpChainButton and
performs the cast if valid.
|obj :||The pointer to cast.
Creates a new GimpChainButton widget.
This returns a button showing either a broken or a linked chain and
small clamps attached to both sides that visually group the two widgets
you want to connect. This widget looks best when attached
to a table taking up two columns (or rows respectively) next
to the widgets that it is supposed to connect. It may work
for more than two widgets, but the look is optimized for two.
|position :|| The position you are going to use for the button
with respect to the widgets you want to chain.|
|Returns :|| Pointer to the new GimpChainButton, which is inactive
by default. Use gimp_chain_button_set_active() to
change its state.|
void gimp_chain_button_set_active (GimpChainButton *gcb,
Sets the state of the GimpChainButton to be either locked (TRUE) or
unlocked (FALSE) and changes the showed pixmap to reflect the new state.
The "toggled" signal
|gimpchainbutton :||the object which received the signal.
|user_data :||user data set when the signal handler was connected.|