com.extjs.gxt.ui.client.widget.layout.BoxLayout Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of gxt Show documentation
Rich Internet Application Framework for GWT
There is a newer version: 2.3.1-gwt22
/*
 * Sencha GXT 2.3.0 - Sencha for GWT
 * Copyright(c) 2007-2013, Sencha, Inc.
 * [email protected]
 * 
 * http://www.sencha.com/products/gxt/license/
 */
 package com.extjs.gxt.ui.client.widget.layout;

import com.extjs.gxt.ui.client.core.El;
import com.extjs.gxt.ui.client.util.Padding;
import com.extjs.gxt.ui.client.widget.Container;
import com.extjs.gxt.ui.client.widget.Layout;
import com.google.gwt.user.client.DOM;
import com.google.gwt.user.client.Element;

/**
 * Base class for box layouts.
 * 
 * 
 * Pack config:
 * 

 * START - Children are packed together at top side of container.
 * CENTER - Children are packed together at mid-height of container.
 * Children are packed together at bottom side of container.
 * 
 */
public abstract class BoxLayout extends Layout {

  protected El innerCt;

  private int scrollOffset = 0;
  private String innerCls = "x-box-inner";
  private BoxLayoutPack pack;
  private Padding padding = new Padding(0);
  private boolean adjustForFlexRemainder;

  /**
   * BoxLayoutPack enumeration.
   */
  public enum BoxLayoutPack {
    /**
     * Children are packed together at top side of container.
     */
    START,
    /**
     * Children are packed together at mid-height of container.
     */
    CENTER,
    /**
     * Children are packed together at bottom side of container.
     */
    END
  }

  public BoxLayout() {
    monitorResize = true;
    componentStyleName = "x-box-item";
    targetStyleName = "x-box-layout-ct";
  }

  /**
   * Returns the padding.
   * 
   * @return the padding
   */
  public Padding getPadding() {
    return padding;
  }

  /**
   * Returns the layouts pack value.
   * 
   * @return the pack value
   */
  public BoxLayoutPack getPack() {
    return pack;
  }

  /**
   * Returns the scroll offset.
   * 
   * @return the scroll offset
   */
  public int getScrollOffset() {
    return scrollOffset;
  }

  /**
   * Returns true if the remaining space after flex calculation is applied to
   * the last component being flexed.
   * 
   * @return true if adjusting for flex remainder
   */
  public boolean isAdjustForFlexRemainder() {
    return adjustForFlexRemainder;
  }

  /**
   * Set to true if the remaining space after flex calculation should be applied
   * to the last component being flexed.
   * 
   * @param adjustForFlexRemainder true to add the space
   */
  public void setAdjustForFlexRemainder(boolean adjustForFlexRemainder) {
    this.adjustForFlexRemainder = adjustForFlexRemainder;
  }

  /**
   * Sets how the child items of the container are packed together.
   * 
   * @param pack the pack value
   */
  public void setPack(BoxLayoutPack pack) {
    this.pack = pack;
  }

  /**
   * Sets the padding to be applied to all child items managed by this
   * container's layout (defaults to 0).
   * 
   * @param padding the padding
   */
  public void setPadding(Padding padding) {
    this.padding = padding;
  }

  /**
   * Sets the scroll offset (defaults to 0).
   * 
   * @param scrollOffset the scroll offset
   */
  public void setScrollOffset(int scrollOffset) {
    this.scrollOffset = scrollOffset;
  }

  @Override
  protected void onLayout(Container container, El target) {

    if (innerCt == null) {
      // the innerCt prevents wrapping and shuffling while
      // the container is resizing
      Element div = DOM.createDiv();
      div.setClassName(innerCls);
      innerCt = target.appendChild(div);
    }
    renderAll(container, innerCt);
  }

}