com.smartgwt.client.widgets

Class MultiGroupPanel

java.lang.Object

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

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

com.smartgwt.client.widgets.BaseWidget

com.smartgwt.client.widgets.Canvas

com.smartgwt.client.widgets.layout.Layout

com.smartgwt.client.widgets.MultiGroupPanel

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.IsWidget, LogicalStructure, HasClickHandlers, HasDoubleClickHandlers, HasDragMoveHandlers, HasDragRepositionMoveHandlers, HasDragRepositionStartHandlers, HasDragRepositionStopHandlers, HasDragResizeMoveHandlers, HasDragResizeStartHandlers, HasDragResizeStopHandlers, HasDragStartHandlers, HasDragStopHandlers, HasDropHandlers, HasDropMoveHandlers, HasDropOutHandlers, HasDropOverHandlers, HasFocusChangedHandlers, HasHoverHandlers, HasHoverHiddenHandlers, HasKeyDownHandlers, HasKeyPressHandlers, HasMouseDownHandlers, HasMouseMoveHandlers, HasMouseOutHandlers, HasMouseOverHandlers, HasMouseStillDownHandlers, HasMouseUpHandlers, HasMouseWheelHandlers, HasMovedHandlers, HasParentMovedHandlers, HasResizedHandlers, HasRightMouseDownHandlers, HasScrolledHandlers, HasShowContextMenuHandlers, HasVisibilityChangedHandlers, HasMembersChangedHandlers

public class MultiGroupPanel
extends Layout

A widget that allows the user to set up complex grouping arrangements by defining a group of GroupSpecifiers.

Each GroupSpecifier applies to a single property and grouping - so, for instance, in a grid with two columns, Nationhood and Country, you could group first by Nationhood with its selected groupingMode and then by Country with its selected groupingMode. Important Note: this class should not be used directly - it is exposed purely for i18n reasons.

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 inherited from class com.smartgwt.client.widgets.BaseWidget

config, configOnly, factoryCreated, factoryProperties, id, nativeObject, scClassName

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

DEBUG_ID_PREFIX

Constructor Summary

Constructors

Constructor and Description
MultiGroupPanel()
MultiGroupPanel(com.google.gwt.core.client.JavaScriptObject jsObj)

Method Summary

Modifier and Type	Method and Description
static void	changeAutoChildDefaults(java.lang.String autoChildName, Canvas defaults) Changes the defaults for Canvas AutoChildren named autoChildName.
static void	changeAutoChildDefaults(java.lang.String autoChildName, FormItem defaults) Changes the defaults for FormItem AutoChildren named autoChildName.
protected com.google.gwt.core.client.JavaScriptObject	create()
IButton	getAddLevelButton() Automatically generated IButton providing a mechanism for adding new levels to the group configuration.
java.lang.String	getAddLevelButtonTitle() The title-text to appear on the addLevelButton
IButton	getCopyLevelButton() Automatically generated IButton providing a mechanism for duplicating levels in the group configuration.
java.lang.String	getCopyLevelButtonTitle() The title-text to appear on the copyLevelButton
IButton	getDeleteLevelButton() Automatically generated IButton providing a mechanism for deleting levels from the group configuration.
java.lang.String	getDeleteLevelButtonTitle() The title-text to appear on the deleteLevelButton
java.lang.String	getFirstGroupLevelTitle() The title-text to appear in the first column for the first group-level.
GroupSpecifier[]	getGroup() Returns all configured grouping levels, as an array of GroupSpecifiers.
java.lang.String	getGroupingFieldTitle() The title-text to appear in the header of the "grouping" field.
java.lang.String	getInvalidListPrompt() This is a dynamic string - text within ${...} will be evaluated as JS code when the message is displayed.
ImgButton	getLevelDownButton() Automatically generated ImgButton providing a mechanism for moving existing group-levels down in the group configuration.
java.lang.String	getLevelDownButtonTitle() The hover-prompt for the Level Down button.
ImgButton	getLevelUpButton() Automatically generated ImgButton providing a mechanism for moving existing group-levels up in the group configuration.
java.lang.String	getLevelUpButtonTitle() The hover-prompt for the Level Up button.
com.smartgwt.logicalstructure.core.LogicalStructureObject	getLogicalStructure() Getter implementing the LogicalStructure interface, which supports Eclipse's logical structure debugging facility.
java.lang.Integer	getMaxLevels() The maximum number of levels of grouping that can be applied.
int	getNumLevels() Return the number of levels of grouping that have been configured.
ListGrid	getOptionsGrid() Automatically generated ListGrid allowing the user to configure a set of GroupSpecifiers.
static MultiGroupPanel	getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)
java.lang.String	getOtherGroupLevelTitle() The title-text to appear in the first column for all group-levels other than the first.
java.lang.String	getPropertyFieldTitle() The title-text to appear in the header of the "property" field.
void	groupChanged(GroupSpecifier... groupLevels) Fired whenever the group configuration changes.
void	setAddLevelButtonTitle(java.lang.String addLevelButtonTitle) The title-text to appear on the addLevelButton
void	setCopyLevelButtonTitle(java.lang.String copyLevelButtonTitle) The title-text to appear on the copyLevelButton
static void	setDefaultProperties(MultiGroupPanel multiGroupPanelProperties) Class level method to set the default properties of this class.
void	setDeleteLevelButtonTitle(java.lang.String deleteLevelButtonTitle) The title-text to appear on the deleteLevelButton
void	setFirstGroupLevelTitle(java.lang.String firstGroupLevelTitle) The title-text to appear in the first column for the first group-level.
void	setGroupingFieldTitle(java.lang.String groupingFieldTitle) The title-text to appear in the header of the "grouping" field.
void	setInvalidListPrompt(java.lang.String invalidListPrompt) This is a dynamic string - text within ${...} will be evaluated as JS code when the message is displayed.
void	setLevelDownButtonTitle(java.lang.String levelDownButtonTitle) The hover-prompt for the Level Down button.
void	setLevelUpButtonTitle(java.lang.String levelUpButtonTitle) The hover-prompt for the Level Up button.
com.smartgwt.logicalstructure.core.LogicalStructureObject	setLogicalStructure(com.smartgwt.logicalstructure.widgets.MultiGroupPanelLogicalStructure s) Setter implementing the LogicalStructure interface, which supports Eclipse's logical structure debugging facility.
void	setMaxLevels(java.lang.Integer maxLevels) The maximum number of levels of grouping that can be applied.
void	setOtherGroupLevelTitle(java.lang.String otherGroupLevelTitle) The title-text to appear in the first column for all group-levels other than the first.
void	setPropertyFieldTitle(java.lang.String propertyFieldTitle) The title-text to appear in the header of the "property" field.
boolean	validate() Validate that no two GroupSpecifiers group on the same property.

