com.smartgwt.client.widgets

Class StretchImg

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.StatefulCanvas

com.smartgwt.client.widgets.StretchImg

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

Direct Known Subclasses:

Progressbar, Scrollbar, Splitbar, StretchImgButton

public class StretchImg
extends StatefulCanvas

The StretchImg widget class implements a widget type that displays a list of multiple images that make up a single image.

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
StretchImg()
StretchImg(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()
int	getCapSize() If the default items are used, capSize is the size in pixels of the first and last images in this stretchImg.
java.lang.String	getGripImgSuffix() Suffix used the 'grip' image if showGrip is true.
java.lang.String	getHSrc() Base URL for the image if vertical is false and src is unset.
boolean	getIgnoreRTL() Should the items for this StretchImg display left-to-right even if this page is displaying right to left text?
ImageStyle	getImageType() Indicates whether the image should be tiled/cropped, stretched, or centered when the size of this widget does not match the size of the image.
java.lang.String	getItemBaseStyle() If specified this css class will be applied to the individual item images within this StretchImg.
StretchItem[]	getItems() The list of images to display as an array of objects specifying the image names and sizes.
com.smartgwt.logicalstructure.core.LogicalStructureObject	getLogicalStructure() Getter implementing the LogicalStructure interface, which supports Eclipse's logical structure debugging facility.
static StretchImg	getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)
java.lang.Boolean	getShowDownGrip() If showGrip is true, this property determines whether to show the 'Down' state on the grip image when the user mousedown's on this widget.
java.lang.Boolean	getShowGrip() Should we show a "grip" image floating above the center of this widget?
java.lang.Boolean	getShowRollOverGrip() If showGrip is true, this property determines whether to show the 'Over' state on the grip image when the user rolls over on this widget.
java.lang.Boolean	getShowTitle() Determines whether any specified title will be displayed for this component. Applies to Image-based components only, where the title will be rendered out in a label floating over the component
java.lang.String	getSrc() The base URL for the image.
java.lang.Boolean	getVertical() Indicates whether the list of images is drawn vertically from top to bottom (true), or horizontally from left to right (false).
java.lang.String	getVSrc() Base URL for the image if vertical is true and src is unset.
void	setCapSize(int capSize) If the default items are used, capSize is the size in pixels of the first and last images in this stretchImg.
static void	setDefaultProperties(StretchImg stretchImgProperties) Class level method to set the default properties of this class.
void	setGripImgSuffix(java.lang.String gripImgSuffix) Suffix used the 'grip' image if showGrip is true.
void	setHSrc(java.lang.String hSrc) Base URL for the image if vertical is false and src is unset.
void	setIgnoreRTL(boolean ignoreRTL) Should the items for this StretchImg display left-to-right even if this page is displaying right to left text?
void	setImageType(ImageStyle imageType) Indicates whether the image should be tiled/cropped, stretched, or centered when the size of this widget does not match the size of the image.
void	setItemBaseStyle(java.lang.String itemBaseStyle) If specified this css class will be applied to the individual item images within this StretchImg.
void	setItems(StretchItem... items) The list of images to display as an array of objects specifying the image names and sizes.
com.smartgwt.logicalstructure.core.LogicalStructureObject	setLogicalStructure(com.smartgwt.logicalstructure.widgets.StretchImgLogicalStructure s) Setter implementing the LogicalStructure interface, which supports Eclipse's logical structure debugging facility.
void	setShowDownGrip(java.lang.Boolean showDownGrip) If showGrip is true, this property determines whether to show the 'Down' state on the grip image when the user mousedown's on this widget.
void	setShowGrip(java.lang.Boolean showGrip) Should we show a "grip" image floating above the center of this widget?
void	setShowRollOverGrip(java.lang.Boolean showRollOverGrip) If showGrip is true, this property determines whether to show the 'Over' state on the grip image when the user rolls over on this widget.
void	setShowTitle(java.lang.Boolean showTitle) Determines whether any specified title will be displayed for this component. Applies to Image-based components only, where the title will be rendered out in a label floating over the component
void	setSrc(java.lang.String src) The base URL for the image.
void	setState(java.lang.String newState) Set the specified image's state to newState and update the displayed image given by whichPart, or set the state for all images to newState and update the displayed images if whichPart is not provided.
void	setState(java.lang.String newState, java.lang.String whichPart) Set the specified image's state to newState and update the displayed image given by whichPart, or set the state for all images to newState and update the displayed images if whichPart is not provided.
void	setVertical(java.lang.Boolean vertical) Indicates whether the list of images is drawn vertically from top to bottom (true), or horizontally from left to right (false).
void	setVSrc(java.lang.String vSrc) Base URL for the image if vertical is true and src is unset.

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

