import org.openide.awt.ToolbarWithOverflow;

                        tb.putClientProperty("PreferredIconSize",null); //NOI18N

                        tb.putClientProperty("PreferredIconSize",Integer.valueOf(24)); //NOI18N

import org.openide.awt.ToolbarWithOverflow;

    <change id="ToolbarWithOverflow">

      <api name="awt"/>

      <summary>ToolbarWithOverflow class that adds an overflow button when the toolbar becomes too small to show all the available actions.</summary>

      <version major="7" minor="50"/>

      <date day="7" month="8" year="2012"/>

      <author login="theofanis"/>

      <compatibility addition="yes" binary="compatible" source="compatible" deprecation="no" semantic="compatible" modification="no" deletion="no"/>

      <description>

          ToolbarWithOverflow class is added. It can be used to add an overflow button 

          when the toolbar becomes too small to show all the available actions.

      </description>

      <class package="org.openide.awt" name="ToolbarWithOverflow"/>

      <issue number="216175"/>

    </change>

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2012 Oracle and/or its affiliates. All rights reserved.

 *

 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.

 * Other names may be trademarks of their respective owners.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 *

 * Contributor(s):

 *

 * Portions Copyrighted 2012 Sun Microsystems, Inc.

 */

package org.openide.awt;

import java.awt.Component;

import java.awt.Dimension;

import java.awt.event.ComponentAdapter;

import java.awt.event.ComponentEvent;

import java.awt.event.MouseAdapter;

import java.awt.event.MouseEvent;

import javax.swing.JButton;

import javax.swing.JComponent;

import javax.swing.JPopupMenu;

import javax.swing.JToolBar;

import org.openide.util.ImageUtilities;

/**

 * ToolbarWithOverflow provides a component which is useful for displaying commonly used

 * actions.  It adds an overflow button when the toolbar becomes too small to show all the

 * available actions.

 *

 * @author Th. Oikonomou

 * @since 7.50

 */

public class ToolbarWithOverflow extends JToolBar {

    private JButton overflowButton;

    private JPopupMenu popup;

    private JToolBar overflowToolbar;

    private int visibleButtons;

    private final String overflowIcon = "org/openide/awt/resources/overflow_right.png"; //NOI18N

    private final String PROP_PREF_ICON_SIZE = "PreferredIconSize"; //NOI18N

    private final String PROP_DRAGGER = "_toolbar_dragger_"; //NOI18N

    /**

     * Creates a new tool bar; orientation defaults to

     * <code>HORIZONTAL</code>.

     */

    public ToolbarWithOverflow() {

        this(HORIZONTAL);

    }

    /**

     * Creates a new tool bar with the specified

     * <code>orientation</code>. The

     * <code>orientation</code> must be either

     * <code>HORIZONTAL</code> or

     * <code>VERTICAL</code>.

     *

     * @param orientation the orientation desired

     */

    public ToolbarWithOverflow(int orientation) {

        this(null, orientation);

    }

    /**

     * Creates a new tool bar with the specified

     * <code>name</code>. The name is used as the title of the undocked tool

     * bar. The default orientation is

     * <code>HORIZONTAL</code>.

     *

     * @param name the name of the tool bar

     */

    public ToolbarWithOverflow(String name) {

        this(name, HORIZONTAL);

    }

    /**

     * Creates a new tool bar with a specified

     * <code>name</code> and

     * <code>orientation</code>. All other constructors call this constructor.

     * If

     * <code>orientation</code> is an invalid value, an exception will be

     * thrown.

     *

     * @param name the name of the tool bar

     * @param orientation the initial orientation -- it must be     *		either <code>HORIZONTAL</code> or <code>VERTICAL</code>

     * @exception IllegalArgumentException if orientation is neither

     * <code>HORIZONTAL</code> nor <code>VERTICAL</code>

     */

    public ToolbarWithOverflow(String name, int orientation) {

        super(name, orientation);

        overflowButton = new JButton(ImageUtilities.loadImageIcon(overflowIcon, false));

        popup = new JPopupMenu();

        overflowToolbar = new JToolBar("overflowToolbar", orientation == HORIZONTAL ? VERTICAL : HORIZONTAL);

        overflowToolbar.setFloatable(false);

        overflowButton.addMouseListener(new MouseAdapter() {

            @Override

            public void mouseClicked(MouseEvent e) {

                popup.show(overflowButton, 0, overflowButton.getHeight());

            }

        });

        addComponentListener(new ComponentAdapter() {

            @Override

            public void componentResized(ComponentEvent e) {

                maybeAddOverflow();

            }

        });

    }

    @Override

