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.HorizontalAlignmentConstantand used as thealignargument tosetCellHorizontalAlignment(com.google.gwt.user.client.ui.Widget, com.google.gwt.user.client.ui.HasHorizontalAlignment.HorizontalAlignmentConstant) - verticalAlignment
- Interpreted as a static member of
HasVerticalAlignment.VerticalAlignmentConstantand used as thealignargument tosetCellVerticalAlignment(com.google.gwt.user.client.ui.Widget, com.google.gwt.user.client.ui.HasVerticalAlignment.VerticalAlignmentConstant) - width
- Used as the
widthargument tosetCellWidth(com.google.gwt.user.client.ui.Widget, java.lang.String) - height
- Used as the
heightargument 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.DebugIdImplEnabledNested classes/interfaces inherited from interface com.google.gwt.user.client.ui.HasWidgets
HasWidgets.ForIsWidgetNested 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
eventsToSinkFields inherited from class com.google.gwt.user.client.ui.UIObject
DEBUG_ID_PREFIX, MISSING_ELEMENT_ERROR, SETELEMENT_TWICE_ERROR -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected ElementgetBody()intGets the amount of spacing between this panel's cells.protected ElementgetTable()(package private) ElementvoidsetBorderWidth(int width) Sets the width of the border to be applied to all cells in this panel.voidsetCellHeight(IsWidget w, String height) Overloaded version for IsWidget.voidsetCellHeight(Widget w, String height) Sets the height of the cell associated with the given widget, related to the panel as a whole.protected voidprotected voidDeprecated.voidOverloaded version for IsWidget.voidSets the horizontal alignment of the given widget within its cell.protected voidprotected voidDeprecated.Call and overridesetCellVerticalAlignment(Element, VerticalAlignmentConstant)instead.voidOverloaded version for IsWidget.voidSets the vertical alignment of the given widget within its cell.voidsetCellWidth(IsWidget w, String width) Overloaded version for IsWidget.voidsetCellWidth(Widget w, String width) Sets the width of the cell associated with the given widget, related to the panel as a whole.voidsetSpacing(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, removeMethods inherited from class com.google.gwt.user.client.ui.Panel
add, add, adopt, clear, doAttachChildren, doDetachChildren, orphan, removeMethods 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, unsinkEventsMethods 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, toStringMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitMethods 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. -
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. -
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.