addToRadioGroup, deselect, getActionType, getAlign, getAutoFit, getBaseStyle, getEditProxyConstructor, getIcon, getIconHeight, getIconOrientation, getIconSize, getIconStyle, getIconWidth, getLabelHPad, getLabelVPad, getOverCanvas, getOverCanvasConstructor, getRadioGroup, getRedrawOnStateChange, getSelected, getShowDisabled, getShowDisabledIcon, getShowDown, getShowDownIcon, getShowFocused, getShowFocusedAsOver, getShowFocusedIcon, getShowOverCanvas, getShowRollOver, getShowRollOverIcon, getShowRTLIcon, getShowSelectedIcon, getState, getStateSuffix, getTitle, getValign, isSelected, removeFromRadioGroup, removeFromRadioGroup, select, setActionType, setAlign, setAutoFit, setBaseStyle, setDefaultProperties, setEditProxyConstructor, setIcon, setIconHeight, setIconOrientation, setIconSize, setIconStyle, setIconWidth, setLabelHPad, setLabelVPad, setLogicalStructure, setOverCanvasConstructor, setRadioGroup, setRedrawOnStateChange, setSelected, setShowDisabled, setShowDisabledIcon, setShowDown, setShowDownIcon, setShowFocused, setShowFocusedAsOver, setShowFocusedIcon, setShowOverCanvas, setShowRollOver, setShowRollOverIcon, setShowRTLIcon, setShowSelectedIcon, setState, setTitle, setTitleFormatter, setTitleStyle, setValign

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, getCanDragReposition, getCanDragResize, getCanDragScroll, getCanDrop, getCanDropBefore, getCanFocus, getCanHover, getCanSelectText, getCanvasAutoChild, getCanvasItem, getChildren, getChildrenResizeSnapAlign, getChildrenSnapAlign, getChildrenSnapCenterAlign, getChildrenSnapEdgeAlign, getChildrenSnapResizeToGrid, getChildrenSnapToGrid, getChildTabPosition, 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, getOpacity, getOuterElement, getOverflow, getPadding, getPageBottom, getPageLeft, getPageRect, getPageRight, getPageTop, getPaletteDefaults, getPanelContainer, getParentCanvas, getParentElement, getPeers, getPercentBox, getPercentSource, getPosition, getPrefix, getPrintChildrenAbsolutelyPositioned, getPrintHTML, getPrintHTML, getPrompt, getProportionalResizeModifiers, getProportionalResizing, getRect, getRedrawOnResize, getResizeBarTarget, getResizeFrom, getRight, getRuleContext, getRuleContext, getRuleScope, getScrollbarSize, getScrollBottom, getScrollHeight, getScrollLeft, getScrollRight, getScrollTop, getScrollWidth, getShadowColor, getShadowDepth, getShadowHOffset, getShadowImage, getShadowOffset, getShadowSoftness, getShadowSpread, getShadowVOffset, getShouldPrint, getShowCustomScrollbars, getShowDragShadow, getShowEdges, getShowHover, getShowHoverComponents, getShowResizeBar, getShowShadow, 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, getUseBackMask, 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, onInit, 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, revealChild, revealChild, 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, setCanDragReposition, setCanDragResize, 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, setKeepInParentRect, 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, setOpacity, setOverflow, setPadding, setPageLeft, setPageTop, setPanelContainer, setParentCanvas, setParentElement, setPeers, setPercentBox, setPercentSource, setPosition, setPrefix, setPrintChildrenAbsolutelyPositioned, setPrompt, setProportionalResizeModifiers, setProportionalResizing, setRect, setRect, setRedrawOnResize, setRelativeTabPosition, setResizeBarTarget, setResizeFrom, setResizeFrom, setRight, setRuleScope, setScrollbarConstructor, setScrollbarSize, setShadowColor, setShadowDepth, setShadowHOffset, setShadowImage, setShadowOffset, setShadowSoftness, setShadowSpread, setShadowVOffset, setShouldPrint, setShowCustomScrollbars, setShowDragShadow, setShowEdges, setShowHover, setShowHoverComponents, setShowResizeBar, setShowShadow, 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, setUseBackMask, 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

