com.sencha.gxt.widget.core.client

Class ContentPanel

java.lang.Object

Widget

com.sencha.gxt.widget.core.client.Component

com.sencha.gxt.widget.core.client.container.Container

com.sencha.gxt.widget.core.client.container.ResizeContainer

com.sencha.gxt.widget.core.client.container.SimpleContainer

com.sencha.gxt.widget.core.client.ContentPanel

All Implemented Interfaces:

HasGestureRecognizers, Collapsible, HasLayout, AddEvent.HasAddHandlers, BeforeAddEvent.HasBeforeAddHandlers, BeforeCollapseEvent.HasBeforeCollapseHandlers, BeforeExpandEvent.HasBeforeExpandHandlers, BeforeHideEvent.HasBeforeHideHandlers, BeforeRemoveEvent.HasBeforeRemoveHandlers, BeforeShowContextMenuEvent.HasBeforeShowContextMenuHandler, BeforeShowEvent.HasBeforeShowHandlers, BlurEvent.HasBlurHandlers, CollapseEvent.HasCollapseHandlers, ContainerHandler.HasContainerHandlers, DisableEvent.HasDisableHandlers, EnableEvent.HasEnableHandlers, ExpandEvent.HasExpandHandlers, FocusEvent.HasFocusHandlers, HideEvent.HasHideHandlers, MoveEvent.HasMoveHandlers, RemoveEvent.HasRemoveHandlers, ShowContextMenuEvent.HasShowContextMenuHandler, ShowEvent.HasShowHandlers, HasFocusSupport, HasItemId

Direct Known Subclasses:

FramedPanel, Window

public class ContentPanel
extends SimpleContainer
implements BeforeExpandEvent.HasBeforeExpandHandlers, ExpandEvent.HasExpandHandlers, BeforeCollapseEvent.HasBeforeCollapseHandlers, CollapseEvent.HasCollapseHandlers, Collapsible

ContentPanel is a component container that has specific functionality and structural components that make it the perfect building block for application-oriented user interfaces. A content panel contains separate header, footer and body sections. The header may contain an icon, text and a tool area that can be wired up to provide customized behavior. The footer contains buttons added using addButton(Widget). The body contains a single widget, added using SimpleContainer.add(Widget). The widget is resized to match the size of the container. A content panel provides built-in expandable and collapsible behavior. Code snippet:

 public void onModuleLoad() {
   ContentPanel cp = new ContentPanel();
   cp.setHeading("Content Panel");
   cp.setPixelSize(250, 140);
   cp.setPosition(10, 10);
   cp.setCollapsible(true);
   cp.addTool(new ToolButton(ToolButton.GEAR));
   cp.addTool(new ToolButton(ToolButton.CLOSE));
   cp.setWidget(new HTML("This is an HTML Widget in a ContentPanel."));
   cp.addButton(new TextButton("Ok"));
   RootPanel.get().add(cp);
 }
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ContentPanel.ContentPanelAppearance The appearance of a content panel.
static interface	ContentPanel.ContentPanelMessages Provides access to content panel messages.
protected class	ContentPanel.DefaultContentPanelMessages
static interface	ContentPanel.PanelHeaderAppearance Provides support for deferred binding for the panel header appearance.

Field Summary

Fields

Modifier and Type	Field and Description
protected ButtonBar	buttonBar
protected Header	header
protected boolean	secondPassRequired

Fields inherited from class com.sencha.gxt.widget.core.client.container.SimpleContainer

resize, widget

Fields inherited from class com.sencha.gxt.widget.core.client.container.ResizeContainer

forceLayoutCommand, forceLayoutOnResize, hadLayoutRunning, layoutCommand, layoutRequiredThisEventLoop, layoutRunning

Fields inherited from class com.sencha.gxt.widget.core.client.Component

adjustSize, allowTextSelection, cacheSizes, disableContextMenu, disabled, disabledStyle, ensureVisibilityOnSizing, height, hidden, lastSize, layer, left, mask, maskMessage, monitorWindowResize, pageX, pageY, resizeHandler, shim, tabIndex, toolTip, toolTipConfig, top, width, windowResizeDelay, windowResizeTask

Constructor Summary

Constructors

