com.smartgwt.client.widgets

Class MultiSortDialog

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.layout.VLayout

com.smartgwt.client.widgets.Window

com.smartgwt.client.widgets.MultiSortDialog

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

public class MultiSortDialog
extends Window

A dialog that allows the user to set up complex sorting arrangements by defining a group of SortSpecifiers.

Each SortSpecifier applies to a single property and direction - so, for instance, in a grid with two columns, year and monthNumber, you could sort first by year in descending order and then by monthNumber in ascending order. This would producing a grid sorted by year from largest (most recent) to smallest (least recent) and, within each year, by monthNumber from smallest (January) to largest (December).

See askForSort(), DataBoundComponent.askForSort()

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
MultiSortDialog()
MultiSortDialog(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 sort configuration.
java.lang.String	getAddLevelButtonTitle() The title-text to appear on the addLevelButton.
IButton	getApplyButton() Automatically generated IButton providing the mechanism for accepting the current sort configuration.
java.lang.String	getApplyButtonTitle() The title-text to appear on the applyButton
java.lang.String	getAscendingTitle() The title-text to appear in the "direction" field's SelectItem for an "ascending" sort
IButton	getCancelButton() Automatically generated IButton providing the mechanism for closing this Dialog without accepting the current sort configuration.
java.lang.String	getCancelButtonTitle() The title-text to appear on the cancelButton
IButton	getCopyLevelButton() Automatically generated IButton providing a mechanism for duplicating levels in the sort 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 sort configuration.
java.lang.String	getDeleteLevelButtonTitle() The title-text to appear on the deleteLevelButton
java.lang.String	getDescendingTitle() The title-text to appear in the "direction" field's SelectItem for a "descending" sort
java.lang.String	getDirectionFieldTitle() The title-text to appear in the header of the "direction" field.
DataSourceField[]	getFields() The list of fields which the user can choose to sort by.
java.lang.String	getFirstSortLevelTitle() The title-text to appear in the first column for the first sort-level.
SortSpecifier[]	getInitialSort() The initial sort configuration to show in the optionsGrid.
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 sort-levels down in the sort configuration.
java.lang.String	getLevelDownButtonTitle() The hover-prompt for the Level Down button.
ImgButton	getLevelUpButton() Automatically generated ImgButton providing a mechanism for moving existing sort-levels up in the sort 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 sorting that can be applied.
MultiSortPanel	getMultiSortPanel() Automatically generated MultiSortPanel displayed within this component.
int	getNumLevels() Return the number of levels of sorting that have been configured.
ListGrid	getOptionsGrid() Automatically generated ListGrid allowing the user to configure a set of SortSpecifiers.
static MultiSortDialog	getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)
java.lang.String	getOtherSortLevelTitle() The title-text to appear in the first column for all sort-levels other than the first.
java.lang.String	getPropertyFieldTitle() The title-text to appear in the header of the "property" field.
SortSpecifier[]	getSort() Returns all configured sorting levels, as an array of SortSpecifiers.
SortSpecifier	getSortLevel(int levelNum) Return a SortSpecifier object for the requested levelNum.
java.lang.String	getTitle() The title-text to appear in this Dialog's Header-bar.
void	setAddLevelButtonTitle(java.lang.String addLevelButtonTitle) The title-text to appear on the addLevelButton.
void	setApplyButtonTitle(java.lang.String applyButtonTitle) The title-text to appear on the applyButton
void	setAscendingTitle(java.lang.String ascendingTitle) The title-text to appear in the "direction" field's SelectItem for an "ascending" sort
void	setCancelButtonTitle(java.lang.String cancelButtonTitle) The title-text to appear on the cancelButton
void	setCopyLevelButtonTitle(java.lang.String copyLevelButtonTitle) The title-text to appear on the copyLevelButton
static void	setDefaultProperties(MultiSortDialog multiSortDialogProperties) 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	setDescendingTitle(java.lang.String descendingTitle) The title-text to appear in the "direction" field's SelectItem for a "descending" sort
void	setDirectionFieldTitle(java.lang.String directionFieldTitle) The title-text to appear in the header of the "direction" field.
void	setFields(DataSourceField... fields) The list of fields which the user can choose to sort by.
void	setFirstSortLevelTitle(java.lang.String firstSortLevelTitle) The title-text to appear in the first column for the first sort-level.
void	setInitialSort(SortSpecifier... initialSort) The initial sort configuration to show in the optionsGrid.
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.MultiSortDialogLogicalStructure 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 sorting that can be applied.
void	setOtherSortLevelTitle(java.lang.String otherSortLevelTitle) The title-text to appear in the first column for all sort-levels other than the first.
void	setPropertyFieldTitle(java.lang.String propertyFieldTitle) The title-text to appear in the header of the "property" field.
void	setTitle(java.lang.String title) The title-text to appear in this Dialog's Header-bar.
boolean	validate() Validate that no two SortSpecifiers sort on the same property.

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