StretchImg

public StretchImg()

StretchImg

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

Method Detail

getOrCreateRef

public static StretchImg 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 StatefulCanvas

setCapSize

public void setCapSize(int capSize)

If the default items are used, capSize is the size in pixels of the first and last images in this stretchImg.

Parameters:

capSize - New capSize value. Default value is 2

See Also:

Appearance overview and related methods

getCapSize

public int getCapSize()

If the default items are used, capSize is the size in pixels of the first and last images in this stretchImg.

Returns:

Current capSize value. Default value is 2

See Also:

Appearance overview and related methods

setGripImgSuffix

public void setGripImgSuffix(java.lang.String gripImgSuffix)
                      throws java.lang.IllegalStateException

Suffix used the 'grip' image if showGrip is true.

Note : This is an advanced setting

Parameters:

gripImgSuffix - New gripImgSuffix value. Default value is "grip"

Throws:

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

getGripImgSuffix

public java.lang.String getGripImgSuffix()

Suffix used the 'grip' image if showGrip is true.

Returns:

Current gripImgSuffix value. Default value is "grip"

setHSrc

public void setHSrc(java.lang.String hSrc)

Base URL for the image if vertical is false and src is unset.

Parameters:

hSrc - New hSrc value. Default value is null

See Also:

setSrc(java.lang.String), setVSrc(java.lang.String), SCImgURL, Appearance overview and related methods

getHSrc

public java.lang.String getHSrc()

Base URL for the image if vertical is false and src is unset.

Returns:

Current hSrc value. Default value is null

See Also:

getSrc(), getVSrc(), SCImgURL, Appearance overview and related methods

setIgnoreRTL

public void setIgnoreRTL(boolean ignoreRTL)

Should the items for this StretchImg display left-to-right even if this page is displaying right to left text?

Only has an effect if this StretchImg is horizontal (vertical is set to false).

Having this property set to true is usually desirable for the common pattern of media consisting of fixed size "end caps" and a stretchable center, because it allows the same media to be used for LTR and RTL pages.

If set to false, items will be displayed in RTL order for RTL pages.

If this method is called after the component has been drawn/initialized: Setter for ignoreRTL.

Overrides:

setIgnoreRTL in class StatefulCanvas

Parameters:

ignoreRTL - new value for ignoreRTL. Default value is true

See Also:

Appearance overview and related methods

getIgnoreRTL

public boolean getIgnoreRTL()

Should the items for this StretchImg display left-to-right even if this page is displaying right to left text?

Only has an effect if this StretchImg is horizontal (vertical is set to false).

Having this property set to true is usually desirable for the common pattern of media consisting of fixed size "end caps" and a stretchable center, because it allows the same media to be used for LTR and RTL pages.

If set to false, items will be displayed in RTL order for RTL pages.

Overrides:

getIgnoreRTL in class StatefulCanvas

Returns:

Current ignoreRTL value. Default value is true

See Also:

Appearance overview and related methods

setImageType

public void setImageType(ImageStyle imageType)

Indicates whether the image should be tiled/cropped, stretched, or centered when the size of this widget does not match the size of the image. See ImageStyle for details.

Parameters:

imageType - New imageType value. Default value is Img.STRETCH

See Also:

Appearance overview and related methods

getImageType

public ImageStyle getImageType()

Indicates whether the image should be tiled/cropped, stretched, or centered when the size of this widget does not match the size of the image. See ImageStyle for details.

Returns:

Current imageType value. Default value is Img.STRETCH

See Also:

Appearance overview and related methods

setItemBaseStyle

public void setItemBaseStyle(java.lang.String itemBaseStyle)

