/*
* Copyright (c) 2002-2004 JGoodies Karsten Lentzsch. All Rights Reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* o Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
*
* o Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* o Neither the name of JGoodies Karsten Lentzsch nor the names of
* its contributors may be used to endorse or promote products derived
* from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
* THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
* OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
* EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
import java.awt.Component;
import javax.swing.JButton;
import javax.swing.JComponent;
import javax.swing.JFrame;
import javax.swing.UIManager;
import javax.swing.WindowConstants;
import com.jgoodies.forms.builder.ButtonBarBuilder;
import com.jgoodies.forms.builder.DefaultFormBuilder;
import com.jgoodies.forms.layout.FormLayout;
/**
* Demonstrates how to build button bars with a fixed button order
* or with a button order that honors the platform's style.
*
* @author Karsten Lentzsch
* @version $Revision: 1.4 $
*
* @see ButtonBarBuilder
* @see com.jgoodies.forms.factories.ButtonBarFactory
*/
public class ButtonOrderExample {
public static void main(String[] args) {
try {
UIManager.setLookAndFeel("com.jgoodies.plaf.plastic.PlasticXPLookAndFeel");
} catch (Exception e) {
// Likely PlasticXP is not in the class path; ignore.
}
JFrame frame = new JFrame();
frame.setTitle("Forms Tutorial :: Button Order");
frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
JComponent panel = new ButtonOrderExample().buildPanel();
frame.getContentPane().add(panel);
frame.pack();
frame.setVisible(true);
}
/**
* Builds and returns a panel that consists of three paragraphs
* that demonstrate different button orders. Each paragraph contains
* a button bar that is built from a button sequence, and another
* bar that is built from individual buttons.
*
* @return a panel that demonstrates button order
*/
public JComponent buildPanel() {
FormLayout layout = new FormLayout("right:pref:grow, 4dlu, pref");
DefaultFormBuilder rowBuilder = new DefaultFormBuilder(layout);
rowBuilder.setDefaultDialogBorder();
rowBuilder.appendSeparator("Left to Right");
rowBuilder.append("Ordered", buildButtonSequence(ButtonBarBuilder.createLeftToRightBuilder()));
rowBuilder.append("Fixed", buildIndividualButtons(ButtonBarBuilder.createLeftToRightBuilder()));
rowBuilder.appendSeparator("Right to Left");
rowBuilder.append("Ordered", buildButtonSequence(createRightToLeftBuilder()));
rowBuilder.append("Fixed", buildIndividualButtons(createRightToLeftBuilder()));
rowBuilder.appendSeparator("Platform Default Order");
rowBuilder.append("Ordered", buildButtonSequence(new ButtonBarBuilder()));
rowBuilder.append("Fixed", buildIndividualButtons(new ButtonBarBuilder()));
return rowBuilder.getPanel();
}
/**
* Builds and returns a button bar honoring the builder's button order.
*
* @param builder the builder used to build the bar
* @return a button bar that honors the builder's button order
*/
private Component buildButtonSequence(ButtonBarBuilder builder) {
builder.addGriddedButtons(new JButton[] {
new JButton("One"),
new JButton("Two"),
new JButton("Three")
});
return builder.getPanel();
}
/**
* Builds and returns a button bar ignoring the builder's button order.
* Instead a fixed left to right order is used.
*
* @param builder the builder used to build the bar
* @return a button bar with a fixed left to right button order
*/
private Component buildIndividualButtons(ButtonBarBuilder builder) {
builder.addGridded(new JButton("One"));
builder.addRelatedGap();
builder.addGridded(new JButton("Two"));
builder.addRelatedGap();
builder.addGridded(new JButton("Three"));
return builder.getPanel();
}
/**
* Creates and returns a button bar builder with a fixed
* right-to-left button order. Unlike the factory method
* {@link ButtonBarBuilder#createLeftToRightBuilder()}
* this method is useful for demonstration purposes only.
*
* @return a ButtonBarBuilder with right-to-left button order
*/
private static ButtonBarBuilder createRightToLeftBuilder() {
ButtonBarBuilder builder = new ButtonBarBuilder();
builder.setLeftToRightButtonOrder(false);
return builder;
}
}
|