Methods inherited from class com.smartgwt.client.widgets.layout.Layout

addMember, addMember, addMember, addMember, addMemberPostCreate, addMemberPostCreate, addMemberPreCreate, addMemberPreCreate, addMembers, addMembers, addMembersChangedHandler, getAnimateMembers, getAnimateMemberTime, getCanDropComponents, getDefaultResizeBars, getDropComponent, getDropLine, getDropLineThickness, getDropPosition, getEditProxyConstructor, getEnforcePolicy, getHPolicy, getLayoutBottomMargin, getLayoutLeftMargin, getLayoutMargin, getLayoutRightMargin, getLayoutTopMargin, getLeaveScrollbarGap, getLocateMembersBy, getLocateMembersType, getManagePercentBreadth, getMember, getMember, getMemberDefaultBreadth, getMemberNumber, getMemberNumber, getMemberOverlap, getMembers, getMembersLength, getMembersMargin, getMinMemberSize, getOverflow, getPaddingAsLayoutMargin, getResizeBar, getResizeBarClass, getResizeBarSize, getReverseOrder, getShowDragPlaceHolder, getShowDropLines, getStackZIndex, getVertical, getVPolicy, hasMember, hideDropLine, hideMember, hideMember, layoutIsDirty, onInit_Layout, onInit, reflow, reflow, reflowNow, removeMember, removeMembers, removeMembers, reorderMember, reorderMembers, setAlign, setAlign, setAnimateMembers, setAnimateMemberTime, setCanDropComponents, setDefaultLayoutAlign, setDefaultLayoutAlign, setDefaultProperties, setDefaultResizeBars, setDropLineProperties, setDropLineThickness, setEditProxyConstructor, setEnforcePolicy, setHPolicy, setLayoutBottomMargin, setLayoutLeftMargin, setLayoutMargin, setLayoutRightMargin, setLayoutTopMargin, setLeaveScrollbarGap, setLocateMembersBy, setLocateMembersType, setLogicalStructure, setManagePercentBreadth, setMemberOverlap, setMembers, setMembersMargin, setMinMemberSize, setOverflow, setPaddingAsLayoutMargin, setPlaceHolderDefaults, setPlaceHolderProperties, setResizeBarClass, setResizeBarSize, setReverseOrder, setShowDragPlaceHolder, setShowDropLines, setStackZIndex, setVertical, setVisibleMember, setVPolicy, showMember, showMember

Methods inherited from class com.smartgwt.client.widgets.Canvas