addCloseClickHandler, addItem, addItem, addMaximizeClickHandler, addMember, addMember, addMinimizeClickHandler, addRestoreClickHandler, centerInPage, close, flash, getAnimateMinimize, getAutoCenter, getAutoSize, getBody, getBodyColor, getBodyStyle, getBringToFrontOnMouseUp, getCanDragReposition, getCanDragResize, getCanFocusInHeaderButtons, getCloseButton, getContentLayout, getContentsType, getDefaultMinimizeHeight, getDismissOnEscape, getDismissOnOutsideClick, getEditProxyConstructor, getFillSpaceStyleName, getFooter, getFooterHeight, getHeader, getHeaderBackground, getHeaderIcon, getHeaderLabel, getHeaderSrc, getHeaderStyle, getHiliteBodyColor, getHiliteHeaderSrc, getHiliteHeaderStyle, getIsModal, getItems, getMaximizeButton, getMaximized, getMinimizeAcceleration, getMinimizeButton, getMinimized, getMinimizeHeight, getMinimizeTime, getModalMask, getModalMaskOpacity, getModalMaskStyle, getOpacity, getPlacement, getPrintBodyStyle, getPrintHeaderStyle, getResizeFrom, getResizer, getRestoreButton, getShowBody, getShowCloseButton, getShowEdges, getShowFooter, getShowHeader, getShowHeaderBackground, getShowHeaderIcon, getShowMaximizeButton, getShowMinimizeButton, getShowModalMask, getShowResizer, getShowShadow, getShowStatusBar, getShowTitle, getSrc, getStatus, getStatusBar, getUseBackMask, maximize, minimize, preloadImages, removeItem, restore, revealChild, revealChild, setAnimateMinimize, setAutoCenter, setAutoSize, setBodyColor, setBodyDefaults, setBodyStyle, setBringToFrontOnMouseUp, setCanDragReposition, setCanDragResize, setCanFocusInHeaderButtons, setContentLayout, setContentLayout, setContentsType, setDefaultMinimizeHeight, setDefaultProperties, setDismissOnEscape, setDismissOnOutsideClick, setEditProxyConstructor, setFillSpaceStyleName, setFooterControls, setFooterHeight, setHeaderControls, setHeaderIcon, setHeaderIcon, setHeaderIconDefaults, setHeaderIconProperties, setHeaderSrc, setHeaderStyle, setHiliteBodyColor, setHiliteHeaderSrc, setHiliteHeaderStyle, setIsModal, setKeepInParentRect, setKeepInParentRect, setLogicalStructure, setMaximized, setMinimizeAcceleration, setMinimized, setMinimizeHeight, setMinimizeTime, setModalMaskOpacity, setModalMaskStyle, setOpacity, setPlacement, setPrintBodyStyle, setPrintHeaderStyle, setResizeFrom, setShowBody, setShowCloseButton, setShowEdges, setShowFooter, setShowHeader, setShowHeaderBackground, setShowHeaderIcon, setShowMaximizeButton, setShowMinimizeButton, setShowModalMask, setShowResizer, setShowShadow, setShowStatusBar, setShowTitle, setSrc, setStatus, setUseBackMask, shouldDismissOnEscape

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

setDefaultProperties, setLogicalStructure

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

