org.uberfire.client.workbench.panels.impl

Class AbstractDockingWorkbenchPanelView<P extends WorkbenchPanelPresenter>

java.lang.Object

com.google.gwt.user.client.ui.UIObject

com.google.gwt.user.client.ui.Widget

com.google.gwt.user.client.ui.Composite

com.google.gwt.user.client.ui.ResizeComposite

org.uberfire.client.workbench.panels.impl.AbstractWorkbenchPanelView<P>

org.uberfire.client.workbench.panels.impl.AbstractDockingWorkbenchPanelView<P>

Type Parameters:

P - the presenter type this view binds to

All Implemented Interfaces:

com.google.gwt.event.logical.shared.HasAttachHandlers, com.google.gwt.event.shared.HasHandlers, com.google.gwt.user.client.EventListener, com.google.gwt.user.client.ui.HasVisibility, com.google.gwt.user.client.ui.IsRenderable, com.google.gwt.user.client.ui.IsWidget, com.google.gwt.user.client.ui.RequiresResize, HasPresenter<P>, UberView<P>, DockingWorkbenchPanelView<P>, WorkbenchPanelView<P>

Direct Known Subclasses:

AbstractMultiPartWorkbenchPanelView, AbstractSimpleWorkbenchPanelView

public abstract class AbstractDockingWorkbenchPanelView<P extends WorkbenchPanelPresenter>
extends AbstractWorkbenchPanelView<P>
implements DockingWorkbenchPanelView<P>

Implements the view behaviour required by all docking panel views: adding and removing child panels in the NORTH, SOUTH, EAST, and WEST compass positions.

Information for subclassers

The top-level widget of an AbstractDockingWorkbenchPanelView is always topLevelWidget, a container for child panels, even if this panel doesn't currently have any child panels. This is done so child panels can be inserted and removed without making any assumptions about the parent panel this view is located in (if any!).

This means you must always put your part view UI into the widget returned from getPartViewContainer(). The contents of this container will never be inspected or modified, but the container itself will be reparented as necessary to accommodate child panels being inserted and removed around it. Put another way, do not insert your part view UI directly into the top-level widget of this view! It will get wiped out!

This also means you must not call ResizeComposite.initWidget(Widget). That will always be done by this superclass.

Nested Class Summary

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

com.google.gwt.user.client.ui.UIObject.DebugIdImpl, com.google.gwt.user.client.ui.UIObject.DebugIdImplEnabled

Field Summary

Fields

Modifier and Type	Field and Description
protected WorkbenchDragAndDropManager	dndManager
protected BeanFactory	factory

Fields inherited from class org.uberfire.client.workbench.panels.impl.AbstractWorkbenchPanelView

layoutSelection, panelManager, presenter

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

DEBUG_ID_PREFIX

Constructor Summary

Constructors

Constructor and Description
AbstractDockingWorkbenchPanelView()

Method Summary

Modifier and Type	Method and Description
void	addPanel(PanelDefinition childPanelDef, WorkbenchPanelView<?> childPanelView, Position childPosition) Throws UnsupportedOperationException when called.
com.google.gwt.user.client.ui.Widget	getPartDropRegion() Returns the partViewContainer, which appears to be the "real" on-screen boundary of this widget.
protected ResizeFlowPanel	getPartViewContainer() Returns the panel that subclasses should put the part view UI into.
com.google.gwt.user.client.ui.Widget	getWidget() Overridden to ensure subclasses don't return the partViewContainer by mistake (this would interfere with nested docking panels).
void	maximize() Overridden to maximize the widget returned by getPartViewContainer().
boolean	removePanel(WorkbenchPanelView<?> childView) Throws UnsupportedOperationException when called.
boolean	setChildSize(WorkbenchPanelView<?> childPanel, int size) Sets the size (width for EAST or WEST children; height for NORTH and SOUTH children) allocated to the specified child by moving its splitter bar on the screen.
void	setElementId(String elementId) Overridden to attach the ID to the part container rather than the top-level widget, which may contain sub-panels and be larger and further up the DOM tree than desired.
void	unmaximize() Overridden to match maximize().

Methods inherited from class org.uberfire.client.workbench.panels.impl.AbstractWorkbenchPanelView

addOnFocusHandler, addSelectionHandler, getPresenter, toString

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

initWidget, onResize

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

claimElement, initializeClaimedElement, isAttached, onAttach, onBrowserEvent, onDetach, render, render, resolvePotentialElement, setWidget

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

addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, doAttachChildren, doDetachChildren, fireEvent, getHandlerCount, getLayoutData, getParent, isOrWasAttached, onLoad, onUnload, removeFromParent, setLayoutData, 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, setElement, setElement, setHeight, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setTitle, setVisible, setVisible, setWidth, sinkBitlessEvent

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.uberfire.client.workbench.panels.WorkbenchPanelView

addPart, changeTitle, getParts, getPresenter, removePart, selectPart, setFocus