addChild, addChild, addChild, addChild, addChild, addClickHandler, addDoubleClickHandler, addDragMoveHandler, addDragRepositionMoveHandler, addDragRepositionStartHandler, addDragRepositionStopHandler, addDragResizeMoveHandler, addDragResizeStartHandler, addDragResizeStopHandler, addDragStartHandler, addDragStopHandler, addDropHandler, addDropMoveHandler, addDropOutHandler, addDropOverHandler, addFocusChangedHandler, addHoverHandler, addHoverHiddenHandler, addKeyDownHandler, addKeyPressHandler, addMouseDownHandler, addMouseMoveHandler, addMouseOutHandler, addMouseOverHandler, addMouseStillDownHandler, addMouseUpHandler, addMouseWheelHandler, addMovedHandler, addParentMovedHandler, addPeer, addPeer, addPeer, addPeer, addResizedHandler, addRightMouseDownHandler, addScrolledHandler, addShowContextMenuHandler, addSnapAlignCandidate, addStyleName, addVisibilityChangedHandler, adjustForContent, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateHide, animateHide, animateHide, animateMove, animateMove, animateMove, animateMove, animateRect, animateRect, animateRect, animateRect, animateResize, animateResize, animateResize, animateResize, animateScroll, animateScroll, animateScroll, animateScroll, animateScroll, animateScroll, animateShow, animateShow, animateShow, animateShow, animateShow, animateShow, asSGWTComponent, blur, bringToFront, clear, clickMaskUp, clickMaskUp, contains, contains, containsEvent, containsFocus, containsPoint, containsPoint, deparent, depeer, disable, enable, encloses, focus, focusInNextTabElement, focusInPreviousTabElement, getAbsoluteLeft, getAbsoluteTop, getAccessKey, getAlwaysShowScrollbars, getAnimateAcceleration, getAnimateFadeTime, getAnimateHideAcceleration, getAnimateHideTime, getAnimateMoveAcceleration, getAnimateMoveTime, getAnimateRectAcceleration, getAnimateRectTime, getAnimateResizeAcceleration, getAnimateResizeTime, getAnimateScrollAcceleration, getAnimateScrollTime, getAnimateShowAcceleration, getAnimateShowEffect, getAnimateShowTime, getAnimateTime, getAppImgDir, getAriaRole, getAutoDraw, getAutoMaskComponents, getAutoShowParent, getBackgroundColor, getBackgroundImage, getBackgroundPosition, getBackgroundRepeat, getBorder, getBottom, getById, getByJSObject, getByLocalId, getCanAcceptDrop, getCanDrag, getCanDragReposition, getCanDragResize, getCanDragScroll, getCanDrop, getCanDropBefore, getCanFocus, getCanHover, getCanSelectText, getCanvasAutoChild, getCanvasItem, getChildren, getChildrenResizeSnapAlign, getChildrenSnapAlign, getChildrenSnapCenterAlign, getChildrenSnapEdgeAlign, getChildrenSnapResizeToGrid, getChildrenSnapToGrid, getClassName, getComponentMask, getComponentMaskDefaults, getContentElement, getContents, getContextMenu, getCursor, getDataPath, getDefaultHeight, getDefaultWidth, getDestroyed, getDestroying, getDisabled, getDisabledCursor, getDisableTouchScrollingForDrag, getDoubleClickDelay, getDragAppearance, getDragIntersectStyle, getDragMaskType, getDragOpacity, getDragRepositionAppearance, getDragRepositionCursor, getDragResizeAppearance, getDragScrollDelay, getDragStartDistance, getDragTarget, getDragType, getDropTypes, getDropTypesAsString, getDynamicContents, getEdgeBackgroundColor, getEdgeCenterBackgroundColor, getEdgeImage, getEdgeMarginSize, getEdgeOffset, getEdgeOpacity, getEdgeShowCenter, getEdgeSize, getEditNode, getEditProxy, getElement, getElement, getEventEdge, getEventEdge, getExtraSpace, getFacetId, getFormItemAutoChild, getFullDataPath, getGroupBorderCSS, getGroupLabelBackgroundColor, getGroupLabelStyleName, getGroupTitle, getHeight, getHeightAsString, getHideUsingDisplayNone, getHoverAlign, getHoverAutoDestroy, getHoverComponent, getHoverDelay, getHoverHeight, getHoverHTML, getHoverMoveWithMouse, getHoverOpacity, getHoverStyle, getHoverVAlign, getHoverWidth, getHoverWrap, getHSnapOrigin, getHSnapOrigin, getHSnapPosition, getHSnapPosition, getHtmlElement, getHtmlPosition, getImage, getImgURL, getImgURL, getInnerContentHeight, getInnerContentWidth, getInnerHeight, getInnerWidth, getIsGroup, getIsPrinting, getIsSnapAlignCandidate, getKeepInParentRect, getLayoutAlign, getLeavePageSpace, getLeft, getLeftAsString, getLocateChildrenBy, getLocateChildrenType, getLocatePeersBy, getLocatePeersType, getMargin, getMasterCanvas, getMasterElement, getMatchElement, getMaxHeight, getMaxWidth, getMenuConstructor, getMinHeight, getMinNonEdgeSize, getMinWidth, getMomentumScrollMinSpeed, getMouseStillDownDelay, getMouseStillDownInitialDelay, getNextZIndex, getNoDoubleClicks, getNoDropCursor, getOffsetHeight, getOffsetWidth, getOffsetX, getOffsetY, getOpacity, getOuterElement, getPadding, getPageBottom, getPageLeft, getPageRect, getPageRight, getPageTop, getPanelContainer, getParentCanvas, getParentElement, getPeers, getPercentBox, getPercentSource, getPosition, getPrefix, getPrintChildrenAbsolutelyPositioned, getPrintHTML, getPrintHTML, getPrompt, getProportionalResizeModifiers, getProportionalResizing, getRect, getRedrawOnResize, getResizeBarTarget, getResizeFrom, getRight, getScrollbarSize, getScrollBottom, getScrollHeight, getScrollLeft, getScrollRight, getScrollTop, getScrollWidth, getShadowDepth, getShadowImage, getShadowOffset, getShadowSoftness, getShouldPrint, getShowCustomScrollbars, getShowDragShadow, getShowEdges, getShowHover, getShowHoverComponents, getShowResizeBar, getShowShadow, getShowSnapGrid, getShrinkElementOnHide, getSkinImgDir, getSnapAlignCandidates, getSnapAlignCenterLineStyle, getSnapAlignEdgeLineStyle, getSnapAxis, getSnapEdge, getSnapHDirection, getSnapHGap, getSnapOffsetLeft, getSnapOffsetTop, getSnapOnDrop, getSnapPosition, getSnapPosition, getSnapResizeToAlign, getSnapResizeToGrid, getSnapTo, getSnapToAlign, getSnapToCenterAlign, getSnapToEdgeAlign, getSnapToGrid, getSnapVDirection, getSnapVGap, getStyleName, getTabIndex, getTestInstance, getTitle, getTooltip, getTop, getTopAsString, getTopElement, getUseBackMask, getUseDragMask, getUseNativeDrag, getUseOpacityFilter, getUseTouchScrolling, getValuesManager, getViewportHeight, getViewportWidth, getVisibility, getVisibleHeight, getVisibleWidth, getVSnapOrigin, getVSnapOrigin, getVSnapPosition, getVSnapPosition, getWidth, getWidthAsString, getZIndex, getZIndex, handleHover, hide, hideClickMask, hideClickMask, hideComponentMask, hideComponentMask, hideContextMenu, imgHTML, imgHTML, imgHTML, intersects, isDirty, isDisabled, isDrawn, isFocused, isVisible, keyUp, layoutChildren, linkHTML, linkHTML, linkHTML, linkHTML, linkHTML, linkHTML, markForDestroy, markForRedraw, markForRedraw, moveAbove, moveBelow, moveBy, moveTo, onAttach, onDetach, pageScrollDown, pageScrollUp, parentResized, placeNear, placeNear, placeNear, printComponents, provideRuleContext, redraw, redraw, removeChild, removeChild, removePeer, removePeer, removeSnapAlignCandidate, resizeBy, resizeTo, resizeTo, revealChild, revealChild, scrollBy, scrollByPercent, scrollTo, scrollTo, scrollTo, scrollToBottom, scrollToLeft, scrollToPercent, scrollToRight, scrollToTop, sendToBack, setAccessKey, setAllowExternalFilters, setAlwaysShowScrollbars, setAnimateAcceleration, setAnimateFadeTime, setAnimateHideAcceleration, setAnimateHideTime, setAnimateMoveAcceleration, setAnimateMoveTime, setAnimateRectAcceleration, setAnimateRectTime, setAnimateResizeAcceleration, setAnimateResizeTime, setAnimateScrollAcceleration, setAnimateScrollTime, setAnimateShowAcceleration, setAnimateShowEffect, setAnimateShowTime, setAnimateTime, setAppImgDir, setAriaRole, setAriaState, setAutoChildConstructor, setAutoChildProperties, setAutoChildProperties, setAutoChildProperties, setAutoChildProperties, setAutoChildVisibility, setAutoDraw, setAutoHeight, setAutoMaskComponents, setAutoShowParent, setAutoWidth, setBackgroundColor, setBackgroundImage, setBackgroundPosition, setBackgroundRepeat, setBorder, setBottom, setCanAcceptDrop, setCanDrag, setCanDragReposition, setCanDragResize, setCanDragScroll, setCanDrop, setCanDropBefore, setCanFocus, setCanHover, setCanSelectText, setChildren, setChildrenResizeSnapAlign, setChildrenSnapAlign, setChildrenSnapCenterAlign, setChildrenSnapEdgeAlign, setChildrenSnapResizeToGrid, setChildrenSnapToGrid, setComponentMaskDefaults, setContents, setContextMenu, setCursor, setDataPath, setDefaultHeight, setDefaultPageSpace, setDefaultProperties, setDefaultWidth, setDisabled, setDisabledCursor, setDisableTouchScrollingForDrag, setDoubleClickDelay, setDragAppearance, setDragIntersectStyle, setDragMaskType, setDragOpacity, setDragRepositionAppearance, setDragRepositionCursor, setDragResizeAppearance, setDragScrollDelay, setDragStartDistance, setDragTarget, setDragType, setDropTypes, setDropTypes, setDynamicContents, setEdgeBackgroundColor, setEdgeCenterBackgroundColor, setEdgeImage, setEdgeMarginSize, setEdgeOffset, setEdgeOpacity, setEdgeShowCenter, setEdgeSize, setEditMode, setEditMode, setEditMode, setElement, setExtraSpace, setFacetId, setGroupBorderCSS, setGroupLabelBackgroundColor, setGroupLabelStyleName, setGroupTitle, setHeight, setHeight, setHeight, setHeight100, setHideUsingDisplayNone, setHoverAlign, setHoverAutoDestroy, setHoverDelay, setHoverHeight, setHoverMoveWithMouse, setHoverOpacity, setHoverStyle, setHoverVAlign, setHoverWidth, setHoverWrap, setHtmlElement, setHtmlPosition, setImage, setImage, setInitHandler, setIsGroup, setIsSnapAlignCandidate, setKeepInParentRect, setKeepInParentRect, setKeepInParentRect, setLayoutAlign, setLayoutAlign, setLeavePageSpace, setLeft, setLeft, setLocateChildrenBy, setLocateChildrenType, setLocatePeersBy, setLocatePeersType, setLogicalStructure, setMargin, setMatchElement, setMaxHeight, setMaxWidth, setMenuConstructor, setMinHeight, setMinNonEdgeSize, setMinWidth, setMomentumScrollMinSpeed, setMouseStillDownDelay, setMouseStillDownInitialDelay, setNeverUseFilters, setNoDoubleClicks, setNoDropCursor, setOpacity, setPadding, setPageLeft, setPageTop, setParentCanvas, setParentElement, setPeers, setPercentBox, setPercentSource, setPosition, setPrefix, setPrintChildrenAbsolutelyPositioned, setPrompt, setProportionalResizeModifiers, setProportionalResizing, setRect, setRect, setRedrawOnResize, setResizeBarTarget, setResizeFrom, setResizeFrom, setRight, setScrollbarConstructor, setScrollbarSize, setShadowDepth, setShadowImage, setShadowOffset, setShadowSoftness, setShouldPrint, setShowCustomScrollbars, setShowDragShadow, setShowEdges, setShowHover, setShowHoverComponents, setShowResizeBar, setShowShadow, setShowSnapGrid, setShrinkElementOnHide, setSkinImgDir, setSmoothFade, setSnapAlignCandidates, setSnapAlignCenterLineStyle, setSnapAlignEdgeLineStyle, setSnapAxis, setSnapEdge, setSnapHDirection, setSnapHGap, setSnapOffsetLeft, setSnapOffsetTop, setSnapOnDrop, setSnapResizeToAlign, setSnapResizeToGrid, setSnapTo, setSnapToAlign, setSnapToCenterAlign, setSnapToEdgeAlign, setSnapToGrid, setSnapVDirection, setSnapVGap, setStyleName, setTabIndex, setTitle, setTooltip, setTop, setTop, setUseBackMask, setUseDragMask, setUseNativeDrag, setUseOpacityFilter, setUseTouchScrolling, setValuesManager, setVisibility, setVisible, setWidth, setWidth, setWidth, setWidth100, setZIndex, shouldDragScroll, show, showClickMask, showComponentMask, showComponentMask, showNextTo, showNextTo, showNextTo, showNextTo, showPrintPreview, showPrintPreview, showPrintPreview, showPrintPreview, showRecursively, updateEditNode, updateHover, updateHover, updateShadow, visibleAtPoint, willAcceptDrop