addMember, addMember, addMember, addMemberPostCreate, addMemberPostCreate, addMemberPreCreate, addMemberPreCreate, addMembers, addMembers, addMembersChangedHandler, getAnimateMembers, getAnimateMemberTime, getCanDropComponents, getChildTabPosition, getDefaultResizeBars, getDropComponent, getDropLine, getDropLineThickness, getDropPosition, getEnforcePolicy, getHPolicy, getLayoutBottomMargin, getLayoutEndMargin, getLayoutLeftMargin, getLayoutMargin, getLayoutRightMargin, getLayoutStartMargin, getLayoutTopMargin, getLeaveScrollbarGap, getLocateMembersBy, getLocateMembersType, getManagePercentBreadth, getMember, getMember, getMemberDefaultBreadth, getMemberNumber, getMemberNumber, getMemberOverlap, getMembers, getMembersLength, getMembersMargin, getMinMemberLength, 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, setEnforcePolicy, setHPolicy, setLayoutBottomMargin, setLayoutEndMargin, setLayoutLeftMargin, setLayoutMargin, setLayoutRightMargin, setLayoutStartMargin, setLayoutTopMargin, setLeaveScrollbarGap, setLocateMembersBy, setLocateMembersType, setLogicalStructure, setManagePercentBreadth, setMemberOverlap, setMembers, setMembersMargin, setMinBreadthMember, setMinBreadthMember, setMinBreadthMember, setMinMemberLength, 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, addClearHandler, 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, addRuleContextChangedHandler, addScrolledHandler, addShowContextMenuHandler, addSnapAlignCandidate, addStyleName, addVisibilityChangedHandler, adjustForContent, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateHide, animateHide, animateHide, animateHide, 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, animateShow, asSGWTComponent, blur, bringToFront, clear, clearExplicitTabIndex, clickMaskUp, clickMaskUp, contains, contains, containsEvent, containsFocus, containsPoint, containsPoint, deparent, depeer, disable, enable, encloses, focus, focusAfterGroup, focusAtEnd, focusInNextTabElement, focusInPreviousTabElement, getAbsoluteLeft, getAbsoluteTop, getAccessKey, getAdaptiveHeightPriority, getAdaptiveWidthPriority, getAlwaysShowScrollbars, getAnimateAcceleration, getAnimateFadeTime, getAnimateHideAcceleration, getAnimateHideEffect, getAnimateHideTime, getAnimateMoveAcceleration, getAnimateMoveTime, getAnimateRectAcceleration, getAnimateRectTime, getAnimateResizeAcceleration, getAnimateResizeTime, getAnimateScrollAcceleration, getAnimateScrollTime, getAnimateShowAcceleration, getAnimateShowEffect, getAnimateShowTime, getAnimateTime, getAppImgDir, getAriaRole, getAutoDraw, getAutoMaskComponents, getAutoParent, getAutoShowParent, getBackgroundColor, getBackgroundImage, getBackgroundPosition, getBackgroundRepeat, getBorder, getBottom, getById, getByJSObject, getByLocalId, getCanAcceptDrop, getCanAdaptHeight, getCanAdaptWidth, getCanDrag, getCanDragScroll, getCanDrop, getCanDropBefore, getCanFocus, getCanHover, getCanSelectText, getCanvasAutoChild, getCanvasItem, getChildren, getChildrenResizeSnapAlign, getChildrenSnapAlign, getChildrenSnapCenterAlign, getChildrenSnapEdgeAlign, getChildrenSnapResizeToGrid, getChildrenSnapToGrid, getClassName, getComponentMask, getComponentMaskDefaults, getContentElement, getContents, getContextMenu, getCorrectZoomOverflow, getCursor, getDataPath, getDefaultHeight, getDefaultWidth, getDestroyed, getDestroying, getDisabled, getDisabledCursor, getDisableTouchScrollingForDrag, getDoubleClickDelay, getDragAppearance, getDragIntersectStyle, getDragMaskType, getDragMaxHeight, getDragMaxWidth, getDragMinHeight, getDragMinWidth, getDragOpacity, getDragRepositionAppearance, getDragRepositionCursor, getDragResizeAppearance, getDragScrollDelay, getDragStartDistance, getDragTarget, getDragType, getDropTypes, getDropTypesAsString, getDynamicContents, getEdgeBackgroundColor, getEdgeCenterBackgroundColor, getEdgeImage, getEdgeMarginSize, getEdgeOffset, getEdgeOpacity, getEdgeShowCenter, getEdgeSize, getEditNode, getEditProxy, getElement, getElement, getEnableWhen, getEndLine, getEventEdge, getEventEdge, getExtraSpace, getFacetId, getFormItemAutoChild, getFullDataPath, getGroupBorderCSS, getGroupLabelBackgroundColor, getGroupLabelStyleName, getGroupTitle, getHeight, getHeightAsString, getHideUsingDisplayNone, getHoverAlign, getHoverAutoDestroy, getHoverAutoFitMaxWidth, getHoverAutoFitMaxWidthAsString, getHoverAutoFitWidth, 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, getIsRuleScope, getIsSnapAlignCandidate, getKeepInParentRect, getLayoutAlign, getLeavePageSpace, getLeft, getLeftAsString, getLocalId, getLocateChildrenBy, getLocateChildrenType, getLocatePeersBy, getLocatePeersType, getMargin, getMasterCanvas, getMasterElement, getMatchElement, getMaxHeight, getMaxWidth, getMaxZoomOverflowError, getMenuConstructor, getMinHeight, getMinNonEdgeSize, getMinWidth, getMomentumScrollMinSpeed, getMouseStillDownDelay, getMouseStillDownInitialDelay, getNextZIndex, getNoDoubleClicks, getNoDropCursor, getOffsetHeight, getOffsetWidth, getOffsetX, getOffsetY, getOuterElement, getPadding, getPageBottom, getPageLeft, getPageRect, getPageRight, getPageTop, getPaletteDefaults, getPanelContainer, getParentCanvas, getParentElement, getPeers, getPercentBox, getPercentSource, getPosition, getPrefix, getPrintChildrenAbsolutelyPositioned, getPrintHTML, getPrintHTML, getPrompt, getProportionalResizeModifiers, getProportionalResizing, getRect, getRedrawOnResize, getResizeBarTarget, getRight, getRuleContext, getRuleContext, getRuleScope, getScrollbarSize, getScrollBottom, getScrollHeight, getScrollLeft, getScrollRight, getScrollTop, getScrollWidth, getShadowColor, getShadowDepth, getShadowHOffset, getShadowImage, getShadowOffset, getShadowSoftness, getShadowSpread, getShadowVOffset, getShouldPrint, getShowCustomScrollbars, getShowDragShadow, getShowHover, getShowHoverComponents, getShowResizeBar, getShowSnapGrid, getShrinkElementOnHide, getSizeMayChangeOnRedraw, getSkinImgDir, getSnapAlignCandidates, getSnapAlignCenterLineStyle, getSnapAlignEdgeLineStyle, getSnapAxis, getSnapEdge, getSnapHDirection, getSnapHGap, getSnapOffsetLeft, getSnapOffsetTop, getSnapOnDrop, getSnapPosition, getSnapPosition, getSnapResizeToAlign, getSnapResizeToGrid, getSnapTo, getSnapToAlign, getSnapToCenterAlign, getSnapToEdgeAlign, getSnapToGrid, getSnapVDirection, getSnapVGap, getStartLine, getStyleName, getTabIndex, getTestInstance, getTooltip, getTop, getTopAsString, getTopElement, getUpdateTabPositionOnDraw, getUpdateTabPositionOnReparent, getUseCSSShadow, getUseDragMask, getUseImageForSVG, getUseNativeDrag, getUseOpacityFilter, getUseTouchScrolling, getValuesManager, getValuesManagerAsString, getViewportHeight, getViewportWidth, getVisibility, getVisibleHeight, getVisibleWhen, getVisibleWidth, getVSnapOrigin, getVSnapOrigin, getVSnapPosition, getVSnapPosition, getWidth, getWidthAsString, getZIndex, getZIndex, handleHover, hide, hideClickMask, hideClickMask, hideComponentMask, hideComponentMask, hideContextMenu, imgHTML, imgHTML, imgHTML, intersects, isDirty, isDisabled, 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, provideRuleContext, redraw, redraw, removeChild, removeChild, removePeer, removePeer, removeSnapAlignCandidate, resizeAutoChildAttributes, resizeBy, resizeControls, resizeFonts, resizeFonts, resizeFonts, resizeIcons, resizeTo, resizeTo, scrollBy, scrollByPercent, scrollTo, scrollTo, scrollTo, scrollToBottom, scrollToLeft, scrollToPercent, scrollToRight, scrollToTop, sendToBack, setAccessKey, setAdaptHeightByCustomizer, setAdaptiveHeightPriority, setAdaptiveWidthPriority, setAdaptWidthByCustomizer, setAllowExternalFilters, setAlwaysShowScrollbars, setAnimateAcceleration, setAnimateFadeTime, setAnimateHideAcceleration, setAnimateHideEffect, 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, setAutoParent, setAutoResizeAutoChildAttributes, setAutoResizeIcons, setAutoShowParent, setAutoWidth, setBackgroundColor, setBackgroundImage, setBackgroundPosition, setBackgroundRepeat, setBorder, setBottom, setCanAcceptDrop, setCanAdaptHeight, setCanAdaptWidth, setCanDrag, setCanDragScroll, setCanDrop, setCanDropBefore, setCanFocus, setCanHover, setCanSelectText, setChildren, setChildrenResizeSnapAlign, setChildrenSnapAlign, setChildrenSnapCenterAlign, setChildrenSnapEdgeAlign, setChildrenSnapResizeToGrid, setChildrenSnapToGrid, setComponentMaskDefaults, setContents, setContextMenu, setCorrectZoomOverflow, setCursor, setDataPath, setDefaultHeight, setDefaultPageSpace, setDefaultProperties, setDefaultWidth, setDisabled, setDisabledCursor, setDisableTouchScrollingForDrag, setDoubleClickDelay, setDragAppearance, setDragIntersectStyle, setDragMaskType, setDragMaxHeight, setDragMaxWidth, setDragMinHeight, setDragMinWidth, setDragOpacity, setDragRepositionAppearance, setDragRepositionCursor, setDragResizeAppearance, setDragScrollDelay, setDragStartDistance, setDragTarget, setDragType, setDropTypes, setDropTypes, setDynamicContents, setEdgeBackgroundColor, setEdgeCenterBackgroundColor, setEdgeImage, setEdgeMarginSize, setEdgeOffset, setEdgeOpacity, setEdgeShowCenter, setEdgeSize, setEditMode, setEditMode, setEditMode, setElement, setEnableWhen, setEndLine, setExtraSpace, setFacetId, setGroupBorderCSS, setGroupLabelBackgroundColor, setGroupLabelStyleName, setGroupTitle, setHeight, setHeight, setHeight, setHeight100, setHideUsingDisplayNone, setHoverAlign, setHoverAutoDestroy, setHoverAutoFitMaxWidth, setHoverAutoFitMaxWidth, setHoverAutoFitWidth, setHoverDelay, setHoverHeight, setHoverMoveWithMouse, setHoverOpacity, setHoverStyle, setHoverVAlign, setHoverWidth, setHoverWrap, setHtmlElement, setHtmlPosition, setImage, setImage, setInitHandler, setIsGroup, setIsRuleScope, setIsSnapAlignCandidate, setKeepInParentRect, setLayoutAlign, setLayoutAlign, setLeavePageSpace, setLeft, setLeft, setLocateChildrenBy, setLocateChildrenType, setLocatePeersBy, setLocatePeersType, setLogicalStructure, setMargin, setMatchElement, setMaxHeight, setMaxWidth, setMaxZoomOverflowError, setMenuConstructor, setMinHeight, setMinNonEdgeSize, setMinWidth, setMomentumScrollMinSpeed, setMouseStillDownDelay, setMouseStillDownInitialDelay, setNeverUseFilters, setNoDoubleClicks, setNoDropCursor, setPadding, setPageLeft, setPageTop, setPanelContainer, setParentCanvas, setParentElement, setPeers, setPercentBox, setPercentSource, setPosition, setPrefix, setPrintChildrenAbsolutelyPositioned, setPrompt, setProportionalResizeModifiers, setProportionalResizing, setRect, setRect, setRedrawOnResize, setRelativeTabPosition, setResizeBarTarget, setResizeFrom, setRight, setRuleScope, setScrollbarConstructor, setScrollbarSize, setShadowColor, setShadowDepth, setShadowHOffset, setShadowImage, setShadowOffset, setShadowSoftness, setShadowSpread, setShadowVOffset, setShouldPrint, setShowCustomScrollbars, setShowDragShadow, setShowHover, setShowHoverComponents, setShowResizeBar, setShowSnapGrid, setShrinkElementOnHide, setSizeMayChangeOnRedraw, setSkinImgDir, setSmoothFade, setSnapAlignCandidates, setSnapAlignCenterLineStyle, setSnapAlignEdgeLineStyle, setSnapAxis, setSnapEdge, setSnapHDirection, setSnapHGap, setSnapOffsetLeft, setSnapOffsetTop, setSnapOnDrop, setSnapResizeToAlign, setSnapResizeToGrid, setSnapTo, setSnapToAlign, setSnapToCenterAlign, setSnapToEdgeAlign, setSnapToGrid, setSnapVDirection, setSnapVGap, setStartLine, setStyleName, setTabIndex, setTooltip, setTop, setTop, setUpdateTabPositionOnDraw, setUpdateTabPositionOnReparent, setUseCSSShadow, setUseDragMask, setUseImageForSVG, setUseNativeDrag, setUseOpacityFilter, setUseTouchScrolling, setValuesManager, setValuesManager, setVisibility, setVisible, setVisibleWhen, setWidth, setWidth, setWidth, setWidth100, setZIndex, shouldDragScroll, show, showClickMask, showComponentMask, showComponentMask, showNextTo, showNextTo, showNextTo, showNextTo, showPrintPreview, showPrintPreview, showPrintPreview, showPrintPreview, showRecursively, updateChildTabPosition, updateChildTabPositions, updateEditNode, updateHover, updateHover, updateShadow, updateTabPositionForDraw, visibleAtPoint, willAcceptDrop

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