Constructor and Description
ContentPanel() Creates a content panel with default appearance.
ContentPanel(ContentPanel.ContentPanelAppearance appearance) Creates a content panel with the specified appearance.

Method Summary

Modifier and Type	Method and Description
HandlerRegistration	addBeforeCollapseHandler(BeforeCollapseEvent.BeforeCollapseHandler handler) Adds a BeforeCollapseEvent.BeforeCollapseHandler handler for BeforeCollapseEvent events.
HandlerRegistration	addBeforeExpandHandler(BeforeExpandEvent.BeforeExpandHandler handler) Adds a BeforeExpandEvent.BeforeExpandHandler handler for BeforeExpandEvent events.
void	addButton(Widget widget) Adds a widget the the button bar.
HandlerRegistration	addCollapseHandler(CollapseEvent.CollapseHandler handler) Adds a CollapseEvent.CollapseHandler handler for CollapseEvent events.
HandlerRegistration	addExpandHandler(ExpandEvent.ExpandHandler handler) Adds a ExpandEvent.ExpandHandler handler for ExpandEvent events.
void	addTool(Widget tool) Adds a Tool to Header
protected Size	adjustBodySize()
protected void	afterCollapse()
protected void	afterExpand()
void	collapse() Collapses the widget.
protected void	doAttachChildren()
protected void	doDetachChildren()
protected void	doLayout()
protected void	doLayoutButtonBar()
void	expand() Expands the widget.
void	forceLayout() Forces a class that implements HasLayout to lay out its child widgets.
int	getAnimationDuration() Gets the duration for the expand/collapse animations
ContentPanel.ContentPanelAppearance	getAppearance() Gets a reference to the appearance this object was instantiated with
XElement	getBody() Returns the panel's body element.
BoxLayoutContainer.BoxLayoutPack	getButtonAlign() Returns the panel's button alignment.
ButtonBar	getButtonBar() Returns the content panel button bar.
protected XElement	getContainerTarget()
protected Size	getFrameSize()
Header	getHeader() Returns the content panel header.
SafeHtml	getHeading() Returns the heading html.
ContentPanel.ContentPanelMessages	getMessages() Returns the content panel messages.
int	getMinButtonWidth() Returns the minimum button width.
protected void	initTools()
boolean	isAnimCollapse() Returns true if animated collapsing is enabled.
boolean	isCollapsed() Returns true if the panel is collapsed.
boolean	isCollapsible() Returns true if the panel is collapsible.
boolean	isExpanded() Returns true if the widget is expanded.
boolean	isHideCollapseTool() Returns true if the collapse tool is hidden.
boolean	isTitleCollapse() Returns true if title collapsing has been enabled.
protected boolean	layoutBars()
protected void	onAfterFirstAttach() Called immediately after the first time the widget becomes attached to the browser's document only the first time.
void	onBrowserEvent(Event event)
protected void	onClick(Event ce)
protected void	onCollapse()
protected void	onDisable()
protected void	onEnable()
protected void	onExpand()
protected void	onResize(int width, int height) Called after the widget is resized, this method is empty by default but can be implemented by any subclass that needs to perform custom logic after a resize occurs.
void	setAnimationDuration(int animationDuration) Sets the duration for the expand/collapse animations.
void	setAnimCollapse(boolean animCollapse) Sets whether expand and collapse is animating (defaults to true).
void	setBodyBorder(boolean border) Displays or hides the body border.
void	setBodyStyle(String style) Sets multiple style properties on the body element.
void	setBodyStyleName(String style) Adds a style class name to the body element.
void	setButtonAlign(BoxLayoutContainer.BoxLayoutPack buttonAlign) Sets the button alignment of any buttons added to this panel (defaults to RIGHT, pre-render).
void	setCollapsible(boolean collapsible) True to make the panel collapsible and have the expand/collapse toggle button automatically rendered into the header tool button area (defaults to false, pre-render).
void	setExpanded(boolean expanded) Sets the panel's expand state.
void	setHeaderVisible(boolean visible) Shows or hides the content panel header.
void	setHeading(SafeHtml html) Sets the heading html.
void	setHideCollapseTool(boolean hideCollapseTool) Sets whether the collapse tool should be displayed (when setCollapsible(boolean) = true) (defaults to false, pre-render).
void	setMessages(ContentPanel.ContentPanelMessages messages) Sets the content panel messages.
void	setMinButtonWidth(int width) Sets the minimum button width.
void	setTitleCollapse(boolean titleCollapse) True to allow expanding and collapsing the panel (when setCollapsible(boolean) = true) by clicking anywhere in the header bar, false to allow it only by clicking to tool button (defaults to false).