Methods inherited from class com.smartgwt.client.widgets.BaseWidget

addDrawHandler, applyFactoryProperties, destroy, doAddHandler, doInit, doOnRender, draw, equals, error, errorIfNotCreated, getAttribute, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDateArray, getAttributeAsDouble, getAttributeAsElement, getAttributeAsFloat, getAttributeAsFloatArray, getAttributeAsInt, getAttributeAsIntArray, getAttributeAsJavaScriptObject, getAttributeAsMap, getAttributeAsRecord, getAttributeAsString, getAttributeAsStringArray, getConfig, getDOM, getHandlerCount, getID, getInnerHTML, getJsObj, getOrCreateJsObj, getRef, getScClassName, hasAutoAssignedID, hashCode, initNativeObject, internalSetID, internalSetID, isConfigOnly, isCreated, isFactoryCreated, onBind, onDestroy, onDraw, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setConfig, setConfigOnly, setDragTracker, setFactoryCreated, setID, setJavaScriptObject, setLogicalStructure, setNullProperty, setPosition, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setScClassName, toString

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

addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, doAttachChildren, doDetachChildren, fireEvent, getLayoutData, getParent, isAttached, isOrWasAttached, onBrowserEvent, onLoad, onUnload, removeFromParent, setLayoutData, sinkEvents, unsinkEvents

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