addDrawHandler, applyFactoryProperties, completeCreation, 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, isDrawn, 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, setDefaultProperties, setDragTracker, setFactoryCreated, setID, setJavaScriptObject, setLogicalStructure, 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

MultiSortDialog

public MultiSortDialog()

MultiSortDialog

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

Method Detail

getOrCreateRef

public static MultiSortDialog 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 Window

getAddLevelButton

public IButton getAddLevelButton()
                          throws java.lang.IllegalStateException

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

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

This component is an AutoChild named "addLevelButton". For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

Current addLevelButton value. Default value is null

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.

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Parameters:

addLevelButtonTitle - New addLevelButtonTitle value. 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.

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Returns:

Current addLevelButtonTitle value. Default value is "Add Level"

getApplyButton

public IButton getApplyButton()
                       throws java.lang.IllegalStateException

Automatically generated IButton providing the mechanism for accepting the current sort configuration. Fires the passed callback with a single parameter, sortLevels, representing the current sort configuration as an array of SortSpecifiers.

This component is an com.smartgwt.client.types.AutoChild and as such may be customized via multiSortDialog.applyButtonProperties and multiSortDialog.applyButtonDefaults.

This component is an AutoChild named "applyButton". For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

Current applyButton value. Default value is null

Throws:

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

setApplyButtonTitle

