Package 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
,Iterable<Widget>
- Direct Known Subclasses:
DockPanel
,HorizontalPanel
,VerticalPanel
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 thealign
argument tosetCellHorizontalAlignment(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 thealign
argument tosetCellVerticalAlignment(com.google.gwt.user.client.ui.Widget, com.google.gwt.user.client.ui.HasVerticalAlignment.VerticalAlignmentConstant)
- width
- Used as the
width
argument tosetCellWidth(com.google.gwt.user.client.ui.Widget, java.lang.String)
- height
- Used as the
height
argument tosetCellHeight(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.HasWidgets
HasWidgets.ForIsWidget
Nested classes/interfaces inherited from interface com.google.gwt.user.client.ui.IndexedPanel
IndexedPanel.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
-
Method Summary
Modifier and TypeMethodDescriptionprotected Element
getBody()
int
Gets the amount of spacing between this panel's cells.protected Element
getTable()
(package private) Element
void
setBorderWidth
(int width) Sets the width of the border to be applied to all cells in this panel.void
setCellHeight
(IsWidget w, String height) Overloaded version for IsWidget.void
setCellHeight
(Widget w, String height) Sets the height of the cell associated with the given widget, related to the panel as a whole.protected void
protected void
Deprecated.void
Overloaded version for IsWidget.void
Sets the horizontal alignment of the given widget within its cell.protected void
protected void
Deprecated.Call and overridesetCellVerticalAlignment(Element, VerticalAlignmentConstant)
instead.void
Overloaded version for IsWidget.void
Sets the vertical alignment of the given widget within its cell.void
setCellWidth
(IsWidget w, String width) Overloaded version for IsWidget.void
setCellWidth
(Widget w, 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 Details
-
CellPanel
public CellPanel()
-
-
Method Details
-
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
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 setheight
- the cell's height, in CSS units
-
setCellHeight
Overloaded version for IsWidget.- See Also:
-
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 setalign
- the widget's horizontal alignment, as defined inHasHorizontalAlignment
.
-
setCellHorizontalAlignment
public void setCellHorizontalAlignment(IsWidget w, HasHorizontalAlignment.HorizontalAlignmentConstant align) Overloaded version for IsWidget.- See Also:
-
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 setalign
- the widget's vertical alignment, as defined inHasVerticalAlignment
.
-
setCellVerticalAlignment
public void setCellVerticalAlignment(IsWidget w, HasVerticalAlignment.VerticalAlignmentConstant align) Overloaded version for IsWidget.- See Also:
-
setCellWidth
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 setwidth
- the cell's width, in CSS units
-
setCellWidth
Overloaded version for IsWidget.- See Also:
-
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
-
getTable
-
setCellHorizontalAlignment
protected void setCellHorizontalAlignment(Element td, HasHorizontalAlignment.HorizontalAlignmentConstant align) -
setCellHorizontalAlignment
@Deprecated protected void setCellHorizontalAlignment(Element td, HasHorizontalAlignment.HorizontalAlignmentConstant align) Deprecated.Call and overridesetCellHorizontalAlignment(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 overridesetCellVerticalAlignment(Element, VerticalAlignmentConstant)
instead. -
getWidgetTd
-
setCellHorizontalAlignment(Element, HorizontalAlignmentConstant)
instead.