//
// $Id: ButtonUtil.java,v 1.3 2003/11/18 01:57:02 ray Exp $

package com.samskivert.swing.util;

import java.beans.PropertyChangeEvent;
import java.beans.PropertyChangeListener;

import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.ItemEvent;
import java.awt.event.ItemListener;

import javax.swing.AbstractButton;
import javax.swing.JToggleButton;
import javax.swing.event.AncestorEvent;
import javax.swing.event.AncestorListener;

import com.samskivert.util.Config;
import com.samskivert.util.IntListUtil;

/**
 * Utilities for buttons.
 */
public class ButtonUtil
{
    /**
     * Set the specified button such that it alternates between being
     * selected and not whenever it is pushed.
     */
    public static synchronized void setToggling (AbstractButton b)
    {
        if (_toggler == null) {
            _toggler = new ActionListener () {
                public void actionPerformed (ActionEvent event)
                {
                    AbstractButton but = (AbstractButton) event.getSource();
                    but.setSelected(!but.isSelected());
                }
            };
        }

        b.addActionListener(_toggler);
    }

    /**
     * Binds the supplied button to the named boolean property in the
     * supplied config repository. When the button is pressed, it will
     * update the config property and when the config property is changed
     * (by the button or by other means) it will update the selected state
     * of the button. When the button is made non-visible, it will be
     * unbound to the config's property and rebound again if it is once
     * again visible.
     */
    public static void bindToProperty (
        String property, Config config, AbstractButton button, boolean defval)
    {
        // create a config binding which will take care of everything
        new ButtonConfigBinding(property, config, button, defval);
    }

    /**
     * Configure the specified button to cause the specified
     * property to cycle through the specified values whenever the button is
     * pressed.
     */
    public static void cycleToProperty (
        final String property, final Config config, AbstractButton button,
        final int[] values)
    {
        button.addActionListener(new ActionListener() {
            public void actionPerformed (ActionEvent event)
            {
                // get the current value and find out where it is in the list
                int oldval = config.getValue(property, values[0]);
                int newidx = (1 + IntListUtil.indexOf(values, oldval))
                    % values.length;
                config.setValue(property, values[newidx]);
            }
        });
    }

    /** Used for {@link #bindToProperty}. */
    protected static class ButtonConfigBinding
        implements AncestorListener, PropertyChangeListener, ItemListener
    {
        public ButtonConfigBinding (String property, Config config,
                                    AbstractButton button, boolean defval)
        {
            _property = property;
            _config = config;
            _button = button;
            _defval = defval;

            // wire ourselves up to the button
            button.addAncestorListener(this);
            button.addItemListener(this);

            // if this is not already a toggle button, we'll need to make
            // it toggle
            if (!(button instanceof JToggleButton)) {
                setToggling(button);
            }
        }

        public void ancestorAdded (AncestorEvent event) {
            // listen for config changes
            _config.addPropertyChangeListener(_property, this);
            // set the button up appropriately
            _button.setSelected(_config.getValue(_property, _defval));
        }

        public void ancestorRemoved (AncestorEvent event) {
            // stop listening for config changes
            _config.removePropertyChangeListener(_property, this);
        }

        public void ancestorMoved (AncestorEvent event) {
            // nothing doing
        }

        public void propertyChange (PropertyChangeEvent event) {
            // update the button
            if (event.getPropertyName().equals(_property)) {
                Boolean value = (Boolean)event.getNewValue();
                _button.setSelected(value.booleanValue());
            }
        }

        public void itemStateChanged (ItemEvent event) {
            boolean selected = (event.getStateChange() == ItemEvent.SELECTED);
            _config.setValue(_property, selected);
        }

        protected String _property;
        protected Config _config;
        protected AbstractButton _button;
        protected boolean _defval;
    }

    /** Our lazily-initialized toggling action listener. */
    protected static ActionListener _toggler;
}

@@ -2124,20 +2124,30 @@
  static 
-void
+ActionListener
  cycleTo
@@ -2274,26 +2274,16 @@
         
-button.add
 ActionLi
@@ -2288,17 +2288,22 @@
 Listener
-(
+ al = 
 new Acti
@@ -2726,17 +2726,73 @@
        %7D
-)
+;%0A        button.addActionListener(al);%0A        return al
 ;%0A    %7D%0A

Return the action listener added in case the caller later wants to remove it.