public void setApplyButtonTitle(java.lang.String applyButtonTitle)
                         throws java.lang.IllegalStateException

The title-text to appear on the applyButton

Parameters:

applyButtonTitle - New applyButtonTitle value. Default value is "Apply"

Throws:

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

getApplyButtonTitle

public java.lang.String getApplyButtonTitle()

The title-text to appear on the applyButton

Returns:

Current applyButtonTitle value. Default value is "Apply"

setAscendingTitle

public void setAscendingTitle(java.lang.String ascendingTitle)
                       throws java.lang.IllegalStateException

The title-text to appear in the "direction" field's SelectItem for an "ascending" sort

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Parameters:

ascendingTitle - New ascendingTitle value. Default value is "Ascending"

Throws:

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

getAscendingTitle

public java.lang.String getAscendingTitle()

The title-text to appear in the "direction" field's SelectItem for an "ascending" sort

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Returns:

Current ascendingTitle value. Default value is "Ascending"

getCancelButton

public IButton getCancelButton()
                        throws java.lang.IllegalStateException

Automatically generated IButton providing the mechanism for closing this Dialog without accepting the current sort configuration. The passed callback is fired with a single null parameter, indicating that the operation was cancelled.

This component is an com.smartgwt.client.types.AutoChild and as such may be customized via multiSortDialog.cancelButtonProperties and multiSortDialog.cancelButtonDefaults.

