Examples of org.gwt.mosaic.forms.client.builder.ButtonBarBuilder

Package org.gwt.mosaic.forms.client.builder

Examples of org.gwt.mosaic.forms.client.builder.ButtonBarBuilder

org.gwt.mosaic.forms.client.builder.ButtonBarBuilder
A non-visual builder that assists you in building consistent button bars that comply with popular UI style guides. It utilizes the {@link FormLayout}. This class is in turn used by the {@link org.gwt.mosaic.forms.client.factories.ButtonBarFactory} that providesan even higher level of abstraction for building consistent button bars.
Buttons added to the builder are either gridded or fixed and may fill their FormLayout cell or not. All gridded buttons get the same width, while fixed buttons use their own size. Gridded buttons honor the default minimum button width as specified by the current {@link LayoutStyle}.
You can set an optional hint for narrow margin for the fixed width buttons. This is useful if you want to lay out a button bar that includes a button with a long text. For example, in a bar with 'Copy to Clipboard', 'OK', 'Cancel' you may declare the clipboard button as a fixed size button with narrow margins, OK and Cancel as gridded. Gridded buttons are marked as narrow by default.
To honor the platform's button order (left-to-right vs. right-to-left) this builder uses the leftToRightButtonOrder property. It is initialized with the current LayoutStyle's button order, which in turn is left-to-right on most platforms and right-to-left on the Mac OS X. Builder methods that create sequences of buttons (e.g. {@link #addGriddedButtons(Button[])} honorthe button order. If you want to ignore the default button order, you can either add individual buttons, or create a ButtonBarBuilder instance with the order set to left-to-right. For the latter see {@link #createLeftToRightBuilder()}. Also see the button order example below.
Example:
The following example builds a button bar with Help button on the left-hand side and OK, Cancel, Apply buttons on the right-hand side.
```
 private JPanel createHelpOKCancelApplyBar( JButton help, JButton ok, JButton cancel, JButton apply) { ButtonBarBuilder builder = new ButtonBarBuilder(); builder.addGridded(help); builder.addUnrelatedGap(); builder.addGlue(); builder.addGriddedButtons(new JButton[]{ok, cancel, apply}); return builder.getPanel(); } 
```
Button Order Example:
The following example builds three button bars where one honors the platform's button order and the other two ignore it.
```
 public JComponent buildPanel() { FormLayout layout = new FormLayout("pref"); DefaultFormBuilder rowBuilder = new DefaultFormBuilder(layout); rowBuilder.setDefaultDialogBorder(); rowBuilder.append(buildButtonSequence(new ButtonBarBuilder())); rowBuilder.append(buildButtonSequence(ButtonBarBuilder.createLeftToRightBuilder())); rowBuilder.append(buildIndividualButtons(new ButtonBarBuilder())); return rowBuilder.getPanel(); } private Component buildButtonSequence(ButtonBarBuilder builder) { builder.addGriddedButtons(new JButton[] { new JButton("One"), new JButton("Two"), new JButton("Three") }); return builder.getPanel(); } 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(); } 
```
@author Karsten Lentzsch @author georgopoulos.georgios@gmail.com @see ButtonStackBuilder @see ButtonBarFactory @see LayoutStyle

   * 
   * @param buttons an array of buttons to add
   * @return a left aligned button bar with the given buttons
   */
  public static LayoutPanel buildLeftAlignedBar(Button[] buttons) {
    ButtonBarBuilder builder = new ButtonBarBuilder();
    builder.addGriddedButtons(buttons);
    builder.addGlue();
    return builder.getPanel();
  }

View Full Code Here

   * @param leftToRightButtonOrder the order in which the buttons to add
   * @return a left aligned button bar with the given buttons
   */
  public static LayoutPanel buildLeftAlignedBar(Button[] buttons,
      boolean leftToRightButtonOrder) {
    ButtonBarBuilder builder = new ButtonBarBuilder();
    builder.setLeftToRightButtonOrder(leftToRightButtonOrder);
    builder.addGriddedButtons(buttons);
    builder.addGlue();
    return builder.getPanel();
  }

View Full Code Here

   * 
   * @param buttons an array of buttons to add
   * @return a centered button bar with the given buttons
   */
  public static LayoutPanel buildCenteredBar(Button[] buttons) {
    ButtonBarBuilder builder = new ButtonBarBuilder();
    builder.addGlue();
    builder.addGriddedButtons(buttons);
    builder.addGlue();
    return builder.getPanel();
  }

View Full Code Here

   * 
   * @param buttons an array of buttons to add
   * @return a filled button bar with the given buttons
   */
  public static LayoutPanel buildGrowingBar(Button[] buttons) {
    ButtonBarBuilder builder = new ButtonBarBuilder();
    builder.addGriddedGrowingButtons(buttons);
    return builder.getPanel();
  }

View Full Code Here

   * 
   * @param buttons an array of buttons to add
   * @return a right aligned button bar with the given buttons
   */
  public static LayoutPanel buildRightAlignedBar(Button[] buttons) {
    ButtonBarBuilder builder = new ButtonBarBuilder();
    builder.addGlue();
    builder.addGriddedButtons(buttons);
    return builder.getPanel();
  }

View Full Code Here

   * @param leftToRightButtonOrder the order in which the buttons to add
   * @return a right aligned button bar with the given buttons
   */
  public static LayoutPanel buildRightAlignedBar(Button[] buttons,
      boolean leftToRightButtonOrder) {
    ButtonBarBuilder builder = new ButtonBarBuilder();
    builder.setLeftToRightButtonOrder(leftToRightButtonOrder);
    builder.addGlue();
    builder.addGriddedButtons(buttons);
    return builder.getPanel();
  }

View Full Code Here

   * @param help the help button to add on the left side
   * @param buttons an array of buttons to add
   * @return a right aligned button bar with the given buttons
   */
  public static LayoutPanel buildHelpBar(Button help, Button[] buttons) {
    ButtonBarBuilder builder = new ButtonBarBuilder();
    builder.addGridded(help);
    builder.addRelatedGap();
    builder.addGlue();
    builder.addGriddedButtons(buttons);
    return builder.getPanel();
  }

View Full Code Here

   * @param properties the Properties button
   * @return a panel that contains the button(s)
   */
  public static LayoutPanel buildAddRemovePropertiesBar(Button add, Button remove,
      Button properties) {
    ButtonBarBuilder builder = new ButtonBarBuilder();
    builder.addGriddedGrowing(add);
    builder.addRelatedGap();
    builder.addGriddedGrowing(remove);
    builder.addRelatedGap();
    builder.addGriddedGrowing(properties);
    return builder.getPanel();
  }

View Full Code Here

   */
  public static LayoutPanel buildWizardBar(Button[] leftAlignedButtons,
      Button back, Button next, Button overlaidFinish,
      Button[] rightAlignedButtons) {


    ButtonBarBuilder builder = new ButtonBarBuilder();
    if (leftAlignedButtons != null) {
      builder.addGriddedButtons(leftAlignedButtons);
      builder.addRelatedGap();
    }
    builder.addGlue();
    builder.addGridded(back);
    builder.addGridded(next);


    // Optionally overlay the finish and next button.
    if (overlaidFinish != null) {
      builder.nextColumn(-1);
      builder.add(overlaidFinish);
      builder.nextColumn();
    }


    if (rightAlignedButtons != null) {
      builder.addRelatedGap();
      builder.addGriddedButtons(rightAlignedButtons);
    }
    return builder.getPanel();
  }

View Full Code Here

TOP

Related Classes of org.gwt.mosaic.forms.client.builder.ButtonBarBuilder

org.gwt.mosaic.forms.client.factories.ButtonBarFactory

org.gwt.mosaic.forms.client.layout.FormLayout

org.gwt.mosaic.ui.client.layout.LayoutPanel

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.