com.google.gwt.user.client.ui
Class CellPanel

java.lang.Object
  com.google.gwt.user.client.ui.UIObject
      com.google.gwt.user.client.ui.Widget
          com.google.gwt.user.client.ui.Panel
              com.google.gwt.user.client.ui.ComplexPanel
                  com.google.gwt.user.client.ui.CellPanel

All Implemented Interfaces:

HasAttachHandlers, HasHandlers, EventListener, HasVisibility, HasWidgets, HasWidgets.ForIsWidget, IndexedPanel, IndexedPanel.ForIsWidget, IsWidget, java.lang.Iterable<Widget>

Direct Known Subclasses:

DockPanel, HorizontalPanel, VerticalPanel

public abstract class CellPanel
extends ComplexPanel

A panel whose child widgets are contained within the cells of a table. Each cell's size may be set independently. Each child widget can take up a subset of its cell and can be aligned within it.

Note: This class is not related to the Cell based data presentation widgets such as CellList and CellTable.

Use in UiBinder Templates

When working with CellPanel subclasses in UiBinder templates, wrap child widgets in <g:cell> elements. (Note the lower case "c", meant to signal that the cell is not a runtime object, and so cannot have a ui:field attribute.) Cell elements can have attributes setting their height, width and alignment.

<g:cell> attributes

horizontalAlignment

Interpreted as a static member of HasHorizontalAlignment.HorizontalAlignmentConstant and used as the align argument to setCellHorizontalAlignment(com.google.gwt.user.client.ui.Widget, com.google.gwt.user.client.ui.HasHorizontalAlignment.HorizontalAlignmentConstant)

verticalAlignment

Interpreted as a static member of HasVerticalAlignment.VerticalAlignmentConstant and used as the align argument to setCellVerticalAlignment(com.google.gwt.user.client.ui.Widget, com.google.gwt.user.client.ui.HasVerticalAlignment.VerticalAlignmentConstant)

width

Used as the width argument to setCellWidth(com.google.gwt.user.client.ui.Widget, java.lang.String)

height

Used as the height argument to setCellHeight(com.google.gwt.user.client.ui.Widget, java.lang.String)

For example:

 <g:HorizontalPanel>
   <g:cell width='5em' horizontalAlignment='ALIGN_RIGHT'>
     <g:Label ui:field='leftSide' />
   </g:cell>
   <g:cell width='15em' horizontalAlignment='ALIGN_LEFT'>
     <g:Label ui:field='rightSide' />
   </g:cell>
 </g:HorizontalPanel>
 

CellPanel

public CellPanel()

getSpacing

public int getSpacing()

Gets the amount of spacing between this panel's cells.

Returns:

the inter-cell spacing, in pixels

setBorderWidth

public void setBorderWidth(int width)

Sets the width of the border to be applied to all cells in this panel. This is particularly useful when debugging layouts, in that it allows you to see explicitly the cells that contain this panel's children.

Parameters:

width - the width of the panel's cell borders, in pixels

setCellHeight

public void setCellHeight(Widget w,
                          java.lang.String height)

Sets the height of the cell associated with the given widget, related to the panel as a whole.

Parameters:

w - the widget whose cell height is to be set

height - the cell's height, in CSS units

setCellHeight

public void setCellHeight(IsWidget w,
                          java.lang.String height)

Overloaded version for IsWidget.

See Also:

setCellHeight(Widget,String)

setCellHorizontalAlignment

public void setCellHorizontalAlignment(Widget w,
                                       HasHorizontalAlignment.HorizontalAlignmentConstant align)

Sets the horizontal alignment of the given widget within its cell.

Parameters:

w - the widget whose horizontal alignment is to be set

align - the widget's horizontal alignment, as defined in HasHorizontalAlignment.

setCellHorizontalAlignment

public void setCellHorizontalAlignment(IsWidget w,
                                       HasHorizontalAlignment.HorizontalAlignmentConstant align)

Overloaded version for IsWidget.

See Also:

setCellHorizontalAlignment(Widget,HasHorizontalAlignment.HorizontalAlignmentConstant)

setCellVerticalAlignment

public void setCellVerticalAlignment(Widget w,
                                     HasVerticalAlignment.VerticalAlignmentConstant align)

Sets the vertical alignment of the given widget within its cell.

Parameters:

w - the widget whose vertical alignment is to be set

align - the widget's vertical alignment, as defined in HasVerticalAlignment.

setCellVerticalAlignment

public void setCellVerticalAlignment(IsWidget w,
                                     HasVerticalAlignment.VerticalAlignmentConstant align)

Overloaded version for IsWidget.

See Also:

setCellVerticalAlignment(Widget,HasVerticalAlignment.VerticalAlignmentConstant)

setCellWidth

public void setCellWidth(Widget w,
                         java.lang.String width)

Sets the width of the cell associated with the given widget, related to the panel as a whole.

Parameters:

w - the widget whose cell width is to be set

width - the cell's width, in CSS units

setCellWidth

public void setCellWidth(IsWidget w,
                         java.lang.String width)

Overloaded version for IsWidget.

See Also:

setCellWidth(Widget,String)

setSpacing

public void setSpacing(int spacing)

Sets the amount of spacing between this panel's cells.

Parameters:

spacing - the inter-cell spacing, in pixels

getBody

protected Element getBody()

getTable

protected Element getTable()

setCellHorizontalAlignment

protected void setCellHorizontalAlignment(Element td,
                                          HasHorizontalAlignment.HorizontalAlignmentConstant align)

setCellHorizontalAlignment

@Deprecated
protected void setCellHorizontalAlignment(Element td,
                                                     HasHorizontalAlignment.HorizontalAlignmentConstant align)

Deprecated. Call and override #setCellHorizontalAlignment(Element, HorizontalAlignmentConstant) instead.

setCellVerticalAlignment

protected void setCellVerticalAlignment(Element td,
                                        HasVerticalAlignment.VerticalAlignmentConstant align)

setCellVerticalAlignment

@Deprecated
protected void setCellVerticalAlignment(Element td,
                                                   HasVerticalAlignment.VerticalAlignmentConstant align)

Deprecated. Call and override #setCellVerticalAlignment(Element, VerticalAlignmentConstant) instead.

getWidgetTd

Element getWidgetTd(Widget w)