public class Window extends VLayout implements HasCloseClickHandlers, HasMaximizeClickHandlers, HasMinimizeClickHandlers, HasRestoreClickHandlers
Windows can contain arbitrary Smart GWT components, configured via the items
property. Windows may be modal
or non-modal.
Windows provide a series of highly configurable
and skinnable autoChildren
including a header, various header controls,
footer, and corner resizer.
The more specialized Dialog
subclass of Window has
additional functionality targetted at simple prompts and confirmations, such as buttons with default actions, and
single-method shortcuts
for common application dialogs.
config, configOnly, factoryCreated, factoryProperties, id, nativeObject, scClassName
Constructor and Description |
---|
Window() |
Window(com.google.gwt.core.client.JavaScriptObject jsObj) |
Modifier and Type | Method and Description |
---|---|
com.google.gwt.event.shared.HandlerRegistration |
addCloseClickHandler(CloseClickHandler handler)
Add a closeClick handler.
|
void |
addItem(Canvas component)
Adds a widget to the window.
|
void |
addItem(com.google.gwt.user.client.ui.Widget widget)
Adds a widget to the window.
|
com.google.gwt.event.shared.HandlerRegistration |
addMaximizeClickHandler(MaximizeClickHandler handler)
Add a maximizeClick handler.
|
void |
addMember(Canvas newMember)
Same as
Layout.addMember() . |
void |
addMember(Canvas newMember,
java.lang.Integer position)
Same as
Layout.addMember() . |
com.google.gwt.event.shared.HandlerRegistration |
addMinimizeClickHandler(MinimizeClickHandler handler)
Add a minimizeClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRestoreClickHandler(RestoreClickHandler handler)
Add a restoreClick handler.
|
void |
centerInPage()
Centers the Window in the page.
|
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 . |
void |
close()
Close this window.
|
protected com.google.gwt.core.client.JavaScriptObject |
create() |
void |
flash()
Makes the window header flash if it's visible; if there's no header, or the header is hidden, makes the window
body flash instead.
|
java.lang.Boolean |
getAnimateMinimize()
Should this window minimize, maximize, and restore as an animation, or as a simple 1-step transition?
|
java.lang.Boolean |
getAutoCenter()
If true, this Window widget will automatically be centered on the page when shown.
|
java.lang.Boolean |
getAutoSize()
If true, the window is resized automatically to accommodate the contents of the body, if they would otherwise require
scrolling.
|
Canvas |
getBody()
Body of the Window, where
contained components or loaded content is shown. |
java.lang.String |
getBodyColor()
Color of the Window body.
|
java.lang.String |
getBodyStyle()
Style of the Window body.
|
boolean |
getBringToFrontOnMouseUp()
Should this window automatically be shown at the top of the page's z-order and be brought to front via
Canvas.bringToFront() whenever the user clicks it? |
java.lang.Boolean |
getCanDragReposition()
If true, this Window may be moved around by the user by dragging on the Window header.
|
java.lang.Boolean |
getCanDragResize()
Can the window be drag-resized? If true the window may be drag resized from its edges, and if showing, via the resizer
icon in the footer.
|
java.lang.Boolean |
getCanFocusInHeaderButtons()
If true, the user can give the header buttons focus (see
minimizeButton , maximizeButton , restoreButton and closeButton ). |
ImgButton |
getCloseButton()
Button show in the header that will close this Window by calling
Window.closeClick() . |
ContentLayoutPolicy |
getContentLayout()
The layout policy that should be used for widgets within the Window body.
|
java.lang.String |
getContentsType()
If this window has
src specified, this property can be used to
indicate whether the source is a standalone HTML page or an HTML fragment. |
int |
getDefaultMinimizeHeight()
If
minimizeHeight is unset, by the window will shrink to
the height of the header when minimized. |
java.lang.Boolean |
getDismissOnEscape()
Should this window be dismissed (same effect as pressing the "Cancel" button) when the user presses the "Escape"
key?
Windows with this setting will dismiss on Escape keypresses in any of the following cases: The window or one of its descendants has focus (and does not cancel the Escape keypress) The window is modal , and not itself masked. |
java.lang.Boolean |
getDismissOnOutsideClick()
If true, a click outside the bounds of the Window will have the same effect as pressing its cancel button.
Note: Applies only to modal windows. |
java.lang.String |
getEditProxyConstructor()
Default class used to construct the
EditProxy for this component when the component is
first placed into edit mode . |
java.lang.String |
getFillSpaceStyleName()
Alternative style for the window used whenever
placement
settings indicate the menu will be filling a portion of the screen or a panel. |
HLayout |
getFooter()
Optional footer for the window, providing space for controls such as the resizer and status bar.
|
int |
getFooterHeight()
The height of the footer, in pixels.
|
HLayout |
getHeader()
Header for the Window, based on an HLayout.
|
Img |
getHeaderBackground()
Img background component for the header, for gradient or image-based display
|
Img |
getHeaderIcon()
Header icon shown at left end of header by default.
|
Label |
getHeaderLabel()
Label that shows Window title in header.
|
java.lang.String |
getHeaderSrc()
If
showHeaderBackground is true , this
property provides the URL of the background image for the header. |
java.lang.String |
getHeaderStyle()
Style for the Window header.
|
java.lang.String |
getHiliteBodyColor()
Highlight color for the Window body (shown when the body is flashed).
|
java.lang.String |
getHiliteHeaderSrc()
If
showHeaderBackground is true, this governs the URL
of the image to use in the header's highlighted state when the window is flashed |
java.lang.String |
getHiliteHeaderStyle()
Highlight style for the Window header.
|
java.lang.Boolean |
getIsModal()
If true, when shown this Window will intercept and block events to all other existing components on the page.
|
Canvas[] |
getItems()
The contents of the Window body.
|
com.smartgwt.logicalstructure.core.LogicalStructureObject |
getLogicalStructure()
Getter implementing the
LogicalStructure interface,
which supports Eclipse's logical structure debugging facility. |
ImgButton |
getMaximizeButton()
Button that will make this Window fill the browser via
maximize() . |
java.lang.Boolean |
getMaximized()
Is this window maximized.
|
AnimationAcceleration |
getMinimizeAcceleration()
Default acceleration function for performing an animated minimize / maximize.
|
ImgButton |
getMinimizeButton()
ImgButton shown in the header that will minimize this Window by calling
minimize() . |
java.lang.Boolean |
getMinimized()
Is this window minimized.
|
java.lang.Integer |
getMinimizeHeight()
Height for the window when minimized.
|
java.lang.Integer |
getMinimizeTime()
If this window is minimizeable, and animateMinimize is true, what should the duration of the minimize / maximize be (in
ms)? If unset defaults to
canvas.animationTime . |
Canvas |
getModalMask()
A ScreenSpan instance used to darken the rest of a page when a modal window is active.
|
int |
getModalMaskOpacity()
Controls the opacity of the modal mask displayed behind modal windows.
|
java.lang.String |
getModalMaskStyle()
Specifies the CSS style for the modal mask.
|
java.lang.Integer |
getOpacity()
Renders the widget to be partly transparent.
|
static Window |
getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj) |
PanelPlacement |
getPlacement()
Where should the window be placed on the screen? Valid settings include
"fillScreen" ,
"fillPanel" , "halfScreen" and "none" |
java.lang.String |
getPrintBodyStyle()
Style for the Window body in printed output.
|
java.lang.String |
getPrintHeaderStyle()
CSS Style for header in printed output
|
EdgeName[] |
getResizeFrom()
When drag resizing is enabled via
canDragResize , restricts
resizes to only certain edges or corners. |
ImgButton |
getResizer()
ImgButton-based resizer, shown in the footer.
|
ImgButton |
getRestoreButton()
ImgButton that restores the Window via
restore() . |
java.lang.Boolean |
getShowBody()
If true, draw the body contents when this Window is drawn.
|
java.lang.Boolean |
getShowCloseButton()
If true, show a close button in the header, which will dismiss this window by calling
Window.closeClick() . |
java.lang.Boolean |
getShowEdges()
showEdges dynamically defaults to false when the placement setting indicates the Window will be filling a portion of the screen or a panel. |
java.lang.Boolean |
getShowFooter()
If true, show a footer for this Window, including resizer, statusBar, etc.
|
java.lang.Boolean |
getShowHeader()
If true, show a
header for this Window. |
java.lang.Boolean |
getShowHeaderBackground()
Should the window header show a background image? Default value is true for all browsers except for Internet
Explorer.
If set to true the image source is derived from headerSrc and hiliteHeaderSrc , otherwise the background
will be styled according to headerStyle / hiliteHeaderStyle . |
java.lang.Boolean |
getShowHeaderIcon()
If true, we show an icon on the left in the header.
|
java.lang.Boolean |
getShowMaximizeButton()
If true, show a maximize button in the header - clicking it maximizes the Window
|
java.lang.Boolean |
getShowMinimizeButton()
If true, show a minimize button in the header--clicking it minimizes the Window.
|
java.lang.Boolean |
getShowModalMask()
If true, displays a translucent mask over the rest of the page when a modal window is displayed.
|
java.lang.Boolean |
getShowResizer()
If true, show a button in the lower right corner that allows users to resize the Window.
|
java.lang.Boolean |
getShowShadow()
Whether to show a drop shadow for this Canvas.
|
java.lang.Boolean |
getShowStatusBar()
If true, show a statusBar for this Window, including resizer.
|
java.lang.Boolean |
getShowTitle()
Show a title (typically just text) on the header for this window.
|
java.lang.String |
getSrc()
A URL to load as content for the Window's body.
|
java.lang.String |
getStatus()
Text to show in the status bar of the window (if one is visible)
|
Canvas |
getStatusBar()
Simple Canvas-based status bar, shown in the footer.
|
java.lang.String |
getTitle()
|
java.lang.Boolean |
getUseBackMask()
By default Windows show a
backMask in Internet Explorer
versions predating Internet Explorer 9. |
void |
maximize()
Maximize the window.
|
void |
minimize()
Minimize the window.
|
static void |
preloadImages()
Preload primary window skin images
|
void |
removeItem(Canvas component)
Removes a widget from the window.
|
void |
restore()
Restores the window to its specified height and width after a call to
minimize() or maximize() . |
void |
revealChild(Canvas child)
Reveals the child Canvas passed in by showing it if it is currently hidden.
|
void |
revealChild(java.lang.String childID)
Reveals the child Canvas passed in by showing it if it is currently hidden.
|
Window |
setAnimateMinimize(java.lang.Boolean animateMinimize)
Should this window minimize, maximize, and restore as an animation, or as a simple 1-step transition?
|
Window |
setAutoCenter(java.lang.Boolean autoCenter)
If true, this Window widget will automatically be centered on the page when shown.
|
Window |
setAutoSize(java.lang.Boolean autoSize)
If true, the window is resized automatically to accommodate the contents of the body, if they would otherwise require
scrolling.
|
Window |
setBodyColor(java.lang.String bodyColor)
Color of the Window body.
|
Window |
setBodyDefaults(java.util.Map bodyDefaults)
Default properties for the body of the Window
You can change the class-level bodyDefaults for all Windows by changing this item or set instance.body to be another object of properties to override for your instance only |
Window |
setBodyStyle(java.lang.String bodyStyle)
Style of the Window body.
|
Window |
setBringToFrontOnMouseUp(boolean bringToFrontOnMouseUp)
Should this window automatically be shown at the top of the page's z-order and be brought to front via
Canvas.bringToFront() whenever the user clicks it? |
Window |
setCanDragReposition(java.lang.Boolean canDragReposition)
If true, this Window may be moved around by the user by dragging on the Window header.
|
Window |
setCanDragResize(java.lang.Boolean canDragResize)
Can the window be drag-resized? If true the window may be drag resized from its edges, and if showing, via the resizer
icon in the footer.
|
Window |
setCanFocusInHeaderButtons(java.lang.Boolean canFocusInHeaderButtons)
If true, the user can give the header buttons focus (see
minimizeButton , maximizeButton , restoreButton and closeButton ). |
Window |
setContentLayout(ContentLayoutPolicy contentLayout)
The layout policy that should be used for widgets within the Window body.
|
void |
setContentLayout(java.lang.String contentLayout)
Deprecated.
use the other
setContentLayout()
|
Window |
setContentsType(java.lang.String contentsType)
If this window has
src specified, this property can be used to
indicate whether the source is a standalone HTML page or an HTML fragment. |
Window |
setDefaultMinimizeHeight(int defaultMinimizeHeight)
If
minimizeHeight is unset, by the window will shrink to
the height of the header when minimized. |
static void |
setDefaultProperties(Window windowProperties)
Class level method to set the default properties of this class.
|
Window |
setDismissOnEscape(java.lang.Boolean dismissOnEscape)
Should this window be dismissed (same effect as pressing the "Cancel" button) when the user presses the "Escape"
key?
Windows with this setting will dismiss on Escape keypresses in any of the following cases: The window or one of its descendants has focus (and does not cancel the Escape keypress) The window is modal , and not itself masked. |
Window |
setDismissOnOutsideClick(java.lang.Boolean dismissOnOutsideClick)
If true, a click outside the bounds of the Window will have the same effect as pressing its cancel button.
Note: Applies only to modal windows. |
Window |
setEditProxyConstructor(java.lang.String editProxyConstructor)
Default class used to construct the
EditProxy for this component when the component is
first placed into edit mode . |
Window |
setFillSpaceStyleName(java.lang.String fillSpaceStyleName)
Alternative style for the window used whenever
placement
settings indicate the menu will be filling a portion of the screen or a panel. |
void |
setFooterControls(java.lang.Object... footerControls)
Array of members to show in the Window footer.
|
Window |
setFooterHeight(int footerHeight)
The height of the footer, in pixels.
|
void |
setHeaderControls(java.lang.Object... headerControls)
Array of members to show in the Window header.
|
void |
setHeaderIcon(java.lang.String imgSrc)
Sets the Window header icon.
|
void |
setHeaderIcon(java.lang.String imgSrc,
int width,
int height)
Sets the Window header icon.
|
Window |
setHeaderIconDefaults(java.util.Map headerIconDefaults)
This is an object literal property block specifying the various properties of the headerIcon - the icon that appears at
the top left of the window and is by default the Isomorphic logo.
|
void |
setHeaderIconProperties(java.util.Map headerIconProperties) |
Window |
setHeaderSrc(java.lang.String headerSrc)
If
showHeaderBackground is true , this
property provides the URL of the background image for the header. |
Window |
setHeaderStyle(java.lang.String headerStyle)
Style for the Window header.
|
Window |
setHiliteBodyColor(java.lang.String hiliteBodyColor)
Highlight color for the Window body (shown when the body is flashed).
|
Window |
setHiliteHeaderSrc(java.lang.String hiliteHeaderSrc)
If
showHeaderBackground is true, this governs the URL
of the image to use in the header's highlighted state when the window is flashed |
Window |
setHiliteHeaderStyle(java.lang.String hiliteHeaderStyle)
Highlight style for the Window header.
|
Window |
setIsModal(java.lang.Boolean isModal)
If true, when shown this Window will intercept and block events to all other existing components on the page.
|
Window |
setKeepInParentRect(java.lang.Boolean keepInParentRect)
If Window.canDragReposition or Window.canDragResize is true, should the windows size and position be constrained
such that it remains within the viewport of its parent element (or for top level windows, within the viewport of
the browser window)?
Note: keepInParentRect affects only user drag interactions, not programmatic moves. |
Window |
setKeepInParentRect(Rectangle rectangle)
If Window.canDragReposition or Window.canDragRShowcaseDataesize is true, should the windows size and position be
constrained such that it remains within the viewport of its parent element (or for top level windows, within the
viewport of the browser window)? Can also be set to an array denoting an arbitrary Rectangle beyond which the
window cannot be moved.
|
com.smartgwt.logicalstructure.core.LogicalStructureObject |
setLogicalStructure(com.smartgwt.logicalstructure.widgets.WindowLogicalStructure s)
Setter implementing the
LogicalStructure interface,
which supports Eclipse's logical structure debugging facility. |
Window |
setMaximized(java.lang.Boolean maximized)
Is this window maximized.
|
Window |
setMinimizeAcceleration(AnimationAcceleration minimizeAcceleration)
Default acceleration function for performing an animated minimize / maximize.
|
Window |
setMinimized(java.lang.Boolean minimized)
Is this window minimized.
|
Window |
setMinimizeHeight(java.lang.Integer minimizeHeight)
Height for the window when minimized.
|
Window |
setMinimizeTime(java.lang.Integer minimizeTime)
If this window is minimizeable, and animateMinimize is true, what should the duration of the minimize / maximize be (in
ms)? If unset defaults to
canvas.animationTime . |
Window |
setModalMaskOpacity(int modalMaskOpacity)
Controls the opacity of the modal mask displayed behind modal windows.
|
Window |
setModalMaskStyle(java.lang.String modalMaskStyle)
Specifies the CSS style for the modal mask.
|
Window |
setOpacity(java.lang.Integer opacity)
Renders the widget to be partly transparent.
|
Window |
setPlacement(PanelPlacement placement)
Where should the window be placed on the screen? Valid settings include
"fillScreen" ,
"fillPanel" , "halfScreen" and "none" |
Window |
setPrintBodyStyle(java.lang.String printBodyStyle)
Style for the Window body in printed output.
|
Window |
setPrintHeaderStyle(java.lang.String printHeaderStyle)
CSS Style for header in printed output
|
Window |
setResizeFrom(EdgeName... resizeFrom)
When drag resizing is enabled via
canDragResize , restricts
resizes to only certain edges or corners. |
Window |
setShowBody(java.lang.Boolean showBody)
If true, draw the body contents when this Window is drawn.
|
Window |
setShowCloseButton(java.lang.Boolean showCloseButton)
If true, show a close button in the header, which will dismiss this window by calling
Window.closeClick() . |
Window |
setShowEdges(java.lang.Boolean showEdges)
showEdges dynamically defaults to false when the placement setting indicates the Window will be filling a portion of the screen or a panel. |
Window |
setShowFooter(java.lang.Boolean showFooter)
If true, show a footer for this Window, including resizer, statusBar, etc.
|
Window |
setShowHeader(java.lang.Boolean showHeader)
If true, show a
header for this Window. |
Window |
setShowHeaderBackground(java.lang.Boolean showHeaderBackground)
Should the window header show a background image? Default value is true for all browsers except for Internet
Explorer.
If set to true the image source is derived from headerSrc and hiliteHeaderSrc , otherwise the background
will be styled according to headerStyle / hiliteHeaderStyle . |
Window |
setShowHeaderIcon(java.lang.Boolean showHeaderIcon)
If true, we show an icon on the left in the header.
|
Window |
setShowMaximizeButton(java.lang.Boolean showMaximizeButton)
If true, show a maximize button in the header - clicking it maximizes the Window
If this method is called after the component has been drawn/initialized: Dynamically update showMaximizeButton to show / hide the maximizeButton |
Window |
setShowMinimizeButton(java.lang.Boolean showMinimizeButton)
If true, show a minimize button in the header--clicking it minimizes the Window.
|
Window |
setShowModalMask(java.lang.Boolean showModalMask)
If true, displays a translucent mask over the rest of the page when a modal window is displayed.
|
Window |
setShowResizer(java.lang.Boolean showResizer)
If true, show a button in the lower right corner that allows users to resize the Window.
|
Window |
setShowShadow(java.lang.Boolean showShadow)
Whether to show a drop shadow for this Canvas.
|
Window |
setShowStatusBar(java.lang.Boolean showStatusBar)
If true, show a statusBar for this Window, including resizer.
|
Window |
setShowTitle(java.lang.Boolean showTitle)
Show a title (typically just text) on the header for this window.
|
Window |
setSrc(java.lang.String src)
A URL to load as content for the Window's body.
|
Window |
setStatus(java.lang.String status)
Text to show in the status bar of the window (if one is visible)
If this method is called after the component has been drawn/initialized: Sets the text in the status bar of the window, redrawing if necessary. |
void |
setTitle(java.lang.String title)
|
Window |
setUseBackMask(java.lang.Boolean useBackMask)
By default Windows show a
backMask in Internet Explorer
versions predating Internet Explorer 9. |
java.lang.Boolean |
shouldDismissOnEscape()
Should this window be dismissed (same effect as pressing the "Cancel" button) when the user presses the "Escape"
key?
Default behavior: if dismissOnEscape is set, just
return it. |
setDefaultProperties, setLogicalStructure
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, replaceMember, 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
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, containsEventTarget, containsFocus, containsPoint, containsPoint, dataContextChanged, deparent, depeer, disable, enable, encloses, focus, focusAfterGroup, focusAtEnd, focusInNextTabElement, focusInPreviousTabElement, getAbsoluteLeft, getAbsoluteTop, getAccessKey, getAdaptiveHeightPriority, getAdaptiveWidthPriority, getAlwaysManageFocusNavigation, getAlwaysShowScrollbars, getAnimateAcceleration, getAnimateFadeTime, getAnimateHideAcceleration, getAnimateHideEffect, getAnimateHideTime, getAnimateMoveAcceleration, getAnimateMoveTime, getAnimateRectAcceleration, getAnimateRectTime, getAnimateResizeAcceleration, getAnimateResizeLayoutMode, getAnimateResizeTime, getAnimateScrollAcceleration, getAnimateScrollTime, getAnimateShowAcceleration, getAnimateShowEffect, getAnimateShowTime, getAnimateTime, getAppImgDir, getAriaHandleID, getAriaRole, getAriaStateDefaults, getAutoMaskComponents, getAutoParent, getAutoPopulateData, getAutoShowParent, getBackgroundColor, getBackgroundImage, getBackgroundPosition, getBackgroundRepeat, getBorder, getBorderRadius, 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, getDataContext, getDataPath, getDefaultHeight, getDefaultWidth, getDestroyed, getDestroying, getDisabled, getDisabledCursor, getDisableTouchScrollingForDrag, getDoubleClickDelay, getDragAppearance, getDragIntersectStyle, getDragMaskType, getDragMaxHeight, getDragMaxWidth, getDragMinHeight, getDragMinWidth, getDragOpacity, getDragRepositionAppearance, getDragRepositionCursor, getDragResizeAppearance, getDragScrollDelay, getDragStartDistance, getDragTarget, getDragTargetAsString, getDragType, getDropTarget, getDropTargetAsString, getDropTypes, getDropTypesAsString, getDynamicContents, getEdgeBackgroundColor, getEdgeCenterBackgroundColor, getEdgeImage, getEdgeMarginSize, getEdgeOffset, getEdgeOpacity, getEdgeShowCenter, getEdgeSize, getEditNode, getEditProxy, getElement, getElement, getEnableWhen, getEndLine, getEventEdge, getEventEdge, getExtraSpace, getFacetId, getFloatingScrollbars, getFormItemAutoChild, getForwardSVGeventsToObject, getFullDataPath, getGroupBorderCSS, getGroupLabelBackgroundColor, getGroupLabelStyleName, getGroupPadding, getGroupTitle, getHeight, getHeightAsString, getHideUsingDisplayNone, getHoverAlign, getHoverAutoDestroy, getHoverAutoFitMaxWidth, getHoverAutoFitMaxWidthAsString, getHoverAutoFitWidth, getHoverComponent, getHoverDelay, getHoverFocusKey, getHoverHeight, getHoverHTML, getHoverMoveWithMouse, getHoverOpacity, getHoverPersist, getHoverScreen, getHoverStyle, getHoverVAlign, getHoverWidth, getHoverWrap, getHSnapPosition, getHSnapPosition, getHtmlElement, getHtmlElementAsString, getHtmlPosition, getImage, getImgURL, getImgURL, getInnerContentHeight, getInnerContentWidth, getInnerHeight, getInnerWidth, getIsGroup, getIsPrinting, getIsRuleScope, getIsSnapAlignCandidate, getKeepInParentRect, getLayoutAlign, getLeaveGroupLabelSpace, getLeavePageSpace, getLeft, getLeftAsString, getLocalId, getLocateByIDOnly, getLocateChildrenBy, getLocateChildrenType, getLocatePeersBy, getLocatePeersType, getLocatorName, getMargin, getMasterCanvas, getMasterElement, getMatchElement, getMatchElementHeight, getMatchElementWidth, getMaxHeight, getMaxWidth, getMaxZoomOverflowError, getMenuConstructor, getMinHeight, getMinNonEdgeSize, getMinWidth, getMomentumScrollMinSpeed, getMouseStillDownDelay, getMouseStillDownInitialDelay, getName, getNativeAutoHideScrollbars, getNextZIndex, getNoDoubleClicks, getNoDropCursor, getOffsetHeight, getOffsetWidth, getOffsetX, getOffsetY, getOuterElement, getPadding, getPageBottom, getPageLeft, getPageRect, getPageRight, getPageTop, getPaletteDefaults, getPanelContainer, getParentCanvas, getParentElement, getPeers, getPercentBox, getPercentSource, getPersistentMatchElement, getPointerSettings, getPointerTarget, getPointerTargetAsString, getPosition, getPrefix, getPrintChildrenAbsolutelyPositioned, getPrintHTML, getPrintHTML, getPrintStyleName, getPrompt, getProportionalResizeModifiers, getProportionalResizing, getReceiveScrollbarEvents, 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, getShowPointer, getShowResizeBar, getShowSnapGrid, getShrinkElementOnHide, getSizeMayChangeOnRedraw, getSkinImgDir, getSnapAlignCandidates, getSnapAlignCenterLineStyle, getSnapAlignEdgeLineStyle, getSnapAxis, getSnapEdge, getSnapGridLineProperties, getSnapGridStyle, getSnapHDirection, getSnapHGap, getSnapOffsetLeft, getSnapOffsetTop, getSnapOnDrop, getSnapPosition, getSnapPosition, getSnapResizeToAlign, getSnapResizeToGrid, getSnapTo, getSnapToAlign, getSnapToCenterAlign, getSnapToEdgeAlign, getSnapToGrid, getSnapVDirection, getSnapVGap, getStartLine, getStyleName, getTabIndex, getTestDataContext, getTestInstance, getTooltip, getTop, getTopAsString, getTopElement, getUISummary, getUpdateTabPositionOnDraw, getUpdateTabPositionOnReparent, getUseCSSShadow, getUseDragMask, getUseImageForSVG, getUseNativeDrag, getUseOpacityFilter, getUseTouchScrolling, getValuesManager, getValuesManagerAsString, getViewportHeight, getViewportWidth, getVisibility, getVisibleHeight, getVisibleWhen, getVisibleWidth, 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, print, print, print, print, printComponents, provideRuleContext, provideRuleContext, redraw, redraw, registerFontScaledPaddingStyles, removeChild, removeChild, removePeer, removePeer, removeRuleContext, removeSnapAlignCandidate, resizeAutoChildAttributes, resizeBy, resizeControls, resizeControlsTo, resizeFonts, resizeFonts, resizeFonts, resizeFontsTo, resizeIcons, resizePadding, resizePadding, resizeTo, resizeTo, scrollBy, scrollByPercent, scrollTo, scrollTo, scrollTo, scrollToBottom, scrollToLeft, scrollToPercent, scrollToRight, scrollToTop, sendToBack, setAccessKey, setAdaptHeightByCustomizer, setAdaptiveHeightPriority, setAdaptiveWidthPriority, setAdaptWidthByCustomizer, setAllowExternalFilters, setAlwaysManageFocusNavigation, setAlwaysShowScrollbars, setAnimateAcceleration, setAnimateFadeTime, setAnimateHideAcceleration, setAnimateHideEffect, setAnimateHideTime, setAnimateMoveAcceleration, setAnimateMoveTime, setAnimateRectAcceleration, setAnimateRectTime, setAnimateResizeAcceleration, setAnimateResizeLayoutMode, setAnimateResizeTime, setAnimateScrollAcceleration, setAnimateScrollTime, setAnimateShowAcceleration, setAnimateShowEffect, setAnimateShowTime, setAnimateTime, setAppImgDir, setAriaRole, setAriaState, setAutoChildConstructor, setAutoChildProperties, setAutoChildProperties, setAutoChildProperties, setAutoChildProperties, setAutoChildVisibility, setAutoHeight, setAutoMaskComponents, setAutoParent, setAutoPopulateData, setAutoResizeAutoChildAttributes, setAutoResizeIcons, setAutoShowParent, setAutoWidth, setBackgroundColor, setBackgroundImage, setBackgroundPosition, setBackgroundRepeat, setBorder, setBorderRadius, setBottom, setCanAcceptDrop, setCanAdaptHeight, setCanAdaptWidth, setCanDrag, setCanDragScroll, setCanDrop, setCanDropBefore, setCanFocus, setCanHover, setCanSelectText, setChildren, setChildrenResizeSnapAlign, setChildrenSnapAlign, setChildrenSnapCenterAlign, setChildrenSnapEdgeAlign, setChildrenSnapResizeToGrid, setChildrenSnapToGrid, setComponentMaskDefaults, setContents, setContextMenu, setCorrectZoomOverflow, setCursor, setDataContext, setDataPath, setDefaultHeight, setDefaultPageSpace, setDefaultProperties, setDefaultShowCustomScrollbars, setDefaultWidth, setDisabled, setDisabledCursor, setDisableTouchScrollingForDrag, setDoubleClickDelay, setDragAppearance, setDragIntersectStyle, setDragMaskType, setDragMaxHeight, setDragMaxWidth, setDragMinHeight, setDragMinWidth, setDragOpacity, setDragRepositionAppearance, setDragRepositionCursor, setDragResizeAppearance, setDragScrollDelay, setDragStartDistance, setDragTarget, setDragTarget, setDragType, setDropTarget, setDropTarget, setDropTypes, setDropTypes, setDynamicContents, setEdgeBackgroundColor, setEdgeCenterBackgroundColor, setEdgeImage, setEdgeMarginSize, setEdgeOffset, setEdgeOpacity, setEdgeShowCenter, setEdgeSize, setEditMode, setEditMode, setEditMode, setElement, setEnableWhen, setEndLine, setExtraSpace, setFacetId, setFloatingScrollbars, setForwardSVGeventsToObject, setGroupBorderCSS, setGroupLabelBackgroundColor, setGroupLabelStyleName, setGroupPadding, setGroupTitle, setHeight, setHeight, setHeight, setHeight100, setHideUsingDisplayNone, setHoverAlign, setHoverAutoDestroy, setHoverAutoFitMaxWidth, setHoverAutoFitMaxWidth, setHoverAutoFitWidth, setHoverDelay, setHoverFocusKey, setHoverHeight, setHoverMoveWithMouse, setHoverOpacity, setHoverPersist, setHoverScreen, setHoverStyle, setHoverVAlign, setHoverWidth, setHoverWrap, setHtmlElement, setHtmlElement, setHtmlPosition, setImage, setImage, setInitHandler, setIsGroup, setIsRuleScope, setIsSnapAlignCandidate, setKeepInParentRect, setLayoutAlign, setLayoutAlign, setLeaveGroupLabelSpace, setLeavePageSpace, setLeft, setLeft, setLocateByIDOnly, setLocateChildrenBy, setLocateChildrenType, setLocatePeersBy, setLocatePeersType, setLocatorName, setLocatorParent, setLocatorParent, setLogicalStructure, setMargin, setMatchElement, setMatchElementHeight, setMatchElementWidth, setMaxHeight, setMaxWidth, setMaxZoomOverflowError, setMenuConstructor, setMinHeight, setMinNonEdgeSize, setMinWidth, setMomentumScrollMinSpeed, setMouseStillDownDelay, setMouseStillDownInitialDelay, setName, setNativeAutoHideScrollbars, setNeverUseFilters, setNoDoubleClicks, setNoDropCursor, setPadding, setPageLeft, setPageTop, setPanelContainer, setParentCanvas, setParentElement, setPeers, setPercentBox, setPercentSource, setPersistentMatchElement, setPointerSettings, setPointerTarget, setPosition, setPrefix, setPrintChildrenAbsolutelyPositioned, setPrintStyleName, setPrompt, setProportionalResizeModifiers, setProportionalResizing, setReceiveScrollbarEvents, setRect, setRect, setRedrawOnResize, setRelativeTabPosition, setResizeBarTarget, setResizeFrom, setRight, setRuleScope, setScrollbarConstructor, setScrollbarSize, setShadowColor, setShadowDepth, setShadowHOffset, setShadowImage, setShadowOffset, setShadowSoftness, setShadowSpread, setShadowVOffset, setShouldPrint, setShowCustomScrollbars, setShowDragShadow, setShowHover, setShowHoverComponents, setShowPointer, setShowResizeBar, setShowSnapGrid, setShrinkElementOnHide, setSizeMayChangeOnRedraw, setSkinImgDir, setSmoothFade, setSnapAlignCandidates, setSnapAlignCenterLineStyle, setSnapAlignEdgeLineStyle, setSnapAxis, setSnapEdge, setSnapGridLineProperties, setSnapGridStyle, setSnapHDirection, setSnapHGap, setSnapOffsetLeft, setSnapOffsetTop, setSnapOnDrop, setSnapResizeToAlign, setSnapResizeToGrid, setSnapTo, setSnapToAlign, setSnapToCenterAlign, setSnapToEdgeAlign, setSnapToGrid, setSnapVDirection, setSnapVGap, setStartLine, setStyleName, setTabIndex, setTestDataContext, 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
addDrawHandler, addDynamicProperty, addDynamicProperty, addDynamicProperty, addDynamicProperty, applyFactoryProperties, clearDynamicProperty, completeCreation, destroy, doAddHandler, doInit, doOnRender, draw, equals, error, errorIfNotCreated, getAttribute, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDateArray, getAttributeAsDouble, getAttributeAsElement, getAttributeAsFloat, getAttributeAsFloatArray, getAttributeAsInt, getAttributeAsIntArray, getAttributeAsJavaScriptObject, getAttributeAsMap, getAttributeAsObject, getAttributeAsRecord, getAttributeAsString, getAttributeAsStringArray, getConfig, getDOM, getHandlerCount, getID, getInnerHTML, getJsObj, getOrCreateJsObj, getRef, getScClassName, hasAutoAssignedID, hasDynamicProperty, 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
addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, doAttachChildren, doDetachChildren, fireEvent, getLayoutData, getParent, isAttached, isOrWasAttached, onBrowserEvent, onLoad, onUnload, removeFromParent, setLayoutData, sinkEvents, unsinkEvents
addStyleDependentName, ensureDebugId, ensureDebugId, ensureDebugId, getStyleElement, getStyleName, getStylePrimaryName, getStylePrimaryName, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, resolvePotentialElement, setElement, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setVisible, sinkBitlessEvent
public Window()
public Window(com.google.gwt.core.client.JavaScriptObject jsObj)
public static Window getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)
public static void changeAutoChildDefaults(java.lang.String autoChildName, Canvas defaults)
autoChildName
.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
.AutoChildUsage
public static void changeAutoChildDefaults(java.lang.String autoChildName, FormItem defaults)
autoChildName
.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
.AutoChildUsage
protected com.google.gwt.core.client.JavaScriptObject create()
public Window setAnimateMinimize(java.lang.Boolean animateMinimize)
Note : This is an advanced setting
animateMinimize
- New animateMinimize value. Default value is nullWindow
instance, for chaining setter callsAppearance overview and related methods
,
Window Minimize Examplepublic java.lang.Boolean getAnimateMinimize()
Appearance overview and related methods
,
Window Minimize Examplepublic Window setAutoCenter(java.lang.Boolean autoCenter)
Note: If an auto-centering Window
is either programmatically moved or dragged by an end user, auto-centering behavior is automatically turned off. To
manually center a Window, you can use centerInPage()
.
Auto-centering will also be disabled if you pass an explicit left
or
top
value at create time.
If this method is called after the component has been drawn/initialized:
Setter for the autoCenter
attribute.
autoCenter
- new value for autoCenter. Default value is falseWindow
instance, for chaining setter callsAppearance overview and related methods
public java.lang.Boolean getAutoCenter()
Note: If an auto-centering Window
is either programmatically moved or dragged by an end user, auto-centering behavior is automatically turned off. To
manually center a Window, you can use centerInPage()
.
Auto-centering will also be disabled if you pass an explicit left
or
top
value at create time.
Appearance overview and related methods
public Window setAutoSize(java.lang.Boolean autoSize)
autoSize
autoSize
- true if the window should auto-size to its content. Default value is falseWindow
instance, for chaining setter callsAppearance overview and related methods
,
Auto Size Examplepublic java.lang.Boolean getAutoSize()
Appearance overview and related methods
,
Auto Size Examplepublic Canvas getBody() throws java.lang.IllegalStateException
contained components
or loaded content
is shown. The following passthroughs
apply:
bodyStyle
for the Canvas.styleName
printBodyStyle
for the styleName
to use when
printingbodyColor
/ hiliteBodyColor
for the Canvas.backgroundColor
This component is an AutoChild named "body". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public Window setBodyColor(java.lang.String bodyColor)
bodyColor
.bodyColor
- new backgroundColor
for the body
. Default value is "#FFFFFF"Window
instance, for chaining setter callsflash()
,
CSSColor
,
Appearance overview and related methods
public java.lang.String getBodyColor()
flash()
,
CSSColor
,
Appearance overview and related methods
public Window setBodyDefaults(java.util.Map bodyDefaults)
Note : This is an advanced setting
bodyDefaults
- New bodyDefaults value. Default value is ...Window
instance, for chaining setter callsAppearance overview and related methods
public Window setBodyStyle(java.lang.String bodyStyle)
bodyStyle
.bodyStyle
- new styleName
for the body
. Default value is "windowBody"Window
instance, for chaining setter callsCSSStyleName
,
Appearance overview and related methods
public java.lang.String getBodyStyle()
CSSStyleName
,
Appearance overview and related methods
public Window setBringToFrontOnMouseUp(boolean bringToFrontOnMouseUp)
Canvas.bringToFront()
whenever the user clicks it? If isModal
is true for this window, this setting will have no effect - we
always bring the window to the front on initial display and on mouseDown. By default we also do this for non-modal
windows (which matches user expectation for most standard interfaces - think of switching between OS-level application
windows), but this may be disabled for cases where it is not appropriate by setting this attribute to
false
bringToFrontOnMouseUp
- New bringToFrontOnMouseUp value. Default value is trueWindow
instance, for chaining setter callspublic boolean getBringToFrontOnMouseUp()
Canvas.bringToFront()
whenever the user clicks it? If isModal
is true for this window, this setting will have no effect - we
always bring the window to the front on initial display and on mouseDown. By default we also do this for non-modal
windows (which matches user expectation for most standard interfaces - think of switching between OS-level application
windows), but this may be disabled for cases where it is not appropriate by setting this attribute to
false
public Window setCanDragReposition(java.lang.Boolean canDragReposition)
setCanDragReposition
in class Canvas
canDragReposition
- New canDragReposition value. Default value is trueWindow
instance, for chaining setter callssetShowHeader(java.lang.Boolean)
public java.lang.Boolean getCanDragReposition()
getCanDragReposition
in class Canvas
getShowHeader()
public Window setCanDragResize(java.lang.Boolean canDragResize)
setCanDragResize
in class Canvas
canDragResize
- New canDragResize value. Default value is falseWindow
instance, for chaining setter callssetShowResizer(java.lang.Boolean)
public java.lang.Boolean getCanDragResize()
getCanDragResize
in class Canvas
getShowResizer()
public Window setCanFocusInHeaderButtons(java.lang.Boolean canFocusInHeaderButtons)
minimizeButton
, maximizeButton
, restoreButton
and closeButton
).
Note : This is an advanced setting
canFocusInHeaderButtons
- New canFocusInHeaderButtons value. Default value is falseWindow
instance, for chaining setter callsFocus overview and related methods
public java.lang.Boolean getCanFocusInHeaderButtons()
minimizeButton
, maximizeButton
, restoreButton
and closeButton
).Focus overview and related methods
public ImgButton getCloseButton() throws java.lang.IllegalStateException
Window.closeClick()
.
This component is an AutoChild named "closeButton". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public Window setContentLayout(ContentLayoutPolicy contentLayout)
See ContentLayoutPolicy
and bodyConstructor
for details.
Note : This is an advanced setting
contentLayout
- New contentLayout value. Default value is "vertical"Window
instance, for chaining setter callsAppearance overview and related methods
public ContentLayoutPolicy getContentLayout()
See ContentLayoutPolicy
and bodyConstructor
for details.
Appearance overview and related methods
public Window setContentsType(java.lang.String contentsType) throws java.lang.IllegalStateException
src
specified, this property can be used to
indicate whether the source is a standalone HTML page or an HTML fragment. This is similar to the HTMLFlow.contentsType
property - be sure to read the HTMLFlow
documentation to understand circumstances where contentsType:"page" is unsafe and not recommended.
contentsType
- New contentsType value. Default value is "page"Window
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdsetSrc(java.lang.String)
,
Appearance overview and related methods
public java.lang.String getContentsType()
src
specified, this property can be used to
indicate whether the source is a standalone HTML page or an HTML fragment. This is similar to the HTMLFlow.contentsType
property - be sure to read the HTMLFlow
documentation to understand circumstances where contentsType:"page" is unsafe and not recommended.
getSrc()
,
Appearance overview and related methods
public Window setDefaultMinimizeHeight(int defaultMinimizeHeight)
minimizeHeight
is unset, by the window will shrink to
the height of the header when minimized. defaultMinimizeHeight
will be used
instead.
Note : This is an advanced setting
defaultMinimizeHeight
- New defaultMinimizeHeight value. Default value is 16Window
instance, for chaining setter callsAppearance overview and related methods
public int getDefaultMinimizeHeight()
minimizeHeight
is unset, by the window will shrink to
the height of the header when minimized. defaultMinimizeHeight
will be used
instead.Appearance overview and related methods
public Window setDismissOnEscape(java.lang.Boolean dismissOnEscape)
modal
, and not itself masked. This ensures that focus is not on some
unrelated element on the page.If unset default behavior depends on whether a close / cancel button is visible for this item.
dismissOnEscape
- New dismissOnEscape value. Default value is nullWindow
instance, for chaining setter callsshouldDismissOnEscape()
public java.lang.Boolean getDismissOnEscape()
modal
, and not itself masked. This ensures that focus is not on some
unrelated element on the page.If unset default behavior depends on whether a close / cancel button is visible for this item.
shouldDismissOnEscape()
public Window setDismissOnOutsideClick(java.lang.Boolean dismissOnOutsideClick)
dismissOnOutsideClick
- New dismissOnOutsideClick value. Default value is falseWindow
instance, for chaining setter callssetIsModal(java.lang.Boolean)
public java.lang.Boolean getDismissOnOutsideClick()
getIsModal()
public Window setEditProxyConstructor(java.lang.String editProxyConstructor) throws java.lang.IllegalStateException
EditProxy
for this component when the component is
first placed into edit mode
.setEditProxyConstructor
in class Layout
editProxyConstructor
- New editProxyConstructor value. Default value is "WindowEditProxy"Window
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdSCClassName
public java.lang.String getEditProxyConstructor()
EditProxy
for this component when the component is
first placed into edit mode
.getEditProxyConstructor
in class Layout
SCClassName
public Window setFillSpaceStyleName(java.lang.String fillSpaceStyleName) throws java.lang.IllegalStateException
placement
settings indicate the menu will be filling a portion of the screen or a panel. Generally this alternative style should
not have rounded or excessively large edges.fillSpaceStyleName
- New fillSpaceStyleName value. Default value is "windowBackgroundFill"Window
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdCSSStyleName
public java.lang.String getFillSpaceStyleName()
placement
settings indicate the menu will be filling a portion of the screen or a panel. Generally this alternative style should
not have rounded or excessively large edges.CSSStyleName
public HLayout getFooter() throws java.lang.IllegalStateException
This component is an AutoChild named "footer". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public Window setFooterHeight(int footerHeight) throws java.lang.IllegalStateException
footerHeight
- New footerHeight value. Default value is 18Window
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdAppearance overview and related methods
public int getFooterHeight()
Appearance overview and related methods
public HLayout getHeader() throws java.lang.IllegalStateException
headerControls
. The
following passthroughs
apply:
headerStyle
for Canvas.styleName
printHeaderStyle
for the styleName
to use when
printing.
This component is an AutoChild named "header". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public Img getHeaderBackground() throws java.lang.IllegalStateException
This component is an AutoChild named "headerBackground". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public Img getHeaderIcon() throws java.lang.IllegalStateException
This component is an AutoChild named "headerIcon". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public Window setHeaderIconDefaults(java.util.Map headerIconDefaults)
16
and specifies the width of the headerIcon. 14
and
specifies the height of the headerIcon. "[SKIN]/Window/minimize.gif"
and specifies
the image for the headerIcon. Note : This is an advanced setting
headerIconDefaults
- New headerIconDefaults value. Default value is ...Window
instance, for chaining setter callsAppearance overview and related methods
public Label getHeaderLabel() throws java.lang.IllegalStateException
The following passthrough
applies: title
for Label.contents
.
This component is an AutoChild named "headerLabel". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public Window setHeaderSrc(java.lang.String headerSrc)
showHeaderBackground
is true
, this
property provides the URL of the background image for the header.
Note : This is an advanced setting
headerSrc
- New headerSrc value. Default value is "[SKIN]Window/headerGradient.gif" | nullWindow
instance, for chaining setter callsSCImgURL
,
Appearance overview and related methods
public java.lang.String getHeaderSrc()
showHeaderBackground
is true
, this
property provides the URL of the background image for the header.SCImgURL
,
Appearance overview and related methods
public Window setHeaderStyle(java.lang.String headerStyle)
headerStyle
.
Note : This is an advanced setting
headerStyle
- new styleName
for the header
. Default value is "WindowHeader"Window
instance, for chaining setter callsCSSStyleName
,
Appearance overview and related methods
public java.lang.String getHeaderStyle()
CSSStyleName
,
Appearance overview and related methods
public Window setHiliteBodyColor(java.lang.String hiliteBodyColor)
hiliteBodyColor
.hiliteBodyColor
- new hiliteBodyColor
. Default value is "#EEEEEE"Window
instance, for chaining setter callsflash()
,
CSSColor
,
Appearance overview and related methods
public java.lang.String getHiliteBodyColor()
flash()
,
CSSColor
,
Appearance overview and related methods
public Window setHiliteHeaderSrc(java.lang.String hiliteHeaderSrc)
showHeaderBackground
is true, this governs the URL
of the image to use in the header's highlighted state when the window is flashed
Note : This is an advanced setting
hiliteHeaderSrc
- New hiliteHeaderSrc value. Default value is "[SKIN]Window/headerGradient_hilite.gif" | nullWindow
instance, for chaining setter callsSCImgURL
,
Appearance overview and related methods
public java.lang.String getHiliteHeaderSrc()
showHeaderBackground
is true, this governs the URL
of the image to use in the header's highlighted state when the window is flashed
SCImgURL
,
Appearance overview and related methods
public Window setHiliteHeaderStyle(java.lang.String hiliteHeaderStyle)
flashed
Note : This is an advanced setting
hiliteHeaderStyle
- New hiliteHeaderStyle value. Default value is "WindowHeader"Window
instance, for chaining setter callsCSSStyleName
,
Appearance overview and related methods
public java.lang.String getHiliteHeaderStyle()
flashed
CSSStyleName
,
Appearance overview and related methods
public Window setIsModal(java.lang.Boolean isModal)
Use
showModalMask
to darken all other elements on the screen
when a modal dialog is showing.
Chained modal windows - that is, modal windows that launch other modal windows - are allowed. You can accomplish this by simply creating a second modal Window while a modal Window is showing.
Note only top-level Windows (Windows without parents) can be modal.
isModal
- New isModal value. Default value is falseWindow
instance, for chaining setter callspublic java.lang.Boolean getIsModal()
Use
showModalMask
to darken all other elements on the screen
when a modal dialog is showing.
Chained modal windows - that is, modal windows that launch other modal windows - are allowed. You can accomplish this by simply creating a second modal Window while a modal Window is showing.
Note only top-level Windows (Windows without parents) can be modal.
public ImgButton getMaximizeButton() throws java.lang.IllegalStateException
maximize()
.
This component is an AutoChild named "maximizeButton". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public Window setMaximized(java.lang.Boolean maximized)
maximize()
or restore()
.maximized
- New maximized value. Default value is falseWindow
instance, for chaining setter callsAppearance overview and related methods
public java.lang.Boolean getMaximized()
maximize()
or restore()
.Appearance overview and related methods
public Window setMinimizeAcceleration(AnimationAcceleration minimizeAcceleration)
this.animateAcceleration
will be used by default instead
Note : This is an advanced setting
minimizeAcceleration
- New minimizeAcceleration value. Default value is nullWindow
instance, for chaining setter callsAppearance overview and related methods
public AnimationAcceleration getMinimizeAcceleration()
this.animateAcceleration
will be used by default insteadAppearance overview and related methods
public ImgButton getMinimizeButton() throws java.lang.IllegalStateException
minimize()
.
This component is an AutoChild named "minimizeButton". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public Window setMinimized(java.lang.Boolean minimized)
minimize()
or restore()
.minimized
- New minimized value. Default value is falseWindow
instance, for chaining setter callsAppearance overview and related methods
public java.lang.Boolean getMinimized()
minimize()
or restore()
.Appearance overview and related methods
public Window setMinimizeHeight(java.lang.Integer minimizeHeight)
this.defaultMinimizeHeight
Note : This is an advanced setting
minimizeHeight
- New minimizeHeight value. Default value is nullWindow
instance, for chaining setter callsAppearance overview and related methods
public java.lang.Integer getMinimizeHeight()
this.defaultMinimizeHeight
Appearance overview and related methods
public Window setMinimizeTime(java.lang.Integer minimizeTime)
canvas.animationTime
.
Note : This is an advanced setting
minimizeTime
- New minimizeTime value. Default value is nullWindow
instance, for chaining setter callsAppearance overview and related methods
,
Window Minimize Examplepublic java.lang.Integer getMinimizeTime()
canvas.animationTime
.Appearance overview and related methods
,
Window Minimize Examplepublic Canvas getModalMask() throws java.lang.IllegalStateException
showModalMask
to true, add a CSS style "modalMask" to the active
skin (generally with background-color set), and adjust modalMaskOpacity
.
This component is an AutoChild named "modalMask". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.Appearance overview and related methods
public Window setModalMaskOpacity(int modalMaskOpacity) throws java.lang.IllegalStateException
modalMaskOpacity
- New modalMaskOpacity value. Default value is 50Window
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdcom.smartgwt.client.widgets.Window#setModalMask
,
Appearance overview and related methods
public int getModalMaskOpacity()
getModalMask()
,
Appearance overview and related methods
public Window setModalMaskStyle(java.lang.String modalMaskStyle) throws java.lang.IllegalStateException
modalMaskStyle
- New modalMaskStyle value. Default value is "modalMask"Window
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdcom.smartgwt.client.widgets.Window#setModalMask
,
Appearance overview and related methods
public java.lang.String getModalMaskStyle()
getModalMask()
,
Appearance overview and related methods
public Window setOpacity(java.lang.Integer opacity)
In older versions of Internet Explorer (Pre IE9 /
HTML5), opacity is achieved through proprietary filters. If filters have been disabled
within this application developers must set Canvas.useOpacityFilter
to true for specific components on which
opacity support is required.
Also note that opacity is incompatible with backMasks
, and that this property is enabled by default for Window
instances.
Note : This is an advanced setting
setOpacity
in class Canvas
opacity
- New opacity value. Default value is nullWindow
instance, for chaining setter callsCues overview and related methods
public java.lang.Integer getOpacity()
In older versions of Internet Explorer (Pre IE9 /
HTML5), opacity is achieved through proprietary filters. If filters have been disabled
within this application developers must set Canvas.useOpacityFilter
to true for specific components on which
opacity support is required.
Also note that opacity is incompatible with backMasks
, and that this property is enabled by default for Window
instances.
getOpacity
in class Canvas
Cues overview and related methods
public Window setPlacement(PanelPlacement placement) throws java.lang.IllegalStateException
"fillScreen"
,
"fillPanel"
, "halfScreen"
and "none"
If not explicitly specified, default is
to use PanelPlacement
"fillScreen" if isHandset
, and "none" for non-handset devices.
If
window.placement
is something other than "none"
, sizing and positioning settings (either
explicit left, top, width, height settings or the autoCenter
and autoSize
features) will have no effect.
placement
- New placement value. Default value is nullWindow
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic PanelPlacement getPlacement()
"fillScreen"
,
"fillPanel"
, "halfScreen"
and "none"
If not explicitly specified, default is
to use PanelPlacement
"fillScreen" if isHandset
, and "none" for non-handset devices.
If
window.placement
is something other than "none"
, sizing and positioning settings (either
explicit left, top, width, height settings or the autoCenter
and autoSize
features) will have no effect.
public Window setPrintBodyStyle(java.lang.String printBodyStyle) throws java.lang.IllegalStateException
printBodyStyle
- New printBodyStyle value. Default value is "printHeader"Window
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdCSSStyleName
public java.lang.String getPrintBodyStyle()
CSSStyleName
public Window setPrintHeaderStyle(java.lang.String printHeaderStyle) throws java.lang.IllegalStateException
printHeaderStyle
- New printHeaderStyle value. Default value is "printHeader"Window
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdCSSStyleName
public java.lang.String getPrintHeaderStyle()
CSSStyleName
public Window setResizeFrom(EdgeName... resizeFrom)
canDragResize
, restricts
resizes to only certain edges or corners. This property on Window
overrides the
default defined by Canvas.resizeFrom
.
Note : This is an advanced setting
setResizeFrom
in class Canvas
resizeFrom
- New resizeFrom value. Default value is ["R","B","BR"]Window
instance, for chaining setter callsDragdrop overview and related methods
public EdgeName[] getResizeFrom()
canDragResize
, restricts
resizes to only certain edges or corners. This property on Window
overrides the
default defined by Canvas.resizeFrom
.
getResizeFrom
in class Canvas
Dragdrop overview and related methods
public ImgButton getResizer() throws java.lang.IllegalStateException
This component is an AutoChild named "resizer". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public ImgButton getRestoreButton() throws java.lang.IllegalStateException
restore()
.
This component is an AutoChild named "restoreButton". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public Window setShowBody(java.lang.Boolean showBody)
Note : This is an advanced setting
showBody
- New showBody value. Default value is trueWindow
instance, for chaining setter callsAppearance overview and related methods
public java.lang.Boolean getShowBody()
Appearance overview and related methods
public Window setShowCloseButton(java.lang.Boolean showCloseButton)
Window.closeClick()
.
showCloseButton
to show / hide the closeButtonshowCloseButton
- New showCloseButton value. Default value is trueWindow
instance, for chaining setter callsAppearance overview and related methods
public java.lang.Boolean getShowCloseButton()
Window.closeClick()
.Appearance overview and related methods
public Window setShowEdges(java.lang.Boolean showEdges) throws java.lang.IllegalStateException
showEdges
dynamically defaults to false when the placement
setting indicates the Window will be filling a portion of the screen or a panel.setShowEdges
in class Canvas
showEdges
- New showEdges value. Default value is nullWindow
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getShowEdges()
showEdges
dynamically defaults to false when the placement
setting indicates the Window will be filling a portion of the screen or a panel.getShowEdges
in class Canvas
public Window setShowFooter(java.lang.Boolean showFooter)
showFooter
- New showFooter value. Default value is trueWindow
instance, for chaining setter callsAppearance overview and related methods
,
Footer Examplepublic java.lang.Boolean getShowFooter()
Appearance overview and related methods
,
Footer Examplepublic Window setShowHeader(java.lang.Boolean showHeader) throws java.lang.IllegalStateException
header
for this Window.
Note that in certain Smartclient skins showHeaderBackground
may be set to
false
and the header's appearance implemented as part of the
window's edge media
. In this case suppressing the header can be
achieved
by overriding the edge media as well as setting this property to false. For example, to
create a headerless window with a similar appearance to a Menu
in the
TreeFrog
skin, the following attributes could be used:
showHeader:false, edgeImage:"[SKIN]/Menu/m.png", edgeSize:10, edgeTop:17, edgeBottom:17, edgeCenterBackgroundColor:"#F7F7F7"
showHeader
- New showHeader value. Default value is trueWindow
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdAppearance overview and related methods
public java.lang.Boolean getShowHeader()
header
for this Window.
Note that in certain Smartclient skins showHeaderBackground
may be set to
false
and the header's appearance implemented as part of the
window's edge media
. In this case suppressing the header can be
achieved
by overriding the edge media as well as setting this property to false. For example, to
create a headerless window with a similar appearance to a Menu
in the
TreeFrog
skin, the following attributes could be used:
showHeader:false, edgeImage:"[SKIN]/Menu/m.png", edgeSize:10, edgeTop:17, edgeBottom:17, edgeCenterBackgroundColor:"#F7F7F7"
Appearance overview and related methods
public Window setShowHeaderBackground(java.lang.Boolean showHeaderBackground) throws java.lang.IllegalStateException
headerSrc
and hiliteHeaderSrc
, otherwise the background
will be styled according to headerStyle
/ hiliteHeaderStyle
.
Note : This is an advanced setting
showHeaderBackground
- New showHeaderBackground value. Default value is variesWindow
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdAppearance overview and related methods
public java.lang.Boolean getShowHeaderBackground()
headerSrc
and hiliteHeaderSrc
, otherwise the background
will be styled according to headerStyle
/ hiliteHeaderStyle
.Appearance overview and related methods
public Window setShowHeaderIcon(java.lang.Boolean showHeaderIcon)
showHeaderIcon
to show / hide the headerIconshowHeaderIcon
- New showHeaderIcon value. Default value is trueWindow
instance, for chaining setter callsAppearance overview and related methods
public java.lang.Boolean getShowHeaderIcon()
Appearance overview and related methods
public Window setShowMaximizeButton(java.lang.Boolean showMaximizeButton)
showMaximizeButton
to show / hide the maximizeButtonshowMaximizeButton
- New showMaximizeButton value. Default value is falseWindow
instance, for chaining setter callsAppearance overview and related methods
public java.lang.Boolean getShowMaximizeButton()
Appearance overview and related methods
public Window setShowMinimizeButton(java.lang.Boolean showMinimizeButton)
showMinimizeButton
to show / hide the minimizeButtonshowMinimizeButton
- New showMinimizeButton value. Default value is trueWindow
instance, for chaining setter callsAppearance overview and related methods
public java.lang.Boolean getShowMinimizeButton()
Appearance overview and related methods
public Window setShowModalMask(java.lang.Boolean showModalMask) throws java.lang.IllegalStateException
showModalMask
- New showModalMask value. Default value is nullWindow
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdcom.smartgwt.client.widgets.Window#setModalMask
,
Appearance overview and related methods
public java.lang.Boolean getShowModalMask()
getModalMask()
,
Appearance overview and related methods
public Window setShowResizer(java.lang.Boolean showResizer)
showFooter
) and canDragResize
is true.showResizer
- New showResizer value. Default value is trueWindow
instance, for chaining setter callsAppearance overview and related methods
public java.lang.Boolean getShowResizer()
showFooter
) and canDragResize
is true.Appearance overview and related methods
public Window setShowShadow(java.lang.Boolean showShadow) throws java.lang.IllegalStateException
Developers should be aware that the drop shadow is drawn outside the specified width and height of the widget meaning a widget with shadows takes up a little more space than it otherwise would. A full screen canvas with showShadow set to true as this would be likely to cause browser scrollbars to appear - developers can handle this by either setting this property to false on full-screen widgets, or by setting overflow to "hidden" on the <body> element browser-level scrolling is never intended to occur.
showShadow
dynamically defaults to false when the placement
setting
indicates the Window will be filling a portion of the screen or a panel.
setShowShadow
in class Canvas
showShadow
- New showShadow value. Default value is nullWindow
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getShowShadow()
Developers should be aware that the drop shadow is drawn outside the specified width and height of the widget meaning a widget with shadows takes up a little more space than it otherwise would. A full screen canvas with showShadow set to true as this would be likely to cause browser scrollbars to appear - developers can handle this by either setting this property to false on full-screen widgets, or by setting overflow to "hidden" on the <body> element browser-level scrolling is never intended to occur.
showShadow
dynamically defaults to false when the placement
setting
indicates the Window will be filling a portion of the screen or a panel.
getShowShadow
in class Canvas
public Window setShowStatusBar(java.lang.Boolean showStatusBar)
showFooter
).showStatusBar
- New showStatusBar value. Default value is trueWindow
instance, for chaining setter callsAppearance overview and related methods
public java.lang.Boolean getShowStatusBar()
showFooter
).Appearance overview and related methods
public Window setShowTitle(java.lang.Boolean showTitle)
title
is shown in the header
. No impact unless the header is being shown. The header will be redrawn if necessary.showTitle
- new showTitle. Default value is trueWindow
instance, for chaining setter callsAppearance overview and related methods
public java.lang.Boolean getShowTitle()
Appearance overview and related methods
public Window setSrc(java.lang.String src)
Note that setting window.src is essentially a shortcut for setting items
to a single HTMLflow with a specified contentsURL
.
If this method is called after the component has been drawn/initialized:
Sets the URL of the contents to display in the body of the window, redrawing if necessary.
src
- URL of new contents to be displayed in the window body. Default value is nullWindow
instance, for chaining setter callssetContentsType(java.lang.String)
,
Appearance overview and related methods
public java.lang.String getSrc()
Note that setting window.src is essentially a shortcut for setting items
to a single HTMLflow with a specified contentsURL
.
getContentsType()
,
Appearance overview and related methods
public Window setStatus(java.lang.String status)
status
- new text for the status bar. Default value is nullWindow
instance, for chaining setter callsAppearance overview and related methods
public java.lang.String getStatus()
Appearance overview and related methods
public Canvas getStatusBar() throws java.lang.IllegalStateException
setStatus()
can be used to show text here.
This component is an AutoChild named "statusBar". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setTitle(java.lang.String title)
showTitle
is true in the header
(if drawn).
title
that appears in the window header
. The header will be redrawn if necessary.setTitle
in class Canvas
title
- new title. Default value is "Untitled Window"HTMLString
,
Appearance overview and related methods
public java.lang.String getTitle()
getTitle
in class Canvas
HTMLString
,
Appearance overview and related methods
public Window setUseBackMask(java.lang.Boolean useBackMask) throws java.lang.IllegalStateException
backMask
in Internet Explorer
versions predating Internet Explorer 9. This is a workaround for a native browser issue whereby certain DOM elements
such as IFRAME
s (whether rendered within Smart GWT components via features such as contentsURL
or explicitly written into the HTML of the page) will
not be properly occluded by DOM elements which overlap them but have a higher z-index. A side-effect of this is that
the opacity
can not be modified for the entire window. Developers
may disable the backmask in order to support opacity in IE versions less than 9 by setting this property to false,
however you should be aware that in doing this there is a potential for the "burn through" problem described above.
Note : This is an advanced setting
setUseBackMask
in class Canvas
useBackMask
- New useBackMask value. Default value is variesWindow
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getUseBackMask()
backMask
in Internet Explorer
versions predating Internet Explorer 9. This is a workaround for a native browser issue whereby certain DOM elements
such as IFRAME
s (whether rendered within Smart GWT components via features such as contentsURL
or explicitly written into the HTML of the page) will
not be properly occluded by DOM elements which overlap them but have a higher z-index. A side-effect of this is that
the opacity
can not be modified for the entire window. Developers
may disable the backmask in order to support opacity in IE versions less than 9 by setting this property to false,
however you should be aware that in doing this there is a potential for the "burn through" problem described above.
getUseBackMask
in class Canvas
public void addMember(Canvas newMember)
Layout.addMember()
. Note that in order to add items
to body
, you use addItem()
rather than addMember
. Adding a member to a Window adds the member as a sibling to the header,
body and other built-in Window subcomponents.addMember
in class Layout
newMember
- the canvas object to be added to the layoutLayout.addMembers(java.lang.Object[], int)
public void addMember(Canvas newMember, java.lang.Integer position)
Layout.addMember()
. Note that in order to add items
to body
, you use addItem()
rather than addMember
. Adding a member to a Window adds the member as a sibling to the header,
body and other built-in Window subcomponents.newMember
- the canvas object to be added to the layoutposition
- the position in the layout to place newMember (starts with 0); if omitted, it will be added
at the last positionLayout.addMembers(java.lang.Object[], int)
public void centerInPage()
public void close()
Window.closeClick()
implementation. Default implementation will hide the window.public com.google.gwt.event.shared.HandlerRegistration addCloseClickHandler(CloseClickHandler handler)
Handles a click on the close button of this window. The default implementation calls close()
and returns false to prevent bubbling of the click event.
Developers may use addCloseClickHandler()
to provide custom handling when the user clicks this button.
Custom implementations may call close()
to trigger the default behavior.
addCloseClickHandler
in interface HasCloseClickHandlers
handler
- the closeClick handlerHandlerRegistration
used to remove this handlerpublic void flash()
This method is executed when users click outside the bounds of a modal window so they'll notice that they have to do something with the window.
public void maximize()
this.showMaximizeButton
is true.0, 0
and resizes the window to "100%"
on both axes, so it will fill the
browser window (or the parent of the Window instance, if appropriate).animateMinimize
is true, the maximize will be animated. A restore
button will be displayed in place of the maximize button when the window is maximized.public void minimize()
this.showMinimizeButton
is true.animateMinimize
is true, the resize will be animated. A restore
button will be displayed in place of the minimize button when the window is minimized.public com.google.gwt.event.shared.HandlerRegistration addMaximizeClickHandler(MaximizeClickHandler handler)
Notification method fired when the user clicks the 'maximize' button.
addMaximizeClickHandler
in interface HasMaximizeClickHandlers
handler
- the maximizeClick handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addMinimizeClickHandler(MinimizeClickHandler handler)
Notification method fired when the user clicks the 'minimize' button.
addMinimizeClickHandler
in interface HasMinimizeClickHandlers
handler
- the minimizeClick handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addRestoreClickHandler(RestoreClickHandler handler)
Notification method fired when the user clicks the 'restore' button.
addRestoreClickHandler
in interface HasRestoreClickHandlers
handler
- the restoreClick handlerHandlerRegistration
used to remove this handlerpublic void restore()
minimize()
or maximize()
. Called from a click on the restore
button shown in place of the minimize or maximize button when the window is minimized or maximized.animateMinimize
is true.public java.lang.Boolean shouldDismissOnEscape()
dismissOnEscape
is set, just
return it. Otherwise return true if this window is showing a "close" control in the header (see headerControls
).public static void setDefaultProperties(Window windowProperties)
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.
windowProperties
- properties that should be used as new defaults when instances of this class are createdSGWTProperties
public void addItem(com.google.gwt.user.client.ui.Widget widget)
widget
- the widget to be addedpublic void addItem(Canvas component)
component
- the widget to be addedpublic void removeItem(Canvas component)
component
- the widget to be removedpublic Window setKeepInParentRect(java.lang.Boolean keepInParentRect)
setKeepInParentRect
in class Canvas
keepInParentRect
- true to keepInParentRectWindow
instance, for chaining setter
callsDragdrop overview and related methods
,
Drag create Examplepublic void setHeaderIconProperties(java.util.Map headerIconProperties)
public void setHeaderIcon(java.lang.String imgSrc)
imgSrc
- the icon image sourcepublic void setHeaderIcon(java.lang.String imgSrc, int width, int height)
imgSrc
- the icon image sourcewidth
- the icon width. default 16height
- the icon height. default 14public void setHeaderControls(java.lang.Object... headerControls)
HeaderControls
listing the standard header controls in their default order: headerControls
- an array containing either HeaderControl enums values or Canvas instancesHeaderControls
public void setFooterControls(java.lang.Object... footerControls)
FooterControls
listing the standard footer controls in their default order: footerControls
- an array containing either FooterControl enums values or Canvas instancesFooterControls
public Window setKeepInParentRect(Rectangle rectangle)
setKeepInParentRect
in class Canvas
rectangle
- the rectangle boundsWindow
instance, for chaining setter
callspublic Canvas[] getItems()
public static void preloadImages()
public void setContentLayout(java.lang.String contentLayout)
setContentLayout()
Valid values are "vertical", "horizontal", or "none". If the body is a Layout, this
controls how the items are stacked in the body by setting Layout.vertical
. See bodyConstructor
for details.
Note : This is an advanced setting
contentLayout
- Default value is "vertical"Appearance overview and related methods
public void revealChild(java.lang.String childID)
revealChild
in class Layout
childID
- the global ID of the child Canvas to revealpublic void revealChild(Canvas child)
revealChild
in class Layout
child
- the child Canvas to revealpublic com.smartgwt.logicalstructure.core.LogicalStructureObject setLogicalStructure(com.smartgwt.logicalstructure.widgets.WindowLogicalStructure s)
LogicalStructure
interface,
which supports Eclipse's logical structure debugging facility.public com.smartgwt.logicalstructure.core.LogicalStructureObject getLogicalStructure()
LogicalStructure
interface,
which supports Eclipse's logical structure debugging facility.getLogicalStructure
in interface LogicalStructure
getLogicalStructure
in class VLayout