addStyleDependentName, ensureDebugId, ensureDebugId, ensureDebugId, getStyleElement, getStyleName, getStylePrimaryName, getStylePrimaryName, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, resolvePotentialElement, setElement, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setVisible, sinkBitlessEvent

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.google.gwt.event.shared.HasHandlers

fireEvent

Constructor Detail

MultiGroupPanel

public MultiGroupPanel()

MultiGroupPanel

public MultiGroupPanel(com.google.gwt.core.client.JavaScriptObject jsObj)

Method Detail

getOrCreateRef

public static MultiGroupPanel getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)

changeAutoChildDefaults

public static void changeAutoChildDefaults(java.lang.String autoChildName,
                                           Canvas defaults)

Changes the defaults for Canvas AutoChildren named autoChildName.

Parameters:

autoChildName - name of an AutoChild to customize the defaults for.

defaults - Canvas defaults to apply. These defaults override any existing properties without destroying or wiping out non-overridden properties. For usage tips on this param, see SGWTProperties.

See Also:

AutoChildUsage

changeAutoChildDefaults

public static void changeAutoChildDefaults(java.lang.String autoChildName,
                                           FormItem defaults)

Changes the defaults for FormItem AutoChildren named autoChildName.

Parameters:

autoChildName - name of an AutoChild to customize the defaults for.

