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>
 

Nested Class Summary

Nested classes/interfaces inherited from class com.google.gwt.user.client.ui.UIObject

UIObject.DebugIdImpl, UIObject.DebugIdImplEnabled

Nested classes/interfaces inherited from interface com.google.gwt.user.client.ui.IndexedPanel

IndexedPanel.ForIsWidget

Nested classes/interfaces inherited from interface com.google.gwt.user.client.ui.HasWidgets

HasWidgets.ForIsWidget

Field Summary

Fields inherited from class com.google.gwt.user.client.ui.Widget

eventsToSink

Fields inherited from class com.google.gwt.user.client.ui.UIObject

DEBUG_ID_PREFIX, MISSING_ELEMENT_ERROR, SETELEMENT_TWICE_ERROR

Constructor Summary

Constructors

Constructor and Description
CellPanel()

Method Summary

Modifier and Type	Method and Description
protected Element	getBody()
int	getSpacing() Gets the amount of spacing between this panel's cells.
protected Element	getTable()
(package private) Element	getWidgetTd(Widget w)
void	setBorderWidth(int width) Sets the width of the border to be applied to all cells in this panel.
void	setCellHeight(IsWidget w, java.lang.String height) Overloaded version for IsWidget.
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.
protected void	setCellHorizontalAlignment(Element td, HasHorizontalAlignment.HorizontalAlignmentConstant align)
protected void	setCellHorizontalAlignment(Element td, HasHorizontalAlignment.HorizontalAlignmentConstant align) Deprecated. Call and override #setCellHorizontalAlignment(Element, HorizontalAlignmentConstant) instead.
void	setCellHorizontalAlignment(IsWidget w, HasHorizontalAlignment.HorizontalAlignmentConstant align) Overloaded version for IsWidget.
void	setCellHorizontalAlignment(Widget w, HasHorizontalAlignment.HorizontalAlignmentConstant align) Sets the horizontal alignment of the given widget within its cell.
protected void	setCellVerticalAlignment(Element td, HasVerticalAlignment.VerticalAlignmentConstant align)
protected void	setCellVerticalAlignment(Element td, HasVerticalAlignment.VerticalAlignmentConstant align) Deprecated. Call and override #setCellVerticalAlignment(Element, VerticalAlignmentConstant) instead.
void	setCellVerticalAlignment(IsWidget w, HasVerticalAlignment.VerticalAlignmentConstant align) Overloaded version for IsWidget.
void	setCellVerticalAlignment(Widget w, HasVerticalAlignment.VerticalAlignmentConstant align) Sets the vertical alignment of the given widget within its cell.
void	setCellWidth(IsWidget w, java.lang.String width) Overloaded version for IsWidget.
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.
void	setSpacing(int spacing) Sets the amount of spacing between this panel's cells.

Methods inherited from class com.google.gwt.user.client.ui.ComplexPanel

add, add, adjustIndex, checkIndexBoundsForAccess, checkIndexBoundsForInsertion, doLogicalClear, getChildren, getWidget, getWidgetCount, getWidgetIndex, getWidgetIndex, insert, insert, iterator, remove, remove

Methods inherited from class com.google.gwt.user.client.ui.Panel

add, add, adopt, clear, doAttachChildren, doDetachChildren, orphan, remove

Methods inherited from class com.google.gwt.user.client.ui.Widget

addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, ensureHandlers, fireEvent, getHandlerCount, getHandlerManager, getLayoutData, getParent, isAttached, isOrWasAttached, onAttach, onBrowserEvent, onDetach, onLoad, onUnload, removeFromParent, replaceElement, setLayoutData, setParent, sinkEvents, unsinkEvents

Methods inherited from class com.google.gwt.user.client.ui.UIObject

addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getElement, getOffsetHeight, getOffsetWidth, getStyleElement, getStyleName, getStyleName, getStylePrimaryName, getStylePrimaryName, getTitle, isVisible, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, resolvePotentialElement, setElement, setElement, setHeight, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setTitle, setVisible, setVisible, setWidth, sinkBitlessEvent, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

CellPanel

public CellPanel()

Method Detail

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)