    public void removeAll() {

        super.removeAll();

        overflowToolbar.removeAll();

    }

    @Override

    public final Dimension getPreferredSize() {

        Component[] comps = getAllComponents();

        int width = 0;

        int height = 0;

        for (int i = 0; i < comps.length; i++) {

            Component comp = comps[i];

            width += getOrientation() == HORIZONTAL ? comp.getPreferredSize().width : comp.getPreferredSize().height;

            height = getOrientation() == HORIZONTAL ? comp.getPreferredSize().height : comp.getPreferredSize().width;

        }

        if(overflowToolbar.getComponentCount() > 0) {

            width += getOrientation() == HORIZONTAL ? overflowButton.getPreferredSize().width : overflowButton.getPreferredSize().height;

        }

        Dimension dim = getOrientation() == HORIZONTAL ? new Dimension(width, height) : new Dimension(height, width);

        return dim;        

    }

    /**

     * Determines if an overflow button should be added to or removed from the toolbar.

     */

    private void maybeAddOverflow() {

        computeVisibleButtons();

        if (visibleButtons == -1) {

            handleOverflowRemoval();

        } else {

            handleOverflowAddittion();

        }

        validate();

        repaint();

    }

    private void computeVisibleButtons() {

        handleIconResize();

        Component[] comps = getAllComponents();

        int sizeSoFar = 0;

        int maxSize = getOrientation() == HORIZONTAL ? getWidth() : getHeight();

        int overflowButtonSize = getOrientation() == HORIZONTAL ? overflowButton.getPreferredSize().width : overflowButton.getPreferredSize().height;

        for (int i = 0; i < comps.length; i++) {

            Component comp = comps[i];

            sizeSoFar += getOrientation() == HORIZONTAL ? comp.getPreferredSize().width : comp.getPreferredSize().height;

            if (sizeSoFar > maxSize) {

                visibleButtons = i;

                break;

            } else {

                if (sizeSoFar + overflowButtonSize > maxSize && i + 1 != comps.length) {

                    visibleButtons = i;

                    break;

                } else {

                    visibleButtons = i + 1;

                }

            }

        }

        if(visibleButtons == 0 && comps.length > 0) {            

            if (comps[0] instanceof JComponent) {

                if (Boolean.TRUE.equals(((JComponent) comps[0]).getClientProperty(PROP_DRAGGER))) {

                    visibleButtons = 1;

                }

            }

        }

        if (visibleButtons == comps.length) {

            visibleButtons = -1;

        }

    }

    private void handleOverflowAddittion() {

        Component[] comps = getAllComponents();

        if (visibleButtons <= comps.length) {

            removeAll();

            overflowToolbar.setOrientation(getOrientation() == HORIZONTAL ? VERTICAL : HORIZONTAL);

            popup.removeAll();

            for (int i = 0; i < visibleButtons; i++) {

                add(comps[i]);

            }

            for (int i = visibleButtons; i < comps.length; i++) {

                overflowToolbar.add(comps[i]);

            }

            popup.add(overflowToolbar);

            add(overflowButton);

        }

    }

    private void handleOverflowRemoval() {

        if (overflowToolbar.getComponents().length > 0) {

            remove(overflowButton);

            handleIconResize();

            for (Component comp : overflowToolbar.getComponents()) {

                add(comp);

            }

            overflowToolbar.removeAll();

            popup.removeAll();

        }

    }

    private void handleIconResize() {

        for (Component comp : overflowToolbar.getComponents()) {

            boolean smallToolbarIcons = getClientProperty(PROP_PREF_ICON_SIZE) == null;

            if (smallToolbarIcons) {

                ((JComponent) comp).putClientProperty(PROP_PREF_ICON_SIZE, null);

            } else {

                ((JComponent) comp).putClientProperty(PROP_PREF_ICON_SIZE, Integer.valueOf(24));

            }

        }

    }

    private Component[] getAllComponents() {

        Component[] toolbarComps;

        Component[] overflowComps = overflowToolbar.getComponents();

        if (overflowComps.length == 0) {

            toolbarComps = getComponents();

        } else {

            if (getComponentCount() > 0) {

                toolbarComps = new Component[getComponents().length - 1];

                System.arraycopy(getComponents(), 0, toolbarComps, 0, toolbarComps.length);

            } else {

                toolbarComps = new Component[0];

            }

        }

        Component[] comps = new Component[toolbarComps.length + overflowComps.length];

        System.arraycopy(toolbarComps, 0, comps, 0, toolbarComps.length);

        System.arraycopy(overflowComps, 0, comps, toolbarComps.length, overflowComps.length);

        return comps;

    }

}