SAKAI Masahiro - Gimp::UI::ChainButton Diff

= Gimp::UI::ChainButton

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 ChainButton 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 ChainButton whenever a value changes in one of the connected widgets and
adjusting the other value if necessary.

==  Constants

--- Gimp::UI::ChainButton::TOP
--- Gimp::UI::ChainButton::LEFT
--- Gimp::UI::ChainButton::BUTTON
--- Gimp::UI::ChainButton::RIGHT

==  Class Methods

--- Gimp::UI::ChainButton.new([position])
    position: The position you are going to use for the button
              with respect to the widgets you want to chain.
    
    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.
    
    Returns: the new Gimp::ChainButton, which is inactive by default.
             Use active= to change its state.

==  Methods:

Gimp::UI::ChainButton#position
    -

Gimp::UI::ChainButton#active
    Checks the state

Gimp::UI::ChainButton#active=(state)
    Sets the state to be either locked (true) or unlocked (false) and
    changes the showed pixmap to reflect the new state.

Gimp::UI::ChainButton#button
Gimp::UI::ChainButton#line1
Gimp::UI::ChainButton#line2
Gimp::UI::ChainButton#pixmap
Gimp::UI::ChainButton#broken
Gimp::UI::ChainButton#broken_mask
Gimp::UI::ChainButton#chain

    構成Widget