defaults - FormItem defaults to apply. These defaults override any existing properties without destroying or wiping out non-overridden properties. For usage tips on this param, see SGWTProperties.

See Also:

AutoChildUsage

create

protected com.google.gwt.core.client.JavaScriptObject create()

Overrides:

create in class Layout

getAddLevelButton

public IButton getAddLevelButton()
                          throws java.lang.IllegalStateException

Automatically generated IButton providing a mechanism for adding new levels to the group configuration.

This component is an com.smartgwt.client.types.AutoChild and as such may be customized via multiGroupPanel.addLevelButtonProperties and multiGroupPanel.addLevelButtonDefaults.

For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

IButton

Throws:

java.lang.IllegalStateException - if this widget has not yet been rendered.

setAddLevelButtonTitle

public void setAddLevelButtonTitle(java.lang.String addLevelButtonTitle)
                            throws java.lang.IllegalStateException

The title-text to appear on the addLevelButton

Parameters:

addLevelButtonTitle - Default value is "Add Level"

Throws:

java.lang.IllegalStateException - this property cannot be changed after the component has been created

getAddLevelButtonTitle

public java.lang.String getAddLevelButtonTitle()

The title-text to appear on the addLevelButton

Returns:

String

getCopyLevelButton

public IButton getCopyLevelButton()
                           throws java.lang.IllegalStateException

Automatically generated IButton providing a mechanism for duplicating levels in the group configuration.

This component is an com.smartgwt.client.types.AutoChild and as such may be customized via multiGroupPanel.copyLevelButtonProperties and multiGroupPanel.copyLevelButtonDefaults.

For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

IButton

Throws:

java.lang.IllegalStateException - if this widget has not yet been rendered.

setCopyLevelButtonTitle

public void setCopyLevelButtonTitle(java.lang.String copyLevelButtonTitle)
                             throws java.lang.IllegalStateException

The title-text to appear on the copyLevelButton

Parameters:

copyLevelButtonTitle - Default value is "Copy Level"

Throws:

java.lang.IllegalStateException - this property cannot be changed after the component has been created

getCopyLevelButtonTitle

public java.lang.String getCopyLevelButtonTitle()