If specified this css class will be applied to the individual item images within this StretchImg. May be overridden by specifying item-specific base styles to each object in the items array. This base style will have standard stateful suffixes appended to indicate the state of this component (as described in StatefulCanvas.baseStyle).

Parameters:

itemBaseStyle - New itemBaseStyle value. Default value is null

See Also:

CSSStyleName

getItemBaseStyle

public java.lang.String getItemBaseStyle()

If specified this css class will be applied to the individual item images within this StretchImg. May be overridden by specifying item-specific base styles to each object in the items array. This base style will have standard stateful suffixes appended to indicate the state of this component (as described in StatefulCanvas.baseStyle).

Returns:

Current itemBaseStyle value. Default value is null

See Also:

CSSStyleName

setItems

public void setItems(StretchItem... items)

The list of images to display as an array of objects specifying the image names and sizes.

The name is appended as a suffix to the src URL in order to fetch separate media files for each image. Alternatively a StretchItem may specify its own src.

The height and width can be set to a number, "*" (remaining space, divided amongst all images that specify "*") or to the name of a property on this StretchImg component, such as "capSize" for the capSize.

Height or width is only used for the axis along which images are stacked. For example, if vertical is true, images stack vertically and heights are used to size images on the vertical axis, but all images will have width matching the overall component size.

For example, the default setting for items, which is used to produce stretchable buttons and headers with fixed-size endcaps, is as follows:

    new StretchItem[] {
        new StretchItem("start", "capSize", "capSize"),
        new StretchItem("stretch", "*", "*"),
        new StretchItem("end", "capSize", "capSize")
    };
  

Note that by default horizontal StretchImg instances will always render their items in left-to-right order, even if the page is localized for right-to-left display (see Page.isRTL()). This default behavior may be overridden by setting the ignoreRTL flag to false.

If this method is called after the component has been drawn/initialized: Setter for items.

Parameters:

items - the new array of items. Default value is see below

See Also:

Appearance overview and related methods

getItems

public StretchItem[] getItems()

The list of images to display as an array of objects specifying the image names and sizes.

The name is appended as a suffix to the src URL in order to fetch separate media files for each image. Alternatively a StretchItem may specify its own src.

The height and width can be set to a number, "*" (remaining space, divided amongst all images that specify "*") or to the name of a property on this StretchImg component, such as "capSize" for the capSize.

Height or width is only used for the axis along which images are stacked. For example, if vertical is true, images stack vertically and heights are used to size images on the vertical axis, but all images will have width matching the overall component size.

For example, the default setting for items, which is used to produce stretchable buttons and headers with fixed-size endcaps, is as follows:

    new StretchItem[] {
        new StretchItem("start", "capSize", "capSize"),
        new StretchItem("stretch", "*", "*"),
        new StretchItem("end", "capSize", "capSize")
    };
  

Note that by default horizontal StretchImg instances will always render their items in left-to-right order, even if the page is localized for right-to-left display (see Page.isRTL()). This default behavior may be overridden by setting the ignoreRTL flag to false.

Returns:

Current items value. Default value is see below

See Also:

Appearance overview and related methods

setShowDownGrip

public void setShowDownGrip(java.lang.Boolean showDownGrip)
                     throws java.lang.IllegalStateException

If showGrip is true, this property determines whether to show the 'Down' state on the grip image when the user mousedown's on this widget. Has no effect if StatefulCanvas.showDown is false.

Note : This is an advanced setting

Parameters:

showDownGrip - New showDownGrip value. Default value is null

Throws:

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

getShowDownGrip

public java.lang.Boolean getShowDownGrip()

If showGrip is true, this property determines whether to show the 'Down' state on the grip image when the user mousedown's on this widget. Has no effect if StatefulCanvas.showDown is false.

Returns:

Current showDownGrip value. Default value is null

setShowGrip

public void setShowGrip(java.lang.Boolean showGrip)
                 throws java.lang.IllegalStateException

Should we show a "grip" image floating above the center of this widget?

Note : This is an advanced setting

Parameters:

showGrip - New showGrip value. Default value is null

Throws:

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

getShowGrip

public java.lang.Boolean getShowGrip()

Should we show a "grip" image floating above the center of this widget?

Returns:

Current showGrip value. Default value is null

setShowRollOverGrip