Methods inherited from class com.sencha.gxt.widget.core.client.container.SimpleContainer

add, add, getWidget, isResize, onRemove, setElement, setResize, setWidget, setWidget

Methods inherited from class com.sencha.gxt.widget.core.client.container.ResizeContainer

applyLayout, applyLayout, forceLayoutOnChildren, forceLayoutOnChildren, getLeftRightMargins, getParentLayoutWidget, getSideMargins, getTopBottomMargins, isLayoutRunning, isOrWasLayoutRunning, isWidgetVisible, onBeforeDoLayout, onLoad, onResize

Methods inherited from class com.sencha.gxt.widget.core.client.container.Container

addAddHandler, addBeforeAddHandler, addBeforeRemoveHandler, addContainerHandler, addRemoveHandler, adjustIndex, adopt, checkIndexBoundsForInsertion, clear, disable, doPhysicalAttach, doPhysicalDetach, enable, ensureGroupingHandlerRegistration, findWidget, getChildren, getItemByItemId, getWidget, getWidgetCount, getWidgetIndex, getWidgetIndex, insert, iterator, onInsert, onWidgetHide, onWidgetShow, orphan, remove, remove, remove

Methods inherited from class com.sencha.gxt.widget.core.client.Component

addBeforeHideHandler, addBeforeShowContextMenuHandler, addBeforeShowHandler, addBlurHandler, addDisableHandler, addEnableHandler, addFocusHandler, addGestureRecognizer, addHideHandler, addMoveHandler, addResizeHandler, addShowContextMenuHandler, addShowHandler, addStyleDependentName, addStyleOnOver, adjustPosition, adjustSize, applyState, assertAfterRender, assertPreRender, blur, clearSizeCache, disableContextMenu, disableEvents, enableEvents, fireCancellableEvent, fireEvent, focus, getData, getElement, getFocusEl, getFocusSupport, getGestureRecognizer, getGestureRecognizerCount, getHideMode, getId, getItemId, getOffsetHeight, getOffsetWidth, getPositionEl, getShadow, getShadowPosition, getStateId, getTabIndex, getToolTip, hide, hideShadow, hideToolTip, isAllowTextSelection, isAutoHeight, isAutoWidth, isDeferHeight, isEnabled, isMonitorWindowResize, isRendered, isStateful, isVisible, isVisible, mask, mask, notifyHide, notifyShow, onAttach, onBlur, onDetach, onFocus, onHide, onHideContextMenu, onPosition, onRightClick, onShow, onShowContextMenu, onTouch, onUnload, onWindowResize, removeStyleDependentName, removeStyleOnOver, removeToolTip, setAllowTextSelection, setBorders, setBounds, setBounds, setContextMenu, setData, setDeferHeight, setEnabled, setHeight, setHeight, setHideMode, setId, setItemId, setMonitorWindowResize, setPagePosition, setPixelSize, setPosition, setShadow, setShadowPosition, setSize, setStateful, setStateId, setStyleDependentName, setTabIndex, setToolTip, setToolTipConfig, setVisible, setWidth, setWidth, show, sync, syncSize, unmask

Methods inherited from class java.lang.Object

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

Field Detail

header

protected Header header

buttonBar

protected ButtonBar buttonBar

secondPassRequired

protected boolean secondPassRequired

Constructor Detail

ContentPanel

public ContentPanel()

Creates a content panel with default appearance.

ContentPanel

public ContentPanel(ContentPanel.ContentPanelAppearance appearance)

Creates a content panel with the specified appearance.

Parameters:

appearance - the appearance of the content panel.

Method Detail

addBeforeCollapseHandler

public HandlerRegistration addBeforeCollapseHandler(BeforeCollapseEvent.BeforeCollapseHandler handler)

Description copied from interface: BeforeCollapseEvent.HasBeforeCollapseHandlers