This component is an AutoChild named "cancelButton". For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

Current cancelButton value. Default value is null

Throws:

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

setCancelButtonTitle

public void setCancelButtonTitle(java.lang.String cancelButtonTitle)
                          throws java.lang.IllegalStateException

The title-text to appear on the cancelButton

Parameters:

cancelButtonTitle - New cancelButtonTitle value. Default value is "Cancel"

Throws:

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

getCancelButtonTitle

public java.lang.String getCancelButtonTitle()

The title-text to appear on the cancelButton

Returns:

Current cancelButtonTitle value. Default value is "Cancel"

getCopyLevelButton

public IButton getCopyLevelButton()
                           throws java.lang.IllegalStateException

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

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

This component is an AutoChild named "copyLevelButton". For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

Current copyLevelButton value. Default value is null

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

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Parameters:

copyLevelButtonTitle - New copyLevelButtonTitle value. 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

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Returns:

Current copyLevelButtonTitle value. Default value is "Copy Level"

getDeleteLevelButton

public IButton getDeleteLevelButton()
                             throws java.lang.IllegalStateException

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

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

This component is an AutoChild named "deleteLevelButton". For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

Current deleteLevelButton value. Default value is null

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

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Parameters:

deleteLevelButtonTitle - New deleteLevelButtonTitle value. 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

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Returns:

Current deleteLevelButtonTitle value. Default value is "Delete Level"

setDescendingTitle

public void setDescendingTitle(java.lang.String descendingTitle)
                        throws java.lang.IllegalStateException

The title-text to appear in the "direction" field's SelectItem for a "descending" sort

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Parameters:

descendingTitle - New descendingTitle value. Default value is "Descending"

Throws:

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

getDescendingTitle

public java.lang.String getDescendingTitle()

The title-text to appear in the "direction" field's SelectItem for a "descending" sort

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Returns:

Current descendingTitle value. Default value is "Descending"

setDirectionFieldTitle

public void setDirectionFieldTitle(java.lang.String directionFieldTitle)
                            throws java.lang.IllegalStateException

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

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Parameters:

directionFieldTitle - New directionFieldTitle value. Default value is "Order"

Throws:

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

getDirectionFieldTitle

public java.lang.String getDirectionFieldTitle()

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

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Returns:

Current directionFieldTitle value. Default value is "Order"

setFields

public void setFields(DataSourceField... fields)
               throws java.lang.IllegalStateException

The list of fields which the user can choose to sort by.

Parameters:

fields - New fields value. Default value is null

Throws:

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

getFields

public DataSourceField[] getFields()

The list of fields which the user can choose to sort by.

Returns:

Current fields value. Default value is null

setFirstSortLevelTitle

public void setFirstSortLevelTitle(java.lang.String firstSortLevelTitle)
                            throws java.lang.IllegalStateException

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

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Parameters:

firstSortLevelTitle - New firstSortLevelTitle value. Default value is "Sort by"

Throws:

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

getFirstSortLevelTitle

public java.lang.String getFirstSortLevelTitle()

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

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Returns:

Current firstSortLevelTitle value. Default value is "Sort by"

setInitialSort

public void setInitialSort(SortSpecifier... initialSort)
                    throws java.lang.IllegalStateException

The initial sort configuration to show in the optionsGrid.

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog.