Methods inherited from interface com.google.gwt.user.client.ui.IsWidget

asWidget

Methods inherited from interface org.uberfire.client.mvp.HasPresenter

init

Methods inherited from interface com.google.gwt.user.client.ui.RequiresResize

onResize

Field Detail

dndManager

@Inject
protected WorkbenchDragAndDropManager dndManager

factory

@Inject
protected BeanFactory factory

Constructor Detail

AbstractDockingWorkbenchPanelView

public AbstractDockingWorkbenchPanelView()

Method Detail

getWidget

public final com.google.gwt.user.client.ui.Widget getWidget()

Overridden to ensure subclasses don't return the partViewContainer by mistake (this would interfere with nested docking panels).

Overrides:

getWidget in class com.google.gwt.user.client.ui.Composite

getPartViewContainer

protected ResizeFlowPanel getPartViewContainer()

Returns the panel that subclasses should put the part view UI into.

getPartDropRegion

public com.google.gwt.user.client.ui.Widget getPartDropRegion()

Returns the partViewContainer, which appears to be the "real" on-screen boundary of this widget.

Specified by:

getPartDropRegion in interface WorkbenchPanelView<P extends WorkbenchPanelPresenter>

Overrides:

getPartDropRegion in class AbstractWorkbenchPanelView<P extends WorkbenchPanelPresenter>

Returns:

the widget whose boundaries define the region where workbench parts can be dropped into this panel. For simple panel types that do not support child panels, this will typically be the same widget returned by IsWidget.asWidget(). For fancier panels, this will typically be some child panel within the view's internal structure.

If the return value is null, parts will not be droppable on this view.

setElementId

public void setElementId(String elementId)

Overridden to attach the ID to the part container rather than the top-level widget, which may contain sub-panels and be larger and further up the DOM tree than desired.

Specified by:

setElementId in interface WorkbenchPanelView<P extends WorkbenchPanelPresenter>

Overrides:

setElementId in class AbstractWorkbenchPanelView<P extends WorkbenchPanelPresenter>

Parameters:

elementId - the element ID to set. If null, the ID value will be cleared.

addPanel

public void addPanel(PanelDefinition childPanelDef,
                     WorkbenchPanelView<?> childPanelView,
                     Position childPosition)

Description copied from class: AbstractWorkbenchPanelView

Throws UnsupportedOperationException when called. Subclasses that wish to support child panels should override this and AbstractWorkbenchPanelView.removePanel(WorkbenchPanelView).

Specified by:

addPanel in interface WorkbenchPanelView<P extends WorkbenchPanelPresenter>

Overrides:

addPanel in class AbstractWorkbenchPanelView<P extends WorkbenchPanelPresenter>

Parameters:

childPanelDef - specifies the size that should be imposed on the nested view. Must not be null. FIXME: is this sensible/correct?

childPanelView - the panel to nest inside this one. Must not be null.

childPosition - specifies which edge of this panel will be shared with the nested panel. Must not be null.

removePanel

public boolean removePanel(WorkbenchPanelView<?> childView)

Description copied from class: AbstractWorkbenchPanelView

Throws UnsupportedOperationException when called. Subclasses that wish to support child panels should override this and AbstractWorkbenchPanelView.addPanel(PanelDefinition, WorkbenchPanelView, Position).

Specified by:

removePanel in interface WorkbenchPanelView<P extends WorkbenchPanelPresenter>

Overrides:

removePanel in class AbstractWorkbenchPanelView<P extends WorkbenchPanelPresenter>

setChildSize

public boolean setChildSize(WorkbenchPanelView<?> childPanel,
                            int size)

Description copied from interface: DockingWorkbenchPanelView

Sets the size (width for EAST or WEST children; height for NORTH and SOUTH children) allocated to the specified child by moving its splitter bar on the screen. If the requested space isn't available (for instance because it is larger than the browser window, or it would make the central panel of this view smaller than its minimum size) then the largest possible amount will be given to the requested child. Similarly, if the requested size is less than the child's minimum width or height (as appropriate) then the child will be set to its minimum.

Specified by:

setChildSize in interface DockingWorkbenchPanelView<P extends WorkbenchPanelPresenter>

Parameters:

childPanel - the panel whose size to change

Returns:

true if the child was found and its size was adjusted (even if the requested amount was out of range); false if the given child was not found as a child of this panel.

maximize

public void maximize()

Overridden to maximize the widget returned by getPartViewContainer().

Specified by:

maximize in interface WorkbenchPanelView<P extends WorkbenchPanelPresenter>

Overrides:

maximize in class AbstractWorkbenchPanelView<P extends WorkbenchPanelPresenter>

unmaximize

public void unmaximize()

Overridden to match maximize().

Specified by:

unmaximize in interface WorkbenchPanelView<P extends WorkbenchPanelPresenter>

Overrides:

unmaximize in class AbstractWorkbenchPanelView<P extends WorkbenchPanelPresenter>