Adds a BeforeCollapseEvent.BeforeCollapseHandler handler for BeforeCollapseEvent events.

Specified by:

addBeforeCollapseHandler in interface BeforeCollapseEvent.HasBeforeCollapseHandlers

Parameters:

handler - the handler

Returns:

the registration for the event

addBeforeExpandHandler

public HandlerRegistration addBeforeExpandHandler(BeforeExpandEvent.BeforeExpandHandler handler)

Description copied from interface: BeforeExpandEvent.HasBeforeExpandHandlers

Adds a BeforeExpandEvent.BeforeExpandHandler handler for BeforeExpandEvent events.

Specified by:

addBeforeExpandHandler in interface BeforeExpandEvent.HasBeforeExpandHandlers

Parameters:

handler - the handler

Returns:

the registration for the event

addButton

public void addButton(Widget widget)

Adds a widget the the button bar.

Parameters:

widget - the widget to add

addCollapseHandler

public HandlerRegistration addCollapseHandler(CollapseEvent.CollapseHandler handler)

Description copied from interface: CollapseEvent.HasCollapseHandlers

Adds a CollapseEvent.CollapseHandler handler for CollapseEvent events.

Specified by:

addCollapseHandler in interface CollapseEvent.HasCollapseHandlers

Parameters:

handler - the handler

Returns:

the registration for the event

addExpandHandler

public HandlerRegistration addExpandHandler(ExpandEvent.ExpandHandler handler)

Description copied from interface: ExpandEvent.HasExpandHandlers

Adds a ExpandEvent.ExpandHandler handler for ExpandEvent events.

Specified by:

addExpandHandler in interface ExpandEvent.HasExpandHandlers

Parameters:

handler - the handler

Returns:

the registration for the event

addTool

public void addTool(Widget tool)

Adds a Tool to Header

Parameters:

tool - the tool to add

collapse

public void collapse()

Description copied from interface: Collapsible

Collapses the widget.

Specified by:

collapse in interface Collapsible

expand

public void expand()

Description copied from interface: Collapsible

Expands the widget.

Specified by:

expand in interface Collapsible

forceLayout

public void forceLayout()

Description copied from interface: HasLayout

Forces a class that implements HasLayout to lay out its child widgets.

Specified by:

forceLayout in interface HasLayout

Overrides:

forceLayout in class ResizeContainer

getAnimationDuration

public int getAnimationDuration()

Gets the duration for the expand/collapse animations

Returns:

the duration for the expand/collapse animations in milliseconds.

setAnimationDuration

public void setAnimationDuration(int animationDuration)

Sets the duration for the expand/collapse animations.

Parameters:

animationDuration - the duration of the expand/collapse animations in milliseconds

getAppearance

public ContentPanel.ContentPanelAppearance getAppearance()

Gets a reference to the appearance this object was instantiated with

Returns:

the appearance impl used by this component

getBody

public XElement getBody()

Returns the panel's body element.

Returns:

the body

getButtonAlign

public BoxLayoutContainer.BoxLayoutPack getButtonAlign()

Returns the panel's button alignment.

Returns:

the button alignment

setButtonAlign

public void setButtonAlign(BoxLayoutContainer.BoxLayoutPack buttonAlign)

Sets the button alignment of any buttons added to this panel (defaults to RIGHT, pre-render).

Parameters:

buttonAlign - the button alignment

getButtonBar

public ButtonBar getButtonBar()

Returns the content panel button bar. In the default implementation, the button bar is displayed in the content panel's footer.

Returns:

the button bar

getMessages

public ContentPanel.ContentPanelMessages getMessages()

Returns the content panel messages.

Returns:

the content panel messages

setMessages

public void setMessages(ContentPanel.ContentPanelMessages messages)

Sets the content panel messages.

Parameters:

messages - the messages

getMinButtonWidth

public int getMinButtonWidth()

Returns the minimum button width.

Returns:

the minimum button width

setMinButtonWidth

public void setMinButtonWidth(int width)

Sets the minimum button width.

Parameters:

width - the button width

isAnimCollapse

public boolean isAnimCollapse()

Returns true if animated collapsing is enabled.

Returns:

true if animating

setAnimCollapse

public void setAnimCollapse(boolean animCollapse)