The title-text to appear on the copyLevelButton

Returns:

String

getDeleteLevelButton

public IButton getDeleteLevelButton()
                             throws java.lang.IllegalStateException

Automatically generated IButton providing a mechanism for deleting levels from the group configuration.

This component is an com.smartgwt.client.types.AutoChild and as such may be customized via multiGroupPanel.deleteLevelButtonProperties and multiGroupPanel.deleteLevelButtonDefaults.

For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

IButton

Throws:

java.lang.IllegalStateException - if this widget has not yet been rendered.

setDeleteLevelButtonTitle

public void setDeleteLevelButtonTitle(java.lang.String deleteLevelButtonTitle)
                               throws java.lang.IllegalStateException

The title-text to appear on the deleteLevelButton

Parameters:

deleteLevelButtonTitle - Default value is "Delete Level"

Throws:

java.lang.IllegalStateException - this property cannot be changed after the component has been created

getDeleteLevelButtonTitle

public java.lang.String getDeleteLevelButtonTitle()

The title-text to appear on the deleteLevelButton

Returns:

String

setFirstGroupLevelTitle

public void setFirstGroupLevelTitle(java.lang.String firstGroupLevelTitle)
                             throws java.lang.IllegalStateException

The title-text to appear in the first column for the first group-level.

Parameters:

firstGroupLevelTitle - Default value is "Group by"

Throws:

java.lang.IllegalStateException - this property cannot be changed after the component has been created

getFirstGroupLevelTitle

public java.lang.String getFirstGroupLevelTitle()

The title-text to appear in the first column for the first group-level.

Returns:

String

setGroupingFieldTitle

public void setGroupingFieldTitle(java.lang.String groupingFieldTitle)
                           throws java.lang.IllegalStateException

The title-text to appear in the header of the "grouping" field.

Parameters:

groupingFieldTitle - Default value is "Grouping"

Throws:

java.lang.IllegalStateException - this property cannot be changed after the component has been created

getGroupingFieldTitle

public java.lang.String getGroupingFieldTitle()

The title-text to appear in the header of the "grouping" field.

Returns:

String

setInvalidListPrompt

public void setInvalidListPrompt(java.lang.String invalidListPrompt)
                          throws java.lang.IllegalStateException

This is a dynamic string - text within ${...} will be evaluated as JS code when the message is displayed.

Default value returns