Parameters:

initialSort - New initialSort value. Default value is null

Throws:

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

getInitialSort

public SortSpecifier[] getInitialSort()

The initial sort configuration to show in the optionsGrid.

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog.

Returns:

Current initialSort value. Default value is null

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

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Parameters:

invalidListPrompt - New invalidListPrompt value. 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

See Also:

HTMLString

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

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Returns:

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

See Also:

HTMLString

getLevelDownButton

public ImgButton getLevelDownButton()
                             throws java.lang.IllegalStateException

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

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

This component is an AutoChild named "levelDownButton". For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

Current levelDownButton value. Default value is null

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 - New levelDownButtonTitle value. 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:

Current levelDownButtonTitle value. Default value is "Move Level Down"

getLevelUpButton

public ImgButton getLevelUpButton()
                           throws java.lang.IllegalStateException

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

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

This component is an AutoChild named "levelUpButton". For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

Current levelUpButton value. Default value is null

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 - New levelUpButtonTitle value. 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:

Current levelUpButtonTitle value. Default value is "Move Level Up"

setMaxLevels

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

The maximum number of levels of sorting that can be applied. Since each sort-property or field-name can be used only once in a given multi-sort 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.

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog.

Parameters:

maxLevels - New maxLevels value. 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 sorting that can be applied. Since each sort-property or field-name can be used only once in a given multi-sort 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.

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog.

Returns:

Current maxLevels value. Default value is null

getMultiSortPanel

public MultiSortPanel getMultiSortPanel()
                                 throws java.lang.IllegalStateException

Automatically generated MultiSortPanel displayed within this component.

This component is an AutoChild named "multiSortPanel". For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

Current multiSortPanel value. Default value is null

Throws:

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

getOptionsGrid

public ListGrid getOptionsGrid()
                        throws java.lang.IllegalStateException

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

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

This component is an AutoChild named "optionsGrid". For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

Current optionsGrid value. Default value is null

Throws:

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

setOtherSortLevelTitle

public void setOtherSortLevelTitle(java.lang.String otherSortLevelTitle)
                            throws java.lang.IllegalStateException

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

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Parameters:

otherSortLevelTitle - New otherSortLevelTitle value. Default value is "Then by"

Throws:

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

getOtherSortLevelTitle

public java.lang.String getOtherSortLevelTitle()

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

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Returns:

Current otherSortLevelTitle value. Default value is "Then by"

setPropertyFieldTitle

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

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

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Parameters:

propertyFieldTitle - New propertyFieldTitle value. 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.

Note, this is a passthrough property which, when set, is passed through to the MultiSortPanel contained in this dialog. You only need to consider the properties on the MultiSortPanel for i18n.

Returns:

Current propertyFieldTitle value. Default value is "Column"

setTitle

public void setTitle(java.lang.String title)
              throws java.lang.IllegalStateException

The title-text to appear in this Dialog's Header-bar.

Overrides:

setTitle in class Window

Parameters:

title - New title value. Default value is "Sort"

Throws:

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

See Also:

HTMLString, Appearance overview and related methods

getTitle

public java.lang.String getTitle()

The title-text to appear in this Dialog's Header-bar.

Overrides:

getTitle in class Window

Returns:

Current title value. Default value is "Sort"

See Also:

HTMLString, Appearance overview and related methods

getNumLevels

public int getNumLevels()

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

Returns:

The number of levels of sorting that have been configured

getSort

public SortSpecifier[] getSort()

Returns all configured sorting levels, as an array of SortSpecifiers.

Returns:

the SortSpecifiers for all configured sorting levels

getSortLevel

public SortSpecifier getSortLevel(int levelNum)

Return a SortSpecifier object for the requested levelNum.

Parameters:

levelNum - The index of the level to return a SortSpecifier for

Returns:

A SortSpecifier representing the requested levelNum

validate

public boolean validate()

Validate that no two SortSpecifiers sort on the same property.

Returns:

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

setDefaultProperties

public static void setDefaultProperties(MultiSortDialog multiSortDialogProperties)

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:

multiSortDialogProperties - 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.MultiSortDialogLogicalStructure 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 Window