public void setShowRollOverGrip(java.lang.Boolean showRollOverGrip)
                         throws java.lang.IllegalStateException

If showGrip is true, this property determines whether to show the 'Over' state on the grip image when the user rolls over on this widget. Has no effect if StatefulCanvas.showRollOver is false.

Note : This is an advanced setting

Parameters:

showRollOverGrip - New showRollOverGrip value. Default value is null

Throws:

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

getShowRollOverGrip

public java.lang.Boolean getShowRollOverGrip()

If showGrip is true, this property determines whether to show the 'Over' state on the grip image when the user rolls over on this widget. Has no effect if StatefulCanvas.showRollOver is false.

Returns:

Current showRollOverGrip value. Default value is null

setShowTitle

public void setShowTitle(java.lang.Boolean showTitle)

Determines whether any specified title will be displayed for this component.
Applies to Image-based components only, where the title will be rendered out in a label floating over the component

Note : This is an advanced setting

Parameters:

showTitle - New showTitle value. Default value is false

getShowTitle

public java.lang.Boolean getShowTitle()

Determines whether any specified title will be displayed for this component.
Applies to Image-based components only, where the title will be rendered out in a label floating over the component

Returns:

Current showTitle value. Default value is false

setSrc

public void setSrc(java.lang.String src)

The base URL for the image.

The State for the component will be combined with this URL using the same approach as described in Img.src. Then the image segment name as specified by each StretchItem is added.

For example, for a stretchImg in "Over" state with a src of "button.png" and a segment name of "stretch", the resulting URL would be "button_Over_stretch.png".

If this method is called after the component has been drawn/initialized: Changes the base src for this stretchImg, redrawing if necessary.

Parameters:

src - new URL for the image. Default value is null

See Also:

setHSrc(java.lang.String), setVSrc(java.lang.String), SCImgURL, Appearance overview and related methods

getSrc

public java.lang.String getSrc()

The base URL for the image.

The State for the component will be combined with this URL using the same approach as described in Img.src. Then the image segment name as specified by each StretchItem is added.

For example, for a stretchImg in "Over" state with a src of "button.png" and a segment name of "stretch", the resulting URL would be "button_Over_stretch.png".

Returns:

Current src value. Default value is null

See Also:

getHSrc(), getVSrc(), SCImgURL, Appearance overview and related methods

setVertical

public void setVertical(java.lang.Boolean vertical)

Indicates whether the list of images is drawn vertically from top to bottom (true), or horizontally from left to right (false).

Parameters:

vertical - New vertical value. Default value is true

See Also:

Appearance overview and related methods

getVertical

public java.lang.Boolean getVertical()

Indicates whether the list of images is drawn vertically from top to bottom (true), or horizontally from left to right (false).

Returns:

Current vertical value. Default value is true

See Also:

Appearance overview and related methods

setVSrc

public void setVSrc(java.lang.String vSrc)

Base URL for the image if vertical is true and src is unset.

Parameters:

vSrc - New vSrc value. Default value is null

See Also:

setSrc(java.lang.String), setVSrc(java.lang.String), SCImgURL, Appearance overview and related methods

getVSrc

public java.lang.String getVSrc()

Base URL for the image if vertical is true and src is unset.

Returns:

Current vSrc value. Default value is null

See Also:

getSrc(), getVSrc(), SCImgURL, Appearance overview and related methods

setState

public void setState(java.lang.String newState)

Set the specified image's state to newState and update the displayed image given by whichPart, or set the state for all images to newState and update the displayed images if whichPart is not provided.

Parameters:

newState - name for the new state ("off", "down", etc)

See Also:

Appearance overview and related methods

setState

public void setState(java.lang.String newState,
                     java.lang.String whichPart)

Set the specified image's state to newState and update the displayed image given by whichPart, or set the state for all images to newState and update the displayed images if whichPart is not provided.

Parameters:

newState - name for the new state ("off", "down", etc)

whichPart - name of the piece to set ("start", "stretch" or "end") if not specified, sets them all

See Also:

Appearance overview and related methods

setDefaultProperties

public static void setDefaultProperties(StretchImg stretchImgProperties)

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:

stretchImgProperties - 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.StretchImgLogicalStructure 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 StatefulCanvas