Columns may only be used once: [some field's title] is used multiple times

Parameters:

invalidListPrompt - See HTMLString . Default value is "Columns may only be used once: '${title}' is used multiple times."

Throws:

java.lang.IllegalStateException - this property cannot be changed after the component has been created

getInvalidListPrompt

public java.lang.String getInvalidListPrompt()

This is a dynamic string - text within ${...} will be evaluated as JS code when the message is displayed.

Default value returns

Columns may only be used once: [some field's title] is used multiple times

Returns:

See HTMLString

getLevelDownButton

public ImgButton getLevelDownButton()
                             throws java.lang.IllegalStateException

Automatically generated ImgButton providing a mechanism for moving existing group-levels down in the group configuration.

This component is an com.smartgwt.client.types.AutoChild and as such may be customized via multiGroupPanel.levelDownButtonProperties and multiGroupPanel.levelDownButtonDefaults.

For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

ImgButton

Throws:

java.lang.IllegalStateException - if this widget has not yet been rendered.

setLevelDownButtonTitle

public void setLevelDownButtonTitle(java.lang.String levelDownButtonTitle)
                             throws java.lang.IllegalStateException

The hover-prompt for the Level Down button.

Parameters:

levelDownButtonTitle - Default value is "Move Level Down"

Throws:

java.lang.IllegalStateException - this property cannot be changed after the component has been created

getLevelDownButtonTitle

public java.lang.String getLevelDownButtonTitle()

The hover-prompt for the Level Down button.

Returns:

String

getLevelUpButton

public ImgButton getLevelUpButton()
                           throws java.lang.IllegalStateException

Automatically generated ImgButton providing a mechanism for moving existing group-levels up in the group configuration.

This component is an com.smartgwt.client.types.AutoChild and as such may be customized via multiGroupPanel.levelUpButtonProperties and multiGroupPanel.levelUpButtonDefaults.

For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

ImgButton

Throws:

java.lang.IllegalStateException - if this widget has not yet been rendered.

setLevelUpButtonTitle

public void setLevelUpButtonTitle(java.lang.String levelUpButtonTitle)
                           throws java.lang.IllegalStateException

The hover-prompt for the Level Up button.

Parameters:

levelUpButtonTitle - Default value is "Move Level Up"

Throws:

java.lang.IllegalStateException - this property cannot be changed after the component has been created

getLevelUpButtonTitle

public java.lang.String getLevelUpButtonTitle()

The hover-prompt for the Level Up button.

Returns:

String

setMaxLevels

public void setMaxLevels(java.lang.Integer maxLevels)
                  throws java.lang.IllegalStateException

The maximum number of levels of grouping that can be applied. Since each group-property or field-name can be used only once in a given multi-group operation, if no maxLevels value or a value larger than the total number of available properties is specified, it will default to the total number of available properties.

Parameters:

maxLevels - Default value is null

Throws:

java.lang.IllegalStateException - this property cannot be changed after the component has been created

getMaxLevels

public java.lang.Integer getMaxLevels()

The maximum number of levels of grouping that can be applied. Since each group-property or field-name can be used only once in a given multi-group operation, if no maxLevels value or a value larger than the total number of available properties is specified, it will default to the total number of available properties.

Returns:

Integer

getOptionsGrid

public ListGrid getOptionsGrid()
                        throws java.lang.IllegalStateException

Automatically generated ListGrid allowing the user to configure a set of GroupSpecifiers.

This component is an com.smartgwt.client.types.AutoChild and as such may be customized via multiGroupPanel.optionsGridProperties and multiGroupPanel.optionsGridDefaults.

For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

ListGrid

Throws:

java.lang.IllegalStateException - if this widget has not yet been rendered.

setOtherGroupLevelTitle

public void setOtherGroupLevelTitle(java.lang.String otherGroupLevelTitle)
                             throws java.lang.IllegalStateException

The title-text to appear in the first column for all group-levels other than the first.

Parameters:

otherGroupLevelTitle - Default value is "Then by"

Throws:

java.lang.IllegalStateException - this property cannot be changed after the component has been created

getOtherGroupLevelTitle

public java.lang.String getOtherGroupLevelTitle()

The title-text to appear in the first column for all group-levels other than the first.

Returns:

String

setPropertyFieldTitle

public void setPropertyFieldTitle(java.lang.String propertyFieldTitle)
                           throws java.lang.IllegalStateException

The title-text to appear in the header of the "property" field.

Parameters:

propertyFieldTitle - Default value is "Column"

Throws:

java.lang.IllegalStateException - this property cannot be changed after the component has been created

getPropertyFieldTitle

public java.lang.String getPropertyFieldTitle()

The title-text to appear in the header of the "property" field.

Returns:

String

getGroup

public GroupSpecifier[] getGroup()

Returns all configured grouping levels, as an array of GroupSpecifiers.

Returns:

the GroupSpecifiers for all configured grouping levels

getNumLevels

public int getNumLevels()

Return the number of levels of grouping that have been configured.

Returns:

The number of levels of grouping that have been configured

groupChanged

public void groupChanged(GroupSpecifier... groupLevels)

Fired whenever the group configuration changes. The single parameter is an array of GroupSpecifiers that represent the list of group-levels as they appear after whatever change has occurred.

Parameters:

groupLevels - The current group configuration, after any changes

validate

public boolean validate()

Validate that no two GroupSpecifiers group on the same property.

Returns:

True if validation succeeds, false if any property is used twice

setDefaultProperties

public static void setDefaultProperties(MultiGroupPanel multiGroupPanelProperties)

Class level method to set the default properties of this class. If set, then all existing and subsequently created instances of this class will automatically have default properties corresponding to the properties set on the SmartGWT class instance passed to this function before its underlying SmartClient JS object was created. This is a powerful feature that eliminates the need for users to create a separate hierarchy of subclasses that only alter the default properties of this class. Can also be used for skinning / styling purposes.

Note: This method is intended for setting default attributes only and will affect all instances of the underlying class (including those automatically generated in JavaScript). This method should not be used to apply standard EventHandlers or override methods for a class - use a custom subclass instead. Calling this method after instances have been created can result in undefined behavior, since it bypasses any setters and a class instance may have already examined a particular property and not be expecting any changes through this route.

Parameters:

multiGroupPanelProperties - properties that should be used as new defaults when instances of this class are created

See Also:

SGWTProperties

setLogicalStructure

public com.smartgwt.logicalstructure.core.LogicalStructureObject setLogicalStructure(com.smartgwt.logicalstructure.widgets.MultiGroupPanelLogicalStructure s)

Setter implementing the LogicalStructure interface, which supports Eclipse's logical structure debugging facility.

getLogicalStructure

public com.smartgwt.logicalstructure.core.LogicalStructureObject getLogicalStructure()

Getter implementing the LogicalStructure interface, which supports Eclipse's logical structure debugging facility.

Specified by:

getLogicalStructure in interface LogicalStructure

Overrides:

getLogicalStructure in class Layout