Sets whether expand and collapse is animating (defaults to true).

Parameters:

animCollapse - true to enable animations

isCollapsed

public boolean isCollapsed()

Returns true if the panel is collapsed.

Returns:

the collapsed state

isCollapsible

public boolean isCollapsible()

Returns true if the panel is collapsible.

Returns:

the collapsible state

setCollapsible

public void setCollapsible(boolean collapsible)

True to make the panel collapsible and have the expand/collapse toggle button automatically rendered into the header tool button area (defaults to false, pre-render).

Parameters:

collapsible - the collapsible state

isExpanded

public boolean isExpanded()

Description copied from interface: Collapsible

Returns true if the widget is expanded.

Specified by:

isExpanded in interface Collapsible

Returns:

true for expanded

setExpanded

public void setExpanded(boolean expanded)

Sets the panel's expand state.

Parameters:

expanded - true true to expand

isHideCollapseTool

public boolean isHideCollapseTool()

Returns true if the collapse tool is hidden.

Returns:

the hide collapse tool state

setHideCollapseTool

public void setHideCollapseTool(boolean hideCollapseTool)

Sets whether the collapse tool should be displayed (when setCollapsible(boolean) = true) (defaults to false, pre-render).

Parameters:

hideCollapseTool - true if the tool is hidden

isTitleCollapse

public boolean isTitleCollapse()

Returns true if title collapsing has been enabled.

Returns:

true for title collapse

setTitleCollapse

public void setTitleCollapse(boolean titleCollapse)

True to allow expanding and collapsing the panel (when setCollapsible(boolean) = true) by clicking anywhere in the header bar, false to allow it only by clicking to tool button (defaults to false).

Parameters:

titleCollapse - the titleCollapse to set

onBrowserEvent

public void onBrowserEvent(Event event)

Overrides:

onBrowserEvent in class Component

setBodyBorder

public void setBodyBorder(boolean border)

Displays or hides the body border.

Parameters:

border - true to display the border

setBodyStyle

public void setBodyStyle(String style)

Sets multiple style properties on the body element. Style attribute names must be in lower camel case, e.g. "backgroundColor:white; color:red;"

Parameters:

style - the style(s) to set

setBodyStyleName

public void setBodyStyleName(String style)

Adds a style class name to the body element.

Parameters:

style - the style class name

getHeader

public Header getHeader()

Returns the content panel header.

Returns:

the header

setHeaderVisible

public void setHeaderVisible(boolean visible)

Shows or hides the content panel header.

Parameters:

visible - true to show the header.

getHeading

public SafeHtml getHeading()

Returns the heading html.

Returns:

the heading html

setHeading

public void setHeading(SafeHtml html)

Sets the heading html.

Parameters:

html - the heading html

adjustBodySize

protected Size adjustBodySize()

afterCollapse

protected void afterCollapse()

afterExpand

protected void afterExpand()

doAttachChildren

protected void doAttachChildren()

Overrides:

doAttachChildren in class Container

doDetachChildren

protected void doDetachChildren()

Overrides:

doDetachChildren in class Container

doLayout

protected void doLayout()

Overrides:

doLayout in class SimpleContainer

doLayoutButtonBar

protected void doLayoutButtonBar()

getContainerTarget

protected XElement getContainerTarget()

Overrides:

getContainerTarget in class Container

getFrameSize

protected Size getFrameSize()

initTools

protected void initTools()

layoutBars

protected boolean layoutBars()

onAfterFirstAttach

protected void onAfterFirstAttach()

Description copied from class: Component

Called immediately after the first time the widget becomes attached to the browser's document only the first time.

Overrides:

onAfterFirstAttach in class Component

onClick

protected void onClick(Event ce)

onCollapse

protected void onCollapse()

onDisable

protected void onDisable()

Overrides:

onDisable in class Component

onEnable

protected void onEnable()

Overrides:

onEnable in class Component

onExpand

protected void onExpand()

onResize

protected void onResize(int width,
                        int height)

Description copied from class: Component

Called after the widget is resized, this method is empty by default but can be implemented by any subclass that needs to perform custom logic after a resize occurs.

Overrides:

onResize in class ResizeContainer

Parameters:

width - the width

height - the height