public class Canvas extends BaseWidget implements HasClickHandlers, HasDoubleClickHandlers, HasDragMoveHandlers, HasDragRepositionMoveHandlers, HasDragRepositionStartHandlers, HasDragRepositionStopHandlers, HasDragResizeMoveHandlers, HasDragResizeStartHandlers, HasDragResizeStopHandlers, HasDragStartHandlers, HasDragStopHandlers, HasDropMoveHandlers, HasDropOutHandlers, HasDropOverHandlers, HasFocusChangedHandlers, HasHoverHandlers, HasHoverHiddenHandlers, HasKeyDownHandlers, HasKeyPressHandlers, HasMouseDownHandlers, HasMouseMoveHandlers, HasMouseOutHandlers, HasMouseOverHandlers, HasMouseStillDownHandlers, HasMouseUpHandlers, HasMouseWheelHandlers, HasMovedHandlers, HasClearHandlers, HasDropHandlers, HasParentMovedHandlers, HasResizedHandlers, HasRightMouseDownHandlers, HasRuleContextChangedHandlers, HasScrolledHandlers, HasShowContextMenuHandlers, HasVisibilityChangedHandlers
FormItems
). Canvas provides:
draw()
and clear()
,
visibility via show()
and hide()
, z-layering via bringToFront()
and sendToBack()
. positioning
, sizing
and size
detection
, with automatic compensation for browser CSS behavior
differences
. overflow
key
and mouse
events, including mapping touch events
to mouse events moving
, resizing
, drag scrolling
and snap-to-grid
behavior. HTML content
or contain other Canvases
, including an edge-based positioning
and percent sizing system
for children. For more advanced layout
capabilities, see Layout
. cursors
, modal masking
, animation
, accessibility properties
, and settings
for automated testing
. config, configOnly, factoryCreated, factoryProperties, id, nativeObject, scClassName
Constructor and Description |
---|
Canvas() |
Canvas(com.google.gwt.core.client.JavaScriptObject jsObj) |
Canvas(java.lang.String id) |
Modifier and Type | Method and Description |
---|---|
Canvas |
addChild(Canvas newChild)
Adds newChild as a child of this widget, set up a named object reference (i.e., this[name]) to the new widget if name
argument is provided, and draw the child if this widget has been drawn already.
|
Canvas |
addChild(Canvas newChild,
java.lang.String name) |
Canvas |
addChild(Canvas newChild,
java.lang.String name,
boolean autoDraw)
Adds newChild as a child of this widget, set up a named object reference (i.e., this[name]) to the new widget if name
argument is provided, and draw the child if this widget has been drawn already.
|
Canvas |
addChild(Canvas newChild,
java.lang.String name,
java.lang.Boolean autoDraw)
Adds newChild as a child of this widget, set up a named object reference (i.e., this[name]) to the new widget if name
argument is provided, and draw the child if this widget has been drawn already.
|
void |
addChild(com.google.gwt.user.client.ui.Widget widget)
Adds newChild as a child of this widget, set up a named object reference (i.e., this[name]) to the new widget if
name argument is provided, and draw the child if this widget has been drawn already.
|
com.google.gwt.event.shared.HandlerRegistration |
addClearHandler(ClearHandler handler)
Add a clear handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addClickHandler(ClickHandler handler)
Add a click handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDoubleClickHandler(DoubleClickHandler handler)
Add a doubleClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDragMoveHandler(DragMoveHandler handler)
Add a dragMove handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDragRepositionMoveHandler(DragRepositionMoveHandler handler)
Add a dragRepositionMove handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDragRepositionStartHandler(DragRepositionStartHandler handler)
Add a dragRepositionStart handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDragRepositionStopHandler(DragRepositionStopHandler handler)
Add a dragRepositionStop handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDragResizeMoveHandler(DragResizeMoveHandler handler)
Add a dragResizeMove handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDragResizeStartHandler(DragResizeStartHandler handler)
Add a dragResizeStart handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDragResizeStopHandler(DragResizeStopHandler handler)
Add a dragResizeStop handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDragStartHandler(DragStartHandler handler)
Add a dragStart handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDragStopHandler(DragStopHandler handler)
Add a dragStop handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDropHandler(DropHandler handler)
Add a drop handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDropMoveHandler(DropMoveHandler handler)
Add a dropMove handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDropOutHandler(DropOutHandler handler)
Add a dropOut handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDropOverHandler(DropOverHandler handler)
Add a dropOver handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addFocusChangedHandler(FocusChangedHandler handler)
Add a focusChanged handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addHoverHandler(HoverHandler handler)
Add a hover handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addHoverHiddenHandler(HoverHiddenHandler handler)
Add a hoverHidden handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addKeyDownHandler(KeyDownHandler handler)
Add a keyDown handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addKeyPressHandler(KeyPressHandler handler)
Add a keyPress handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addMouseDownHandler(MouseDownHandler handler)
Add a mouseDown handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addMouseMoveHandler(MouseMoveHandler handler)
Add a mouseMove handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addMouseOutHandler(MouseOutHandler handler)
Add a mouseOut handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addMouseOverHandler(MouseOverHandler handler)
Add a mouseOver handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addMouseStillDownHandler(MouseStillDownHandler handler)
Add a mouseStillDown handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addMouseUpHandler(MouseUpHandler handler)
Add a mouseUp handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addMouseWheelHandler(MouseWheelHandler handler)
Add a mouseWheel handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addMovedHandler(MovedHandler handler)
Add a moved handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addParentMovedHandler(ParentMovedHandler handler)
Add a parentMoved handler.
|
Canvas |
addPeer(Canvas newPeer)
Adds newPeer as a peer of this widget (also making it a child of this widget's parent, if any), set up a named object
reference (i.e., this[name]) to the new widget if name is provided, and draw the peer if this widget has been drawn
already.
|
Canvas |
addPeer(Canvas newPeer,
java.lang.String name) |
Canvas |
addPeer(Canvas newPeer,
java.lang.String name,
java.lang.Boolean autoDraw) |
Canvas |
addPeer(Canvas newPeer,
java.lang.String name,
java.lang.Boolean autoDraw,
java.lang.Boolean preDraw)
Adds newPeer as a peer of this widget (also making it a child of this widget's parent, if any), set up a named object
reference (i.e., this[name]) to the new widget if name is provided, and draw the peer if this widget has been drawn
already.
|
com.google.gwt.event.shared.HandlerRegistration |
addResizedHandler(ResizedHandler handler)
Add a resized handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRightMouseDownHandler(RightMouseDownHandler handler)
Add a rightMouseDown handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addRuleContextChangedHandler(RuleContextChangedHandler handler)
Add a ruleContextChanged handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addScrolledHandler(ScrolledHandler handler)
Add a scrolled handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addShowContextMenuHandler(ShowContextMenuHandler handler)
Add a showContextMenu handler.
|
void |
addSnapAlignCandidate(Canvas newCandidate)
Add a candidate to
snapAlignCandidates . |
void |
addStyleName(java.lang.String style)
Multiple styles are currently not supported.
|
com.google.gwt.event.shared.HandlerRegistration |
addVisibilityChangedHandler(VisibilityChangedHandler handler)
Add a visibilityChanged handler.
|
void |
adjustForContent(boolean immediate)
This method tells a component to adjust for changes in the size of its content that happen outside of Smart GWT APIs.
|
void |
animateFade(int opacity)
Animate a change in opacity from the widget's current opacity to the specified opacity.
|
void |
animateFade(int opacity,
AnimationCallback callback)
Animate a change in opacity from the widget's current opacity to the specified opacity.
|
void |
animateFade(int opacity,
AnimationCallback callback,
int duration)
Animate a change in opacity from the widget's current opacity to the specified opacity.
|
void |
animateFade(int opacity,
AnimationCallback callback,
int duration,
AnimationAcceleration acceleration)
Animate a change in opacity from the widget's current opacity to the specified opacity.
|
void |
animateFade(java.lang.Integer opacity)
Animate a change in opacity from the widget's current opacity to the specified opacity.
|
void |
animateFade(java.lang.Integer opacity,
AnimationCallback callback) |
void |
animateFade(java.lang.Integer opacity,
AnimationCallback callback,
java.lang.Integer duration) |
void |
animateFade(java.lang.Integer opacity,
AnimationCallback callback,
java.lang.Integer duration,
AnimationAcceleration acceleration)
Animate a change in opacity from the widget's current opacity to the specified opacity.
|
void |
animateHide()
Hide a canvas by shrinking it with default effect specified by
animateHideEffect . |
void |
animateHide(AnimateShowEffect effect)
Hide a canvas by shrinking it vertically to zero height over a period of time.
|
void |
animateHide(AnimateShowEffect effect,
AnimationCallback callback)
Hide a canvas by shrinking it vertically to zero height over a period of time.
|
void |
animateHide(AnimateShowEffect effect,
AnimationCallback callback,
int duration)
Hide a canvas by shrinking it vertically to zero height over a period of time.
|
void |
animateHide(AnimationEffect effect)
Hide a canvas by shrinking it vertically to zero height over a period of time.
|
void |
animateHide(AnimationEffect effect,
AnimationCallback callback)
Hide a canvas by shrinking it vertically to zero height over a period of time.
|
void |
animateHide(AnimationEffect effect,
AnimationCallback callback,
int duration)
Hide a canvas by shrinking it vertically to zero height over a period of time.
|
void |
animateMove(java.lang.Integer left,
java.lang.Integer top)
Animate a reposition of this canvas from its current position to the specified position
|
void |
animateMove(java.lang.Integer left,
java.lang.Integer top,
AnimationCallback callback) |
void |
animateMove(java.lang.Integer left,
java.lang.Integer top,
AnimationCallback callback,
java.lang.Integer duration) |
void |
animateMove(java.lang.Integer left,
java.lang.Integer top,
AnimationCallback callback,
java.lang.Integer duration,
AnimationAcceleration acceleration)
Animate a reposition of this canvas from its current position to the specified position
|
void |
animateRect(java.lang.Integer left,
java.lang.Integer top,
java.lang.Integer width,
java.lang.Integer height)
Animate a reposition / resize of this canvas from its current size and position.
|
void |
animateRect(java.lang.Integer left,
java.lang.Integer top,
java.lang.Integer width,
java.lang.Integer height,
AnimationCallback callback) |
void |
animateRect(java.lang.Integer left,
java.lang.Integer top,
java.lang.Integer width,
java.lang.Integer height,
AnimationCallback callback,
java.lang.Integer duration) |
void |
animateRect(java.lang.Integer left,
java.lang.Integer top,
java.lang.Integer width,
java.lang.Integer height,
AnimationCallback callback,
java.lang.Integer duration,
AnimationAcceleration acceleration)
Animate a reposition / resize of this canvas from its current size and position.
|
void |
animateResize(java.lang.Integer width,
java.lang.Integer height)
Animate a resize of this canvas from its current size to the specified size
|
void |
animateResize(java.lang.Integer width,
java.lang.Integer height,
AnimationCallback callback) |
void |
animateResize(java.lang.Integer width,
java.lang.Integer height,
AnimationCallback callback,
java.lang.Integer duration) |
void |
animateResize(java.lang.Integer width,
java.lang.Integer height,
AnimationCallback callback,
java.lang.Integer duration,
AnimationAcceleration acceleration)
Animate a resize of this canvas from its current size to the specified size
|
void |
animateScroll(java.lang.Integer scrollLeft,
java.lang.Integer scrollTop)
Animate a scroll from the current scroll position to the specified position.
|
void |
animateScroll(java.lang.Integer scrollLeft,
java.lang.Integer scrollTop,
AnimationCallback callback) |
void |
animateScroll(java.lang.Integer scrollLeft,
java.lang.Integer scrollTop,
AnimationCallback callback,
java.lang.Integer duration) |
void |
animateScroll(java.lang.Integer scrollLeft,
java.lang.Integer scrollTop,
AnimationCallback callback,
java.lang.Integer duration,
AnimationAcceleration acceleration)
Animate a scroll from the current scroll position to the specified position.
|
void |
animateScroll(int scrollLeft,
int scrollTop,
AnimationCallback callback)
Animate a scroll from the current scroll position to the specified position.
|
void |
animateScroll(int scrollLeft,
int scrollTop,
AnimationCallback callback,
int duration)
Animate a scroll from the current scroll position to the specified position.
|
void |
animateShow()
Show a canvas by growing it with default effect specified by
animateShowEffect . |
void |
animateShow(AnimateShowEffect effect)
Show a canvas by growing it vertically to its fully drawn height over a period of time.
|
void |
animateShow(AnimateShowEffect effect,
AnimationCallback callback)
Show a canvas by growing it vertically to its fully drawn height over a period of time.
|
void |
animateShow(AnimateShowEffect effect,
AnimationCallback callback,
int duration)
Show a canvas by growing it vertically to its fully drawn height over a period of time.
|
void |
animateShow(AnimationEffect effect)
Show a canvas by growing it vertically to its fully drawn height over a period of time.
|
void |
animateShow(AnimationEffect effect,
AnimationCallback callback)
Show a canvas by growing it vertically to its fully drawn height over a period of time.
|
void |
animateShow(AnimationEffect effect,
AnimationCallback callback,
int duration)
Show a canvas by growing it vertically to its fully drawn height over a period of time.
|
static <T extends Canvas> |
asSGWTComponent(com.google.gwt.core.client.JavaScriptObject jsObj)
Returns the existing SGWT widget, or creates and returns one if none exist,
associated with the supplied
JavaScriptObject . |
void |
blur()
If this canvas has keyboard focus, blur it.
|
void |
bringToFront()
Puts this widget at the top of the stacking order, so it appears in front of all other widgets in the same parent.
|
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 |
clear()
Remove all visual representation of a Canvas, including all child or member Canvases, or managed top-level components
such as the ListGrid drop location indicator.
|
void |
clearExplicitTabIndex()
If an explicit
tabIndex was assigned to this widget, clear it. |
java.lang.Boolean |
clickMaskUp()
Determines whether a clickmask is showing
|
java.lang.Boolean |
clickMaskUp(java.lang.String ID)
Determines whether a clickmask is showing
|
java.lang.Boolean |
contains(Canvas canvas)
Returns true if element is a descendant of this widget (i.e., exists below this widget in the containment
hierarchy); and false otherwise.
|
java.lang.Boolean |
contains(Canvas canvas,
java.lang.Boolean testSelf)
Returns true if element is a descendant of this widget (i.e., exists below this widget in the containment
hierarchy); and false otherwise.
|
java.lang.Boolean |
containsEvent()
Return true if the last event's mouse coordinates are within the bounds of this component.
|
java.lang.Boolean |
containsEventTarget()
Returns true if the current
mouse event target is this component
or a descendent of this component. |
java.lang.Boolean |
containsFocus()
Returns true if the keyboard focus is in this Canvas or any child of this Canvas.
|
java.lang.Boolean |
containsPoint(int x,
int y)
Return whether or not this object contains the specified global (x,y) coordinates.
|
java.lang.Boolean |
containsPoint(int x,
int y,
java.lang.Boolean withinViewport)
Return whether or not this object contains the specified global (x,y) coordinates.
|
protected com.google.gwt.core.client.JavaScriptObject |
create() |
void |
dataContextChanged()
Notification method fired when
DataContext is bound. |
void |
deparent()
Remove this canvas from its parent if it has one.
|
void |
depeer()
Make this Canvas no longer a peer of its master
|
void |
disable()
Disables this widget and any children and peers of this widget.
|
void |
enable()
Enables this widget and any children / peers of this widget.
|
java.lang.Boolean |
encloses(Canvas other)
Returns true if the rectangle of this widget encloses the rectangle of the specified widget.
|
void |
focus()
If this canvas can accept focus, give it keyboard focus.
|
void |
focusAfterGroup()
Shifts focus to the next focusable element after this one, skipping any elements nested inside the tabbing group for
this canvas, such as focusable children.
|
void |
focusAtEnd(boolean start)
Shifts focus to the start or end of this canvas and its descendants.
|
void |
focusInNextTabElement()
Shifts focus to the next focusable element after this one.
|
void |
focusInPreviousTabElement()
Shifts focus to the previous focusable element before this one.
|
int |
getAbsoluteLeft()
This method is similar to
getPageLeft() . |
int |
getAbsoluteTop()
This method is similar to
getPageTop() . |
java.lang.String |
getAccessKey()
If specified this governs the HTML accessKey for the widget.
|
java.lang.Integer |
getAdaptiveHeightPriority()
|
java.lang.Integer |
getAdaptiveWidthPriority()
If multiple widgets in the same Layout have
adaptive width ,
adaptiveWidthPriority can be set to indicate which of the components should be given priority access to
space. |
java.lang.Boolean |
getAlwaysManageFocusNavigation()
Should focus navigation for this canvas and its descendents be handled explicitly by intercepting "Tab" key events and
calling the
TabIndexManager.shiftFocus() API? |
java.lang.Boolean |
getAlwaysShowScrollbars()
Should this browser always show custom scrollbars if
showCustomScrollbars is true? |
AnimationAcceleration |
getAnimateAcceleration()
Default acceleration effect to apply to all animations on this Canvas.
|
java.lang.Integer |
getAnimateFadeTime()
Default time for performing an animated fade.
|
AnimationAcceleration |
getAnimateHideAcceleration()
Default acceleration function for performing an animated hide.
|
AnimationEffect |
getAnimateHideEffect()
Default animation effect to use if
animateHide() is called without an explicit effect parameter. |
java.lang.Integer |
getAnimateHideTime()
Default time for performing an animated hide.
|
AnimationAcceleration |
getAnimateMoveAcceleration()
Default acceleration effect for performing an animated move.
|
java.lang.Integer |
getAnimateMoveTime()
Default time for performing an animated move.
|
AnimationAcceleration |
getAnimateRectAcceleration()
Default acceleration function for performing an animated move and resize.
|
java.lang.Integer |
getAnimateRectTime()
Default time for performing an animated setRect.
|
AnimationAcceleration |
getAnimateResizeAcceleration()
Default acceleration function for performing an animated resize.
|
AnimationLayoutMode |
getAnimateResizeLayoutMode()
When to update the
child layout for a size animation . |
java.lang.Integer |
getAnimateResizeTime()
Default time for performing an animated resize.
|
AnimationAcceleration |
getAnimateScrollAcceleration()
Default acceleration function for performing an animated scroll.
|
java.lang.Integer |
getAnimateScrollTime()
Default time for performing an animated scroll.
|
AnimationAcceleration |
getAnimateShowAcceleration()
Default acceleration function for performing an animated show.
|
AnimationEffect |
getAnimateShowEffect()
Default animation effect to use if
animateShow() is called without an explicit effect parameter. |
java.lang.Integer |
getAnimateShowTime()
Default time for performing an animated show.
|
int |
getAnimateTime()
Default total duration of animations.
|
java.lang.String |
getAppImgDir()
Default directory for app-specific images, relative to the Page-wide
appImgDir . |
java.lang.String |
getAriaHandleID()
Returns the DOM ID for the main element for this canvas which will have ARIA
role and attributes applied to it. |
java.lang.String |
getAriaRole()
ARIA role of this component.
|
java.util.Map |
getAriaStateDefaults()
Retrieves dynamically calculated default ARIA state properties for this canvas.
|
java.lang.Boolean |
getAutoMaskComponents()
Deprecated.
As of Smart GWT version 10.0, deprecated in favor of
EditProxy.autoMaskChildren |
java.lang.String |
getAutoParent()
This initialization property allows developers to create a canvas using the Class.addAutoChild() method, and have it
added as a child to some other component.
|
java.lang.Boolean |
getAutoPopulateData()
If a
dataContext is provided, should subcomponents
automatically bind to the data? |
java.lang.Boolean |
getAutoShowParent()
If set to true, the widget's parent (if any) will automatically be shown whenever the widget is shown.
|
java.lang.String |
getBackgroundColor()
The background color for this widget.
|
java.lang.String |
getBackgroundImage()
URL for a background image for this widget (corresponding to the CSS "background-image" attribute).
|
java.lang.String |
getBackgroundPosition()
Specifies how the background image should be positioned on the widget.
|
BackgroundRepeat |
getBackgroundRepeat()
Specifies how the background image should be tiled if this widget is larger than the image.
|
java.lang.String |
getBorder()
Set the CSS border of this component, as a CSS string including border-width, border-style, and/or color (eg "2px solid
blue").
|
java.lang.String |
getBorderRadius()
The CSS border-radius for this widget.
|
int |
getBottom()
Return the bottom coordinate of this object as rendered, relative to its enclosing context, in pixels.
|
static Canvas |
getById(java.lang.String ID)
Retrieve a Canvas by its global
ID . |
static Canvas |
getByJSObject(com.google.gwt.core.client.JavaScriptObject jsObj)
Retrieve a Canvas from its
JavaScriptObject . |
Canvas |
getByLocalId(java.lang.String ID)
Retrieve a child of this Canvas by it's local ID.
|
java.lang.Boolean |
getCanAcceptDrop()
Indicates that this object can receive dropped widgets (i.e.
|
java.lang.Boolean |
getCanAdaptHeight()
See
canAdaptWidth . |
java.lang.Boolean |
getCanAdaptWidth()
Indicates that this component is able to render itself at multiple possible sizes, in order to fit into less space when
very little space is available, or to display more information or provide more immediate access to functionality when
more space is available.
|
java.lang.Boolean |
getCanDrag()
Indicates whether this widget can initiate custom drag-and-drop operations (other than reposition or resize).
|
java.lang.Boolean |
getCanDragReposition()
Indicates whether this widget can be moved by a user of your application by simply dragging with the mouse.
|
java.lang.Boolean |
getCanDragResize()
Indicates whether this widget can be resized by dragging on the edges and/or corners of the widget with the mouse.
|
boolean |
getCanDragScroll()
If this Canvas is canAcceptDrop:true, when the user drags a droppable widget over an edge of the widget, should we
scroll to show the rest of the widget's content? Returned from canvas.shouldDragScroll() if there are scrollbars.
|
java.lang.Boolean |
getCanDrop()
Indicates that this object can be dropped on top of other widgets.
|
java.lang.Boolean |
getCanDropBefore()
When explicitly set to false, disallows drop before this member in the Layout.
|
java.lang.Boolean |
getCanFocus()
Can this widget be allowed to become the target of keyboard events?
|
java.lang.Boolean |
getCanHover()
Will this Canvas fire hover events when the user hovers over it, or one of its children?
|
java.lang.Boolean |
getCanSelectText()
Whether native drag selection of contained text is allowed within this Canvas.
|
Canvas |
getCanvasAutoChild(java.lang.String autoChildName)
Returns the
Canvas AutoChild named autoChildName if already created. |
CanvasItem |
getCanvasItem()
If this canvas is being displayed in a
CanvasItem , this property will be
set to point at the item. |
Canvas[] |
getChildren()
Array of all Canvii that are immediate children of this Canvas.
|
java.lang.Boolean |
getChildrenResizeSnapAlign()
Flag to disable snapping to alignment when children of this Canvas are resized
|
java.lang.Boolean |
getChildrenSnapAlign()
If enabled while
childrenSnapToGrid is enabled,
children dragged within this Canvas will also snap to positions where their edges or center lines would be aligned with
the edges or centers of other components, and lines will be shown to point out the possible alignment (with appearance
controlled by snapAlignCenterLineStyle and snapAlignEdgeLineStyle respectively. |
java.lang.Boolean |
getChildrenSnapCenterAlign()
See
childrenSnapAlign . |
java.lang.Boolean |
getChildrenSnapEdgeAlign()
See
childrenSnapAlign . |
java.lang.Boolean |
getChildrenSnapResizeToGrid()
If true, causes this canvas's children to snap to its grid when resizing.
|
java.lang.Boolean |
getChildrenSnapToGrid()
If true, causes this canvas's children to snap to its grid when dragging.
|
java.lang.Integer |
getChildTabPosition(Canvas child)
For a given child widget where
updateTabPositionOnReparent is true, return the expected tab position within this parent. |
java.lang.String |
getClassName()
Returns the JavaScript class name.
|
Canvas |
getComponentMask()
Automatically generated mask canvas displayed when
showComponentMask() is called. |
Canvas |
getComponentMaskDefaults()
Defaults for the
componentMask autoChild. |
com.google.gwt.dom.client.Element |
getContentElement()
Returns the DOM element for this Canvas which contains the
contents , or for parent components , the DOM elements for any
drawn children. |
java.lang.String |
getContents()
The contents of a canvas or label widget.
|
Menu |
getContextMenu()
Context menu to show for this object, an instance of the Menu widget.
|
java.lang.Boolean |
getCorrectZoomOverflow()
Whether the Framework should correct for erroneous scrollHeight and scrollWidth values reported by the browser when
zoomed (via browser or OS-level zoom) by allowing
maxZoomOverflowError of overflow before enabling scrolling and displaying custom scrollbars. |
Cursor |
getCursor()
Specifies the css cursor image to
display when the mouse pointer is over this component.
|
DataContext |
getDataContext()
A mapping from
DataSource IDs to specific Records from those DataSources, that DataBoundComponents
contained within this Canvas should automatically bind to if a DataSource is provided but data is not provided (directly
or indirectly, for example, indirectly via setting ListGrid.autoFetchData . |
java.lang.String |
getDataPath()
A dataPath may be specified on any canvas.
|
int |
getDefaultHeight()
For custom components, establishes a default height for the component.
|
int |
getDefaultWidth()
For custom components, establishes a default width for the component.
|
java.lang.String |
getDefiningProperty()
This attribute denotes the name of a property to use as a
getDefiningPropertyName() for this property when generating
and resolving AutoTest locators with search segments . |
java.lang.String |
getDefiningPropertyName()
|
java.lang.String[] |
getDefiningPropertyNameOptions()
If no explicit
definingProperty was specified for this
component,
this array denotes a list of options to use as a
defining property when generating and resolving
AutoTest locators with search segments . |
java.lang.Boolean |
getDestroyed()
If this property is set to
true , the destroy() method
has been called on this canvas. |
java.lang.Boolean |
getDestroying()
This property is set to true when the
destroy() method is called on a
widget. |
boolean |
getDisabled()
If set to true, the widget will be disabled.
|
Cursor |
getDisabledCursor()
Specifies the cursor image to display when the mouse pointer is over this widget if this widget is disabled.
|
java.lang.Boolean |
getDisableTouchScrollingForDrag()
Disables
useTouchScrolling whenever a built-in drag
operation has been enabled which is known to be non-functional if touch scrolling is enabled. |
int |
getDoubleClickDelay()
Amount of time (in milliseconds) between which two clicks are considered a single click
|
DragAppearance |
getDragAppearance()
Visual appearance to show when the object is being dragged.
|
DragIntersectStyle |
getDragIntersectStyle()
This indicates how the system will test for droppable targets: either by intersection with the mouse or intersection
with the rectangle of the dragMoveTarget.
|
DragMaskType |
getDragMaskType()
This property controls what kind of mask is used in case
useDragMask is enabled. |
int |
getDragMaxHeight()
Sets maximum height that this Canvas can be resized to by a user.
|
int |
getDragMaxWidth()
Maximum width that this Canvas can be resized to by a user.
|
int |
getDragMinHeight()
Minimum height that this Canvas can be resized to by a user.
|
int |
getDragMinWidth()
Minimum width that this Canvas can be resized to by a user.
|
java.lang.Integer |
getDragOpacity()
If this widget has dragAppearance
"target" , this value specifies the opacity to render the target while it
is being dragged. |
DragAppearance |
getDragRepositionAppearance()
If
canDragReposition is true, this attribute specifies
the visual appearance to show during drag reposition. |
Cursor |
getDragRepositionCursor()
Cursor to switch to if the mouse is over a widget that is drag repositionable.
|
DragAppearance |
getDragResizeAppearance()
If
canDragResize is true, this attribute specifies the
visual appearance to show during drag resize. |
int |
getDragScrollDelay()
If this widget supports drag-scrolling, This property specifies how many ms the user must hover over the
drag-scroll threshold before scrolling begins.
|
int |
getDragStartDistance()
Number of pixels the cursor needs to move before the EventHandler starts a drag operation.
|
Canvas |
getDragTarget()
A different widget that should be actually dragged when dragging initiates on this widget.
|
java.lang.String |
getDragTargetAsString()
A different widget that should be actually dragged when dragging initiates on this widget.
|
java.lang.String |
getDragType()
Sets a
dragType for this widget used, to be compared to dropTypes on possible drop target widgets. |
Canvas |
getDropTarget()
Delegates a different widget that should actually be dropped on if the cursor is over this widget when the drop
completes.
|
java.lang.String |
getDropTargetAsString()
Delegates a different widget that should actually be dropped on if the cursor is over this widget when the drop
completes.
|
java.lang.String[] |
getDropTypes()
When a drag and drop interaction occurs, if a
dragType is
configured on the source widget, it is compared to the dropTypes configured on the target widget, and a
drop is only allowed if the dragType is listed in the target widget's dropTypes array. |
java.lang.String |
getDropTypesAsString()
When a drag and drop interaction occurs, if a
dragType is
configured on the source widget, it is compared to the dropTypes configured on the target widget, and a
drop is only allowed if the dragType is listed in the target widget's dropTypes array. |
java.lang.Boolean |
getDynamicContents()
Dynamic contents allows the contents string to be treated as a simple but powerful template.
|
java.lang.String |
getEdgeBackgroundColor()
Background color for the EdgedCanvas created to decorate this component.
|
java.lang.String |
getEdgeCenterBackgroundColor()
Background color for the center section only.
|
java.lang.String |
getEdgeImage()
Base name of images for edges.
|
int |
getEdgeMarginSize()
How far into the edge of an object do we consider the "edge" for drag resize purposes?
|
java.lang.Integer |
getEdgeOffset()
Amount the contained Canvas should be offset.
|
java.lang.Integer |
getEdgeOpacity()
Opacity of the edges.
|
java.lang.Boolean |
getEdgeShowCenter()
Whether to show media in the center section, that is, behind the decorated Canvas.
|
int |
getEdgeSize()
Size in pixels for corners and edges
|
EditNode |
getEditNode()
|
EditProxy |
getEditProxy()
An
EditProxy controls the behaviors of a component when it is placed into editing mode . |
java.lang.String |
getEditProxyConstructor()
Default class used to construct the
EditProxy for this component when the component is
first placed into edit mode . |
com.google.gwt.user.client.Element |
getElement()
Normal usage of SmartGWT is to call draw() on SmartGWT widgets, not to use use RootPanel.add().
|
com.google.gwt.user.client.Element |
getElement(boolean allowPreRender) |
AdvancedCriteria |
getEnableWhen()
Criteria to be evaluated to determine whether this Canvas should be enabled.
|
java.lang.Boolean |
getEndLine()
Whether this canvas should end the line it's in when used as a tile in a
FlowLayout . |
static EdgeName |
getEventEdge()
Check if an event is within an "edge" of this canvas.
|
static EdgeName |
getEventEdge(EdgeName... edgeMask)
Check if an event is within an "edge" of this canvas.
|
int |
getExtraSpace()
When this Canvas is included as a member in a Layout, extra blank space that should be left after this member in a
Layout.
|
java.lang.String |
getFacetId()
|
boolean |
getFloatingScrollbars()
If
showCustomScrollbars is true, should the
scrollbars be drawn floating over the component handle, or should the handle shrink to accommodate them? |
FormItem |
getFormItemAutoChild(java.lang.String autoChildName)
Returns the
FormItem AutoChild named autoChildName if already created. |
java.lang.Boolean |
getForwardSVGeventsToObject()
If true, events sent to the SVG inside an object tag are forwarded to the object itself by Framework handlers.
|
java.lang.String |
getFullDataPath()
Returns a fully qualified
DataPath for this canvas. |
java.lang.String |
getGroupBorderCSS()
Sets the style for the grouping frame around the canvas.
|
java.lang.String |
getGroupLabelBackgroundColor()
If set, the background color of the grouping label.
|
java.lang.String |
getGroupLabelStyleName()
Sets the style for the grouping label.
|
java.lang.Integer |
getGroupPadding()
Padding to apply inside the border when this canvas is showing a group
border and label . |
java.lang.String |
getGroupTitle()
The title/label for the grouping.
|
java.lang.Integer |
getHeight()
The
canvas.width attribute specifies the size for a component's horizontal dimension;
canvas.height specifies the size for the vertical dimension. |
java.lang.String |
getHeightAsString() |
boolean |
getHideUsingDisplayNone()
When this widget is hidden (see
visibility and hide() ), should display:none be applied to the outer element ? |
Alignment |
getHoverAlign()
If
this.showHover is true, this property can be used to customize the alignment of content in the hover
canvas. |
java.lang.Boolean |
getHoverAutoDestroy()
If
this.showHover is true and getHoverComponent() is implemented, should the hoverCanvas returned from it be automatically destroyed when it is
hidden? |
int |
getHoverAutoFitMaxWidth()
Maximum auto-fit width for a hover if
hoverAutoFitWidth
is enabled. |
java.lang.String |
getHoverAutoFitMaxWidthAsString()
Maximum auto-fit width for a hover if
hoverAutoFitWidth
is enabled. |
java.lang.Boolean |
getHoverAutoFitWidth()
if
showHover is true, this property will cause the specified
hoverWidth to be treated as a minimum width for the hover. |
Canvas |
getHoverComponent()
When
showHoverComponents is true, this method is
called to get the component to show as a hover for this Canvas. |
int |
getHoverDelay()
If
this.canHover is true, how long should the mouse be kept over this widget before the hover event is
fired |
java.lang.String |
getHoverFocusKey()
For canvases
showing a hover , this attribute gives users a way
to pin the hover in place so they can interact with it (scroll it, click embedded links, etc). |
java.lang.Integer |
getHoverHeight()
If
this.showHover is true, this property can be used to customize the height of the hover canvas shown. |
java.lang.String |
getHoverHTML()
If
this.showHover is true, when the user holds the mouse over this Canvas for long enough to trigger a
hover event, a hover canvas is shown by default. |
java.lang.Boolean |
getHoverMoveWithMouse()
If
this.showHover is true, should this widget's hover canvas be moved with the mouse while visible? |
java.lang.Integer |
getHoverOpacity()
If
this.showHover is true, should the hover canvas be shown with opacity other than 100? |
HoverPersistMode |
getHoverPersist()
Allows interaction with hovers when the cursor is positioned over them.
|
java.lang.String |
getHoverScreen()
Screen to create (via
createScreen() ) in lieu of calling getHoverComponent() . |
java.lang.String |
getHoverStyle()
If
this.showHover is true, this property can be used to specify the css style to apply to the hover canvas. |
VerticalAlignment |
getHoverVAlign()
If
this.showHover is true, this property can be used to customize the vertical alignment of content in the
hover canvas. |
int |
getHoverWidth()
If
this.showHover is true, this property can be used to
customize the width of the hover canvas shown. |
java.lang.Boolean |
getHoverWrap()
If
this.showHover is true, this property can be used to customize the whether content in the hover canvas
is displayed in a single line, or wraps. |
int |
getHSnapPosition(int coordinate)
Override this method to provide a custom snap-to grid.
|
int |
getHSnapPosition(int coordinate,
java.lang.String direction)
Override this method to provide a custom snap-to grid.
|
com.google.gwt.dom.client.Element |
getHtmlElement()
If specified as a pointer to an HTML element present in the DOM, this canvas will be rendered inside that element on
draw() . |
java.lang.String |
getHtmlElementAsString()
If specified as a pointer to an HTML element present in the DOM, this canvas will be rendered inside that element on
draw() . |
DrawPosition |
getHtmlPosition()
If
htmlElement is specified, this attribute specifies the
position where the canvas should be inserted relative to the htmlElement in the DOM. |
com.google.gwt.dom.client.Element |
getImage(java.lang.String identifier)
Retrieve a native image, SVG object element or the container for an SVG symbol or font-icon, by name.
|
static java.lang.String |
getImgURL(java.lang.String URL)
Return the full URL for an image to be drawn in this canvas.
|
static java.lang.String |
getImgURL(java.lang.String URL,
java.lang.String imgDir)
Return the full URL for an image to be drawn in this canvas.
|
int |
getInnerContentHeight()
Returns the amount of space available for interior content (or relatively positioned child widget(s)) without
introducing clipping, scrolling or overflow.
This is the space within the viewport of the widget (not including padding, and excluding margins, borders or scrollbars) rendered at its specified size. |
int |
getInnerContentWidth()
Returns the amount of space available for interior content (or relatively positioned child widget(s)) without
introducing clipping, scrolling or overflow.
This is the space within the viewport of the widget (not including padding, and excluding margins, borders or scrollbars) rendered at its specified size. |
int |
getInnerHeight()
Returns the amount of space available for (an) absolutely positioned child widget(s) or absolutely positioned HTML
content, without introducing clipping, scrolling or overflow.
|
int |
getInnerWidth()
Returns the amount of space available for absolutely positioned child widget(s) or absolutely positioned HTML content,
without introducing clipping, scrolling or overflow.
|
boolean |
getIsGroup()
Should a grouping frame be shown around this canvas if a non-empty string has been specified for
groupTitle . |
java.lang.Boolean |
getIsPrinting()
This boolean flag will be set to true by framework logic while generating print HTML for this widget as a result to a
call to
showPrintPreview() (or just getPrintHTML() ). |
java.lang.Boolean |
getIsRuleScope()
Marks this Canvas as the
ruleScope that will be discovered by
any contained DataBoundComponent s which do not specify an explicit
ruleScope . |
java.lang.Boolean |
getIsSnapAlignCandidate()
Flag to disable snapping to alignment against this Canvas when other Canvases dragged into the same parent when
childrenSnapAlign is enabled on this Canvas' parent. |
java.lang.Boolean |
getKeepInParentRect()
Constrains drag-resizing and drag-repositioning of this canvas to either the rect of its parent (if set to true) or an
arbitrary rect based on its parent (if set to a [Left,Top,Width,Height] rect array).
|
Alignment |
getLayoutAlign()
When this Canvas is included as a member in a Layout, layoutAlign controls alignment on the breadth axis of the layout.
|
java.lang.Boolean |
getLeaveGroupLabelSpace()
When showing this widget in a
group , should any content be shifted
down so that the group-label doesn't sit in front of it? |
java.lang.Integer |
getLeavePageSpace()
If set, overrides the global
defaultPageSpace . |
int |
getLeft()
Number of pixels the left side of the widget is offset to the right from its default drawing context (either its
parent's topleft corner, or the document flow, depending on the value of the
position property). |
java.lang.String |
getLeftAsString()
Number of pixels the left side of the widget is offset to the right from its default drawing context (either its
parent's topleft corner, or the document flow, depending on the value of the
position property). |
java.lang.String |
getLocalId()
Retrieve the local ID of this canvas.
|
boolean |
getLocateByIDOnly()
If
true , when retrieving a locator for this component
always return a reference directly to this component by widget ID ,
using the compact format "///canvasID" , ignoring any parent elements and ignoring any configured
testRoot . |
LocatorStrategy |
getLocateChildrenBy()
Strategy to use when locating children in this canvas from an autoTest locator string.
|
LocatorTypeStrategy |
getLocateChildrenType()
LocatorTypeStrategy to use when finding children within this canvas. |
LocatorStrategy |
getLocatePeersBy()
Strategy to use when locating peers of this canvas from an autoTest locator string.
|
LocatorTypeStrategy |
getLocatePeersType()
LocatorTypeStrategy to use when finding peers of this canvas. |
java.lang.String |
getLocatorName()
Local name for referencing this canvas from an autoTest locator string.
|
com.smartgwt.logicalstructure.core.LogicalStructureObject |
getLogicalStructure()
Getter implementing the
LogicalStructure interface,
which supports Eclipse's logical structure debugging facility. |
java.lang.Integer |
getMargin()
Set the CSS Margin, in pixels, for this component.
|
Canvas |
getMasterCanvas()
Returns this canvas's "master" (the canvas to which it was added as a peer), if any.
|
Canvas |
getMasterElement()
Deprecated.
In favor or
getMasterCanvas() as of Smart GWT release 9.1 |
java.lang.Boolean |
getMatchElement()
If
htmlElement is specified, should this canvas be drawn at
the same dimensions as the htmlElement?See also matchElementWidth and matchElementHeight |
MatchElementSizeMode |
getMatchElementHeight()
For canvases with a specified
htmlElement where persistentMatchElement is set to true, how should the
canvas match the element's height? |
MatchElementSizeMode |
getMatchElementWidth()
For canvases with a specified
htmlElement where persistentMatchElement is set to true, how should the
canvas match the element's width? |
int |
getMaxHeight()
Maximum height available to this Canvas.
|
int |
getMaxWidth()
Maximum width available to this Canvas.
|
int |
getMaxZoomOverflowError()
When
correctZoomOverflow is true and browser or
OS-level zoom is active, determines how much overflow must occur before the Framework enables scrolling for this canvas. |
java.lang.String |
getMenuConstructor()
Default class used to construct menus created by this component, including context menus.
|
int |
getMinHeight()
Minimum height available to this Canvas.
|
int |
getMinNonEdgeSize()
If the widget has drag resize configured on one or more of it's edges, and the edgeMarginSize is large enough that the
remaining space is less than
minNonEdgeSize , the edgeMarginSize will be reduced such that the non-edge part
of the widget is at least 1/3 of the total space (with two draggable edges) or half of it (with one draggable edge). |
int |
getMinWidth()
Minimum width available to this Canvas.
|
double |
getMomentumScrollMinSpeed()
The minimum speed in pixels per second that must be reached for momentum scrolling to kick in.
|
int |
getMouseStillDownDelay()
Amount of time (in milliseconds) between repeated 'mouseStillDown' events for this canvas.
|
int |
getMouseStillDownInitialDelay()
Amount of time (in milliseconds) before mouseStillDown events start to be fired repeatedly for this canvas.
|
java.lang.String |
getName()
Optional name for the canvas, which can later be used to reference it.
|
java.lang.Boolean |
getNativeAutoHideScrollbars()
In some platform/browser configurations, scrollable regions do not show visible scrollbars until the user attempts to
interact with the region.
|
int |
getNextZIndex()
get the next zIndex for the next item to be drawn.
|
java.lang.Boolean |
getNoDoubleClicks()
If true, this canvas will receive all mouse-clicks as single
click events rather than as doubleClick events. |
Cursor |
getNoDropCursor()
Specifies the cursor image to display when the user drags a droppable canvas over this if it is not a valid drop
target for the event and
showNoDropIndicator is
true. |
int |
getOffsetHeight() |
int |
getOffsetWidth() |
int |
getOffsetX()
Return the X-coordinate of the last event relative to the left edge of the content of this Canvas.
NOTE: To get a coordinate relative to the viewport of this Canvas, subtract this.getScrollLeft() |
int |
getOffsetY()
Return the Y-coordinate of the last event, relative to the top edge of the content of this Canvas.
NOTE: To get a coordinate relative to the viewport of this Canvas, subtract this.getScrollTop() |
java.lang.Integer |
getOpacity()
Renders the widget to be partly transparent.
|
static Canvas |
getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj) |
com.google.gwt.dom.client.Element |
getOuterElement()
Returns the outer DOM element of this Canvas.
|
Overflow |
getOverflow()
Controls what happens when the drawn size of the content of a Canvas is either greater or smaller than the
specified size of the Canvas.
|
java.lang.Integer |
getPadding()
Set the CSS padding of this component, in pixels.
|
int |
getPageBottom()
Return the page-relative bottom coordinate of this object, in pixels.
|
int |
getPageLeft()
Returns the page-relative left coordinate of the widget on the page, in pixels.
|
Rectangle |
getPageRect() |
int |
getPageRight()
Return the page-relative right coordinate of this object, in pixels.
|
int |
getPageTop()
Returns the page-relative top coordinate of the widget on the page, in pixels
|
java.util.Map |
getPaletteDefaults()
This method returns a Map of config properties suitable for use as the "defaults"
attribute of a
PaletteNode . |
Canvas |
getPanelContainer()
Returns this Canvas's "panel container".
|
Canvas |
getParentCanvas()
This Canvas's immediate parent, if any.
|
Canvas |
getParentElement()
Deprecated.
As of Smartclient version 9.1, deprecated in favor of
parentCanvas and getParentCanvas() |
Canvas[] |
getPeers()
Array of all Canvii that are peers of this Canvas.
|
java.lang.String |
getPendingMarkerStyle()
CSS class used to apply additional styles to this canvas when
showPendingMarker() is called, or when pendingMarkerVisible has been set. |
java.lang.Boolean |
getPendingMarkerVisible()
This attribute indicates whether the
pending marker
class should be appended to the list of CSS classes applied to this canvas. |
PercentBoxModel |
getPercentBox()
Governs the model to be used when sizing canvases with percentage width or height, or positioning widgets with a
specified
snapTo . |
Canvas |
getPercentSource()
If this canvas has its size specified as a percentage, this property allows the user to explicitly designate another
canvas upon which sizing will be based.
|
java.lang.Boolean |
getPersistentMatchElement()
If this canvas has a specified
htmlElement and matchElement is set to true, should the canvas perform a one time
resize to fit the target element on draw, or should it continue to match the target element as its size changes due to
page reflows? |
PointerSettings |
getPointerSettings()
Detail settings of the
pointer such as where it should be
located along the outside of the canvas. |
java.lang.String |
getPointerTarget()
This property in conjunction with the
pointerSettings.snapTo places
the canvas in relation to the target canvas. |
java.lang.String |
getPointerTargetAsString()
This property in conjunction with the
pointerSettings.snapTo places
the canvas in relation to the target canvas. |
Positioning |
getPosition()
Absolute or relative, corresponding to the "absolute" (with respect to parent) or
"relative" (with respect to document flow) values for the CSS position attribute.
|
java.lang.String |
getPrefix() |
java.lang.Boolean |
getPrintChildrenAbsolutelyPositioned()
Should this canvas print its children absolutely positioned when generating
printable HTML . |
static void |
getPrintHTML(java.lang.Object[] components,
PrintProperties printProperties,
PrintHTMLCallback callback)
Returns print-formatted HTML for the specified list of components.
|
java.lang.String |
getPrintHTML(PrintProperties printProperties,
PrintHTMLCallback callback)
Retrieves printable HTML for this component and all printable subcomponents.
|
java.lang.String |
getPrintStyleName()
The CSS class to apply when printing this widget.
|
java.lang.String |
getPrompt()
Prompt displayed in hover canvas if
showHover is true. |
java.lang.String[] |
getProportionalResizeModifiers()
If
proportionalResizing is set to
ProportionalResizeMode.MODIFIER or
ProportionalResizeMode.MODIFIER_OFF then proportional resizing of the DrawItem
is activated or deactivated, respectively, whenever at least one key in this set of modifier keys is pressed. |
ProportionalResizeMode |
getProportionalResizing()
If
canDragResize is true, this property specifies the
conditions for when proportional resizing is used. |
boolean |
getReceiveScrollbarEvents()
Whether this canvas should receive
events from its scrollbars, which are peers . |
Rectangle |
getRect()
Get all four coordinates, relative to the enclosing context, at one.
|
java.lang.Boolean |
getRedrawOnResize()
Should this element be redrawn in response to a resize?
|
java.lang.String |
getResizeBarTarget()
When this Canvas is included as a member in a Layout, and
showResizeBar is set to true so that a resizeBar is created, resizeBarTarget:"next" can be
set to indicate that the resizeBar should resize the next member of the layout rather than this one. |
EdgeName[] |
getResizeFrom()
When drag resizing is enabled via
canDragResize , restricts
resizes to only certain edges or corners. |
int |
getRight()
Return the right coordinate of this object as rendered, relative to its enclosing context, in pixels.
|
java.util.Map |
getRuleContext()
Get the current value of the rule context collected by the
ruleScope of this component (which may be this component itself or whatever component is managing the
ruleScope for this component). |
java.util.Map |
getRuleContext(boolean databoundOnly)
Get the current value of the rule context collected by the
ruleScope of this component (which may be this component itself or whatever component is managing the
ruleScope for this component). |
java.lang.String |
getRuleScope()
ID of the component that gathers the context for evaluation of
criteria-based
rules specified by properties such as FormItem.visibleWhen ,
Dynamic Properties, and DynamicCriteria such as
ListGrid.initialCriteria . |
int |
getScrollbarSize()
How thick should we make the scrollbars for this canvas.
|
int |
getScrollBottom()
Returns the scrollTop required to scroll vertically to the end of this widget's content.
|
int |
getScrollHeight()
Returns the scrollable height of the widget's contents, including children, ignoring clipping.
|
int |
getScrollLeft()
Get the number of pixels this Canvas is scrolled from its left edge.
|
int |
getScrollRight()
Returns the scrollLeft required to scroll horizontally to the end of this widget's content.
|
int |
getScrollTop()
Get the number of pixels this Canvas is scrolled from its top edge.
|
int |
getScrollWidth()
Returns the scrollable width of the widget's contents, including children, ignoring clipping.
|
java.lang.String |
getShadowColor()
Color for the css-based drop shadow shown if
useCSSShadow is
true and showShadow is true. |
int |
getShadowDepth()
Depth of the shadow, or the virtual height above the page of the widget throwing the shadow.
|
java.lang.Integer |
getShadowHOffset()
Horizontal offset for the
shadow . |
java.lang.String |
getShadowImage()
If
useCSSShadow is false, (or for browsers that do not
support css3), this property supplies the base name of the series of images for the sides, corners, and center of the
shadow. |
java.lang.Integer |
getShadowOffset()
Offset of the shadow.
|
java.lang.Integer |
getShadowSoftness()
Softness, or degree of blurring, of the shadow.
|
java.lang.Integer |
getShadowSpread()
Explicit spread for the css-based drop shadow shown if
useCSSShadow is true and showShadow is true. |
java.lang.Integer |
getShadowVOffset()
Vertical offset for the
shadow . |
java.lang.Boolean |
getShouldPrint()
Whether this canvas should be included in a printable view.
|
boolean |
getShowCustomScrollbars()
Whether to use the browser's native scrollbars or Smart GWT-based scrollbars.
|
java.lang.Boolean |
getShowDragShadow()
When this widget is dragged, if its dragAppearance is
"target" , should we show a shadow behind the canvas
during the drag. |
java.lang.Boolean |
getShowEdges()
Whether an
EdgedCanvas should be used to show image-based edges around this
component. |
java.lang.Boolean |
getShowHover()
If
this.canHover is true, should we show the global hover canvas by default when the user hovers over this
canvas? |
java.lang.Boolean |
getShowHoverComponents()
When set to true, shows a widget hovering at the mouse point instead of the builtin hover label.
|
java.lang.Boolean |
getShowPointer()
Should a pointer be shown? A pointer can be placed on the border to identify the target of the canvas contents.
|
java.lang.Boolean |
getShowResizeBar()
When this Canvas is included as a member in a
Layout , whether a resizeBar
should be shown after this member in the layout, to allow it to be resized. |
java.lang.Boolean |
getShowShadow()
Whether to show a drop shadow for this Canvas.
|
java.lang.Boolean |
getShowSnapGrid()
Whether to show a snap grid for this Canvas.
|
boolean |
getShrinkElementOnHide()
This is an advanced setting.
|
java.lang.Boolean |
getSizeMayChangeOnRedraw()
Is it possible that a call to
redraw() on this widget will change its
size? |
java.lang.String |
getSkinImgDir()
Default directory for skin images (those defined by the class), relative to the Page-wide
skinDir . |
Canvas[] |
getSnapAlignCandidates()
When
childrenSnapAlign is enabled, list of candidates to
check for alignment. |
java.lang.String |
getSnapAlignCenterLineStyle()
CSS border declaration used for the line shown to indicate snapping to a center line when
childrenSnapAlign is set. |
java.lang.String |
getSnapAlignEdgeLineStyle()
CSS border declaration used for the line shown to indicate snapping to a edge line when
childrenSnapAlign is set. |
java.lang.String |
getSnapAxis()
Describes which axes to apply snap-to-grid to.
|
java.lang.String |
getSnapEdge()
If
snapTo is defined to this widget, this property can be used to
define which edge of this widget should be snapped to an edge of the master or parent element. |
DrawLine |
getSnapGridLineProperties()
Specifies line styling to use when drawing the grid of lines for
SnapGridStyle :
"lines". |
SnapGridStyle |
getSnapGridStyle()
Specifies indication style to use for snap points, either a grid of lines or an array of crosses.
|
java.lang.String |
getSnapHDirection()
The horizontal snap direction.
|
int |
getSnapHGap()
The horizontal grid size to use, in pixels, when snap-to-grid is enabled.
|
java.lang.Integer |
getSnapOffsetLeft()
If
snapTo is defined for this widget, this property can be used to
specify an offset in px or percentage for the left coordinate of this widget. |
java.lang.Integer |
getSnapOffsetTop()
If
snapTo is defined for this widget, this property can be used to
specify an offset in px or percentage for the top coordinate of this widget. |
java.lang.Boolean |
getSnapOnDrop()
When this canvas is dropped onto an object supporting snap-to-grid, should it snap to the grid (true, the default) or
just drop wherever the mouse is (false).
|
static Point |
getSnapPosition(Canvas target,
java.lang.String snapTo,
Canvas snapper)
Return the position for
snapper to be placed in order to "snap to" an edge or corner of
target , in the same sense as snapTo . |
static Point |
getSnapPosition(Canvas target,
java.lang.String snapTo,
Canvas snapper,
java.lang.String snapEdge)
Return the position for
snapper to be placed in order to "snap to" an edge or corner of
target , in the same sense as snapTo . |
java.lang.Boolean |
getSnapResizeToAlign()
Flag to disable snapping to alignment when this Canvas is resized.
|
java.lang.Boolean |
getSnapResizeToGrid()
Causes this canvas to snap to its parent's grid when resizing.
|
java.lang.String |
getSnapTo()
Position this widget such that it is aligned with ("snapped to") an edge of its
master (if specified), or its parent canvas . |
java.lang.Boolean |
getSnapToAlign()
Flag to disable snapping to alignment when this Canvas is dragged when
childrenSnapAlign is enabled on this Canvas' parent. |
java.lang.Boolean |
getSnapToCenterAlign()
Flag to disable snapping to center alignment when this Canvas is dragged when
childrenSnapAlign is enabled on this Canvas' parent. |
java.lang.Boolean |
getSnapToEdgeAlign()
Flag to disable snapping to edge alignment when this Canvas is dragged when
childrenSnapAlign is enabled on this Canvas' parent. |
java.lang.Boolean |
getSnapToGrid()
Causes this canvas to snap to its parent's grid when dragging.
|
java.lang.String |
getSnapVDirection()
The vertical snap direction.
|
int |
getSnapVGap()
The vertical grid size to use, in pixels, when snap-to-grid is enabled.
|
java.lang.Boolean |
getStartLine()
Whether this canvas should always start a new line when used as a tile in a
FlowLayout . |
java.lang.String |
getStyleName()
The CSS class applied to this widget as a whole.
|
java.lang.Integer |
getTabIndex()
If specified this governs the tabIndex of the widget in the page's tab order.
|
DataContext |
getTestDataContext()
A
DataContext to be used if no dataContext is provided (directly or indirectly via a parent). |
protected Canvas |
getTestInstance() |
java.lang.String |
getTitle()
Synonym for
getPrompt() |
java.lang.String |
getTooltip()
Synonym for
getPrompt() |
int |
getTop()
Number of pixels the top of the widget is offset down from its default drawing context (either its parent's top-left
corner, or the document flow, depending on the value of the
position property). |
java.lang.String |
getTopAsString()
Number of pixels the top of the widget is offset down from its default drawing context (either its parent's top-left
corner, or the document flow, depending on the value of the
position property). |
Canvas |
getTopElement()
The top-most Canvas (i.e., not a child of any other Canvas), if any, in this widget's containment hierarchy.
|
java.util.Map |
getUISummary(java.lang.String[] heirarchyExcluded,
java.lang.String[] thisCanvasExcluded)
Returns a summary of this canvas and its child canvii and/or fields that is useful to an AI in understanding the
hierarchy.
|
boolean |
getUpdateTabPositionOnDraw()
Should canvases with no
parent canvas be moved to the end of
the TabIndexManager tree on draw()? |
boolean |
getUpdateTabPositionOnReparent()
Should canvases with a
parent canvas be added to the
TabIndexManager under the parent as described in updateChildTabPositions() and updateChildTabPosition() ? |
java.lang.Boolean |
getUseBackMask()
In earlier versions of Internet Explorer (pre IE9), a native limitation exists whereby if HTML elements are overlapping
on the page, certain elements can appear to "burn through" elements in the same position with a higher z-index.
|
boolean |
getUseCSSShadow()
If
showShadow is true, should we use the css
box-shadow property (where supported) to achieve the shadow? |
boolean |
getUseDragMask()
This flag controls whether we register the component as a maskable item with the EventHandler.
|
boolean |
getUseImageForSVG()
If set, forces the main SVG image or icon in the canvas to be rendered in an image tag rather than an object tag, the
default.
|
java.lang.Boolean |
getUseNativeDrag()
If set, native HTML5 drag and drop will be used for all drags initiated on this widget (on browsers where this is
supported), and native HTML5 drop events occurring over this widget will be processed.
|
java.lang.Boolean |
getUseOpacityFilter()
Configures where the Opacity filter is used for IE6-8.
|
java.lang.Boolean |
getUseTouchScrolling()
On
touch devices , if this Canvas can be scrolled, should
touch-dragging the content area result in scrolling? Set to false if touch-dragging should not cause
scrolling. |
ValuesManager |
getValuesManager()
ValuesManager for managing values displayed in this component. |
java.lang.String |
getValuesManagerAsString()
ValuesManager for managing values displayed in this component. |
int |
getViewportHeight()
Returns the height of the viewport onto the scrollable content.
|
int |
getViewportWidth()
Returns the width of the viewport onto the scrollable content.
|
Visibility |
getVisibility()
Controls widget visibility when the widget is initialized.
|
int |
getVisibleHeight()
Return the visible height of the Canvas.
|
AdvancedCriteria |
getVisibleWhen()
Criteria to be evaluated to determine whether this Canvas should be visible.
|
int |
getVisibleWidth()
Return the visible width of the Canvas.
|
int |
getVSnapPosition(int coordinate)
Override this method to provide a custom snap-to grid.
|
int |
getVSnapPosition(int coordinate,
java.lang.String direction)
Override this method to provide a custom snap-to grid.
|
java.lang.Integer |
getWidth()
The
canvas.width attribute specifies the size for a component's horizontal dimension;
canvas.height specifies the size for the vertical dimension. |
java.lang.String |
getWidthAsString() |
Process[] |
getWorkflows()
List of screen-global
workflows that can be shared by event handler
workflows using a StartProcessTask . |
int |
getZIndex()
Get the z-Index of this canvas.
|
int |
getZIndex(boolean resolveToNumber)
Get the z-Index of this canvas.
|
void |
handleHover()
Handler fired on a delay when the user hovers the mouse over this hover-target.
|
void |
hide()
Sets the widget's CSS visibility attribute to "hidden".
|
void |
hideClickMask()
Hides the click mask associated with this canvas.
|
void |
hideClickMask(java.lang.String ID)
Hides the click mask associated with this canvas.
|
void |
hideComponentMask()
Hide the
component level clickMask for this widget |
void |
hideComponentMask(boolean suppressFocusReset)
Hide the
component level clickMask for this widget |
void |
hideContextMenu()
The default implementation of this method hides the contextMenu currently being shown for this component (which occurs
when the mouse button that toggles the context menu is released).
|
static java.lang.String |
imgHTML(java.lang.String src)
Generates the HTML for an image unique to this Canvas.
|
static java.lang.String |
imgHTML(java.lang.String src,
int width,
int height) |
static java.lang.String |
imgHTML(java.lang.String src,
int width,
int height,
java.lang.String name,
java.lang.String extraStuff,
java.lang.String imgDir)
Generates the HTML for an image unique to this Canvas.
|
void |
initComplete()
Notification method fired after
initWidget() , when canvas
initialization is complete. |
java.lang.Boolean |
intersects(Canvas other)
Returns true if the rectangles of this widget and the specified widget overlap.
|
java.lang.Boolean |
isDirty()
Returns whether a canvas is waiting to be redrawn.
|
java.lang.Boolean |
isDisabled()
Is this canvas disabled? Note that the disabled state is inherited - this method will return true if this widget, or any
of its ancestors are marked disabled.
|
java.lang.Boolean |
isFocused()
Returns true if this Canvas has the keyboard focus.
|
boolean |
isVisible()
Returns true if the widget is visible, taking all parents into account, so that a widget which is not hidden
might still report itself as not visible if it is within a hidden parent.
|
java.lang.Boolean |
keyUp()
Executed when a key is released on a focusable widget (
canFocus :
true). |
void |
layoutChildren(java.lang.String reason)
layoutChildren() is where a Canvas should implement a sizing policy for it's Canvas children. |
java.lang.String |
linkHTML(java.lang.String href)
Generates the HTML for a standard link (anchor) element.
|
java.lang.String |
linkHTML(java.lang.String href,
java.lang.String text) |
java.lang.String |
linkHTML(java.lang.String href,
java.lang.String text,
java.lang.String target) |
java.lang.String |
linkHTML(java.lang.String href,
java.lang.String text,
java.lang.String target,
java.lang.String ID) |
java.lang.String |
linkHTML(java.lang.String href,
java.lang.String text,
java.lang.String target,
java.lang.String ID,
java.lang.Integer tabIndex) |
java.lang.String |
linkHTML(java.lang.String href,
java.lang.String text,
java.lang.String target,
java.lang.String ID,
java.lang.Integer tabIndex,
java.lang.String accessKey)
Generates the HTML for a standard link (anchor) element.
|
void |
markForDestroy()
destroy() this canvas on a timeout. |
void |
markForRedraw()
Marks the widget as "dirty" so that it will be added to a queue for redraw.
|
void |
markForRedraw(java.lang.String reason)
Marks the widget as "dirty" so that it will be added to a queue for redraw.
|
void |
moveAbove(Canvas canvas)
Puts this widget just above the specified widget in the stacking order, so it appears in front of the specified widget
if both widgets have the same parent.
|
void |
moveBelow(Canvas canvas)
Puts this widget just below the specified widget in the stacking order, so it appears behind the specified widget if
both widgets have the same parent.
|
java.lang.Boolean |
moveBy(int deltaX,
int deltaY)
Moves the widget deltaX pixels to the right and deltaY pixels down.
|
boolean |
moveTo(int left,
int top)
Moves the widget so that its top-left corner is at the specified coordinates.
|
protected void |
onAttach() |
protected void |
onDetach() |
protected void |
onInit() |
void |
pageScrollDown()
This method is the programmatic equivalent of the user pressing the "Page Down" key while this widget has the focus.
|
void |
pageScrollUp()
This method is the programmatic equivalent of the user pressing the "Page Up" key while this widget has the focus.
|
protected void |
parentResized()
Fires when the interior size of the parent changes, including parent resize and scrollbar introduction or removal.
|
void |
placeNear()
Move this canvas to the specified point, or as close to the specified point as possible without this widget extending
beyond the edge of the browser viewport on any side.
|
void |
placeNear(int left) |
void |
placeNear(int left,
int top)
Move this canvas to the specified point, or as close to the specified point as possible without this widget extending
beyond the edge of the browser viewport on any side.
|
void |
print()
Generate and show a
PrintWindow containing a PrintCanvas showing a printable view of this component. |
void |
print(PrintProperties printProperties) |
void |
print(PrintProperties printProperties,
PrintWindow printWindowProperties) |
void |
print(PrintProperties printProperties,
PrintWindow printWindowProperties,
java.lang.String callback)
Generate and show a
PrintWindow containing a PrintCanvas showing a printable view of this component. |
static void |
printComponents(java.lang.Object[] components)
Generate printable HTML for the designated components and trigger the native print dialog, without ever showing the
printable HTML to the user.
|
void |
provideRuleContext(java.lang.String dataPath,
java.lang.Object data)
Provide data to the
com.smartgwt.client.widgets.Canvas#ruleScope component,
to be made available in the rule context at the specified path . |
void |
provideRuleContext(java.lang.String dataPath,
java.lang.Object data,
DataBoundComponent dbc)
Provide data to the
com.smartgwt.client.widgets.Canvas#ruleScope component,
to be made available in the rule context at the specified path . |
void |
redraw()
Redraws the widget immediately with its current property values.
|
void |
redraw(java.lang.String reason)
Redraws the widget immediately with its current property values.
|
static void |
registerFontScaledPaddingStyles(java.lang.String[] scaledStyles,
java.lang.String[] baselineStyles,
int targetSizeChange)
Registers one or more CSS classes to have their padding adjusted (independently on all edges)
according to the
padding size change applied to the page. |
void |
removeChild(Canvas child)
Remove a child from this parent.
|
void |
removeChild(Canvas child,
java.lang.String name)
Remove a child from this parent.
|
void |
removePeer(Canvas peer)
Remove a peer from this Canvas
|
void |
removePeer(Canvas peer,
java.lang.String name)
Remove a peer from this Canvas
|
void |
removeRuleContext(java.lang.String path)
Remove data in the rule context at the specified
path along with any user-provided schema. |
void |
removeSnapAlignCandidate(Canvas candidate)
Remove a candidate from
snapAlignCandidates . |
static void |
resizeAutoChildAttributes(java.lang.String policy,
int delta)
Change the value of attributes registered via
registerAutoChildSizingAttributes() by some number
of pixels. |
java.lang.Boolean |
resizeBy(int deltaX,
int deltaY)
Resizes the widget, adding deltaX to its width and deltaY to its height (moves the right and/or bottom sides of
the widget).
|
static void |
resizeControls(int delta)
Change the basic size of UI components in the current skin by "delta" pixels.
|
static void |
resizeControlsTo(int targetDelta)
Resizes controls as if calling
resizeControls() , but takes a
final target size instead of a delta representing the change from a current size. |
static void |
resizeFonts(int sizeChange)
Modify the size of fonts for some or all stylesheets defined in the page.
|
static void |
resizeFonts(int sizeChange,
java.lang.String styleSheets) |
static void |
resizeFonts(int sizeChange,
java.lang.String styleSheets,
java.lang.Boolean resizeRelatedControls)
Modify the size of fonts for some or all stylesheets defined in the page.
|
static void |
resizeFontsTo(int targetDelta)
Resizes fonts as if calling
resizeFonts() , but takes a final
target size instead of a delta representing the change from a current size. |
static void |
resizeIcons(java.lang.String policy,
int delta)
Change the basic size of icons in the current skin by "delta" pixels.
|
static void |
resizePadding(int fontSizeChange)
Modify the amount of padding for some CSS styles defined for the page.
|
static void |
resizePadding(int fontSizeChange,
java.lang.String styleSheets)
Modify the amount of padding for some CSS styles defined for the page.
|
java.lang.Boolean |
resizeTo(int width,
int height)
Resizes the widget to the specified width and height (moves the right and/ or bottom sides of the widget).
|
java.lang.Boolean |
resizeTo(java.lang.String width,
java.lang.String height)
Resizes the widget to the specified width and height (moves the right and/ or bottom sides of the widget).
|
void |
revealChild(Canvas child)
Reveals the child Canvas passed in by showing it if it is currently hidden (note, this is stub functionality,
certain Canvas subclasses such as
TabSet have more useful implementations)
NOTE: This is an override point. |
void |
revealChild(java.lang.String childID)
Reveals the child Canvas passed in by showing it if it is currently hidden (note, this is stub functionality,
certain Canvas subclasses such as
TabSet have more useful implementations)
NOTE: This is an override point. |
void |
scrollBy(int dX,
int dY)
Scroll this widget by some pixel increment in either (or both) direction(s).
|
void |
scrollByPercent(int dX,
int dY)
Scroll this widget by some percentage of scroll size in either (or both) direction(s).
|
void |
scrollTo()
Scrolls the content of the widget so that the origin (top-left corner) of the content is left pixels to the left and top
pixels above the widget's top-left corner (but still clipped by the widget's dimensions).
|
void |
scrollTo(java.lang.Integer left) |
void |
scrollTo(java.lang.Integer left,
java.lang.Integer top)
Scrolls the content of the widget so that the origin (top-left corner) of the content is left pixels to the left and top
pixels above the widget's top-left corner (but still clipped by the widget's dimensions).
|
void |
scrollToBottom()
Vertically scrolls the content of the widget to the end of its content
|
void |
scrollToLeft()
Horizontally scrolls the content of the widget to 0
|
void |
scrollToPercent(int left,
int top)
Scroll this widget to some position specified as a percentage of scroll size in either (or both) direction(s).
|
void |
scrollToRight()
Horizontally scrolls the content of the widget to the end of its content
|
void |
scrollToTop()
Vertically scrolls the content of the widget to 0
|
void |
sendToBack()
Puts this widget at the bottom of the stacking order, so it appears behind all other widgets in the same parent.
|
Canvas |
setAccessKey(java.lang.String accessKey)
If specified this governs the HTML accessKey for the widget.
|
Canvas |
setAdaptHeightByCustomizer(AdaptHeightByCustomizer customizer)
Set customizer that defines
adaptHeightBy . |
Canvas |
setAdaptiveHeightPriority(java.lang.Integer adaptiveHeightPriority)
|
Canvas |
setAdaptiveWidthPriority(java.lang.Integer adaptiveWidthPriority)
If multiple widgets in the same Layout have
adaptive width ,
adaptiveWidthPriority can be set to indicate which of the components should be given priority access to
space. |
Canvas |
setAdaptWidthByCustomizer(AdaptWidthByCustomizer customizer)
Set customizer that defines
adaptWidthBy . |
Canvas |
setAlign(Alignment align) |
static void |
setAllowExternalFilters(boolean allExternalFilters)
Changes the system-wide
allowExternalFilters setting. |
Canvas |
setAlwaysManageFocusNavigation(java.lang.Boolean alwaysManageFocusNavigation)
Should focus navigation for this canvas and its descendents be handled explicitly by intercepting "Tab" key events and
calling the
TabIndexManager.shiftFocus() API? |
Canvas |
setAlwaysShowScrollbars(java.lang.Boolean alwaysShowScrollbars)
Should this browser always show custom scrollbars if
showCustomScrollbars is true? |
Canvas |
setAnimateAcceleration(AnimationAcceleration animateAcceleration)
Default acceleration effect to apply to all animations on this Canvas.
|
Canvas |
setAnimateFadeTime(java.lang.Integer animateFadeTime)
Default time for performing an animated fade.
|
Canvas |
setAnimateHideAcceleration(AnimationAcceleration animateHideAcceleration)
Default acceleration function for performing an animated hide.
|
Canvas |
setAnimateHideEffect(AnimationEffect animateHideEffect)
Default animation effect to use if
animateHide() is called without an explicit effect parameter. |
Canvas |
setAnimateHideTime(java.lang.Integer animateHideTime)
Default time for performing an animated hide.
|
Canvas |
setAnimateMoveAcceleration(AnimationAcceleration animateMoveAcceleration)
Default acceleration effect for performing an animated move.
|
Canvas |
setAnimateMoveTime(java.lang.Integer animateMoveTime)
Default time for performing an animated move.
|
Canvas |
setAnimateRectAcceleration(AnimationAcceleration animateRectAcceleration)
Default acceleration function for performing an animated move and resize.
|
Canvas |
setAnimateRectTime(java.lang.Integer animateRectTime)
Default time for performing an animated setRect.
|
Canvas |
setAnimateResizeAcceleration(AnimationAcceleration animateResizeAcceleration)
Default acceleration function for performing an animated resize.
|
Canvas |
setAnimateResizeLayoutMode(AnimationLayoutMode animateResizeLayoutMode)
When to update the
child layout for a size animation . |
Canvas |
setAnimateResizeTime(java.lang.Integer animateResizeTime)
Default time for performing an animated resize.
|
Canvas |
setAnimateScrollAcceleration(AnimationAcceleration animateScrollAcceleration)
Default acceleration function for performing an animated scroll.
|
Canvas |
setAnimateScrollTime(java.lang.Integer animateScrollTime)
Default time for performing an animated scroll.
|
Canvas |
setAnimateShowAcceleration(AnimationAcceleration animateShowAcceleration)
Default acceleration function for performing an animated show.
|
Canvas |
setAnimateShowEffect(AnimationEffect animateShowEffect)
Default animation effect to use if
animateShow() is called without an explicit effect parameter. |
Canvas |
setAnimateShowTime(java.lang.Integer animateShowTime)
Default time for performing an animated show.
|
Canvas |
setAnimateTime(int animateTime)
Default total duration of animations.
|
Canvas |
setAppImgDir(java.lang.String appImgDir)
Default directory for app-specific images, relative to the Page-wide
appImgDir . |
Canvas |
setAriaRole(java.lang.String ariaRole)
ARIA role of this component.
|
Canvas |
setAriaState(java.lang.String stateName,
java.lang.Object stateValue)
Set a specific ARIA state mapping for this component.
|
Canvas |
setAutoChildConstructor(java.lang.String autoChildName,
java.lang.String className)
Sets the SmartClient constructor for the AutoChild named
autoChildName . |
Canvas |
setAutoChildProperties(java.lang.String autoChildName,
Canvas properties)
Sets the properties for creating a
Canvas AutoChild named autoChildName . |
Canvas |
setAutoChildProperties(java.lang.String autoChildName,
EditContext properties)
Sets the properties for creating an AutoChild named
autoChildName . |
Canvas |
setAutoChildProperties(java.lang.String autoChildName,
EditProxy properties)
Sets the properties for creating an AutoChild named
autoChildName . |
Canvas |
setAutoChildProperties(java.lang.String autoChildName,
FormItem properties)
Sets the properties for creating a
FormItem AutoChild named autoChildName . |
Canvas |
setAutoChildVisibility(java.lang.String autoChildName,
boolean visible)
Sets whether to create and show the AutoChild named
autoChildName . |
Canvas |
setAutoHeight()
Set the minimum value for height.
|
Canvas |
setAutoMaskComponents(java.lang.Boolean autoMaskComponents)
Deprecated.
As of Smart GWT version 10.0, deprecated in favor of
EditProxy.autoMaskChildren |
Canvas |
setAutoParent(java.lang.String autoParent)
This initialization property allows developers to create a canvas using the Class.addAutoChild() method, and have it
added as a child to some other component.
|
Canvas |
setAutoPopulateData(java.lang.Boolean autoPopulateData)
If a
dataContext is provided, should subcomponents
automatically bind to the data? |
static void |
setAutoResizeAutoChildAttributes(boolean autoResize)
|
static void |
setAutoResizeIcons(boolean autoResizeIcons)
|
Canvas |
setAutoShowParent(java.lang.Boolean autoShowParent)
If set to true, the widget's parent (if any) will automatically be shown whenever the widget is shown.
|
Canvas |
setAutoWidth()
Set the minimum value for width.
|
Canvas |
setBackgroundColor(java.lang.String backgroundColor)
The background color for this widget.
|
Canvas |
setBackgroundImage(java.lang.String backgroundImage)
URL for a background image for this widget (corresponding to the CSS "background-image" attribute).
|
Canvas |
setBackgroundPosition(java.lang.String backgroundPosition)
Specifies how the background image should be positioned on the widget.
|
Canvas |
setBackgroundRepeat(BackgroundRepeat backgroundRepeat)
Specifies how the background image should be tiled if this widget is larger than the image.
|
Canvas |
setBorder(java.lang.String border)
Set the CSS border of this component, as a CSS string including border-width, border-style, and/or color (eg "2px solid
blue").
|
Canvas |
setBorderRadius(java.lang.String borderRadius)
The CSS border-radius for this widget.
|
void |
setBottom(int bottom)
Resizes the widget vertically to position its bottom edge at the specified coordinate.
|
Canvas |
setCanAcceptDrop(java.lang.Boolean canAcceptDrop)
Indicates that this object can receive dropped widgets (i.e.
|
Canvas |
setCanAdaptHeight(java.lang.Boolean canAdaptHeight)
See
canAdaptWidth . |
Canvas |
setCanAdaptWidth(java.lang.Boolean canAdaptWidth)
Indicates that this component is able to render itself at multiple possible sizes, in order to fit into less space when
very little space is available, or to display more information or provide more immediate access to functionality when
more space is available.
|
Canvas |
setCanDrag(java.lang.Boolean canDrag)
Indicates whether this widget can initiate custom drag-and-drop operations (other than reposition or resize).
|
Canvas |
setCanDragReposition(java.lang.Boolean canDragReposition)
Indicates whether this widget can be moved by a user of your application by simply dragging with the mouse.
|
Canvas |
setCanDragResize(java.lang.Boolean canDragResize)
Indicates whether this widget can be resized by dragging on the edges and/or corners of the widget with the mouse.
|
Canvas |
setCanDragScroll(boolean canDragScroll)
If this Canvas is canAcceptDrop:true, when the user drags a droppable widget over an edge of the widget, should we
scroll to show the rest of the widget's content? Returned from canvas.shouldDragScroll() if there are scrollbars.
|
Canvas |
setCanDrop(java.lang.Boolean canDrop)
Indicates that this object can be dropped on top of other widgets.
|
Canvas |
setCanDropBefore(java.lang.Boolean canDropBefore)
When explicitly set to false, disallows drop before this member in the Layout.
|
Canvas |
setCanFocus(java.lang.Boolean canFocus)
Can this widget be allowed to become the target of keyboard events?
|
Canvas |
setCanHover(java.lang.Boolean canHover)
Will this Canvas fire hover events when the user hovers over it, or one of its children?
|
Canvas |
setCanSelectText(java.lang.Boolean canSelectText)
Whether native drag selection of contained text is allowed within this Canvas.
|
Canvas |
setChildren(Canvas... children)
Array of all Canvii that are immediate children of this Canvas.
|
Canvas |
setChildrenResizeSnapAlign(java.lang.Boolean childrenResizeSnapAlign)
Flag to disable snapping to alignment when children of this Canvas are resized
|
Canvas |
setChildrenSnapAlign(java.lang.Boolean childrenSnapAlign)
If enabled while
childrenSnapToGrid is enabled,
children dragged within this Canvas will also snap to positions where their edges or center lines would be aligned with
the edges or centers of other components, and lines will be shown to point out the possible alignment (with appearance
controlled by snapAlignCenterLineStyle and snapAlignEdgeLineStyle respectively. |
Canvas |
setChildrenSnapCenterAlign(java.lang.Boolean childrenSnapCenterAlign)
See
childrenSnapAlign . |
Canvas |
setChildrenSnapEdgeAlign(java.lang.Boolean childrenSnapEdgeAlign)
See
childrenSnapAlign . |
Canvas |
setChildrenSnapResizeToGrid(java.lang.Boolean childrenSnapResizeToGrid)
If true, causes this canvas's children to snap to its grid when resizing.
|
Canvas |
setChildrenSnapToGrid(java.lang.Boolean childrenSnapToGrid)
If true, causes this canvas's children to snap to its grid when dragging.
|
Canvas |
setComponentMaskDefaults(Canvas componentMaskDefaults)
Defaults for the
componentMask autoChild. |
Canvas |
setContents(java.lang.String contents)
The contents of a canvas or label widget.
|
Canvas |
setContextMenu(Menu contextMenu)
Context menu to show for this object, an instance of the Menu widget.
|
Canvas |
setCorrectZoomOverflow(java.lang.Boolean correctZoomOverflow)
Whether the Framework should correct for erroneous scrollHeight and scrollWidth values reported by the browser when
zoomed (via browser or OS-level zoom) by allowing
maxZoomOverflowError of overflow before enabling scrolling and displaying custom scrollbars. |
Canvas |
setCursor(Cursor cursor)
Specifies the css cursor image to
display when the mouse pointer is over this component.
|
Canvas |
setDataContext(DataContext dataContext)
A mapping from
DataSource IDs to specific Records from those DataSources, that DataBoundComponents
contained within this Canvas should automatically bind to if a DataSource is provided but data is not provided (directly
or indirectly, for example, indirectly via setting ListGrid.autoFetchData . |
Canvas |
setDataPath(java.lang.String dataPath)
A dataPath may be specified on any canvas.
|
Canvas |
setDefaultHeight(int defaultHeight)
For custom components, establishes a default height for the component.
|
static void |
setDefaultPageSpace(int newDefaultPageSpace)
Changes the global
defaultPageSpace . |
static void |
setDefaultProperties(Canvas canvasProperties)
Class level method to set the default properties of this class.
|
static Canvas |
setDefaultShowCustomScrollbars(boolean showCS)
Whether to use the browser's native scrollbars or SmartClient-based scrollbars by default
for all canvases.
|
Canvas |
setDefaultWidth(int defaultWidth)
For custom components, establishes a default width for the component.
|
Canvas |
setDefiningProperty(java.lang.String definingProperty)
This attribute denotes the name of a property to use as a
getDefiningPropertyName() for this property when generating
and resolving AutoTest locators with search segments . |
Canvas |
setDefiningPropertyNameOptions(java.lang.String... definingPropertyNameOptions)
If no explicit
definingProperty was specified for this
component,
this array denotes a list of options to use as a
defining property when generating and resolving
AutoTest locators with search segments . |
Canvas |
setDisabled(boolean disabled)
If set to true, the widget will be disabled.
|
Canvas |
setDisabledCursor(Cursor disabledCursor)
Specifies the cursor image to display when the mouse pointer is over this widget if this widget is disabled.
|
Canvas |
setDisableTouchScrollingForDrag(java.lang.Boolean disableTouchScrollingForDrag)
Disables
useTouchScrolling whenever a built-in drag
operation has been enabled which is known to be non-functional if touch scrolling is enabled. |
Canvas |
setDoubleClickDelay(int doubleClickDelay)
Amount of time (in milliseconds) between which two clicks are considered a single click
|
Canvas |
setDragAppearance(DragAppearance dragAppearance)
Visual appearance to show when the object is being dragged.
|
Canvas |
setDragIntersectStyle(DragIntersectStyle dragIntersectStyle)
This indicates how the system will test for droppable targets: either by intersection with the mouse or intersection
with the rectangle of the dragMoveTarget.
|
Canvas |
setDragMaskType(DragMaskType dragMaskType)
This property controls what kind of mask is used in case
useDragMask is enabled. |
Canvas |
setDragMaxHeight(int dragMaxHeight)
Sets maximum height that this Canvas can be resized to by a user.
|
Canvas |
setDragMaxWidth(int dragMaxWidth)
Maximum width that this Canvas can be resized to by a user.
|
Canvas |
setDragMinHeight(int dragMinHeight)
Minimum height that this Canvas can be resized to by a user.
|
Canvas |
setDragMinWidth(int dragMinWidth)
Minimum width that this Canvas can be resized to by a user.
|
Canvas |
setDragOpacity(java.lang.Integer dragOpacity)
If this widget has dragAppearance
"target" , this value specifies the opacity to render the target while it
is being dragged. |
Canvas |
setDragRepositionAppearance(DragAppearance dragRepositionAppearance)
If
canDragReposition is true, this attribute specifies
the visual appearance to show during drag reposition. |
Canvas |
setDragRepositionCursor(Cursor dragRepositionCursor)
Cursor to switch to if the mouse is over a widget that is drag repositionable.
|
Canvas |
setDragResizeAppearance(DragAppearance dragResizeAppearance)
If
canDragResize is true, this attribute specifies the
visual appearance to show during drag resize. |
Canvas |
setDragScrollDelay(int dragScrollDelay)
If this widget supports drag-scrolling, This property specifies how many ms the user must hover over the
drag-scroll threshold before scrolling begins.
|
Canvas |
setDragStartDistance(int dragStartDistance)
Number of pixels the cursor needs to move before the EventHandler starts a drag operation.
|
Canvas |
setDragTarget(Canvas dragTarget)
A different widget that should be actually dragged when dragging initiates on this widget.
|
Canvas |
setDragTarget(java.lang.String dragTarget)
A different widget that should be actually dragged when dragging initiates on this widget.
|
Canvas |
setDragType(java.lang.String dragType)
Sets a
dragType for this widget used, to be compared to dropTypes on possible drop target widgets. |
Canvas |
setDropTarget(Canvas dropTarget)
Delegates a different widget that should actually be dropped on if the cursor is over this widget when the drop
completes.
|
Canvas |
setDropTarget(java.lang.String dropTarget)
Delegates a different widget that should actually be dropped on if the cursor is over this widget when the drop
completes.
|
Canvas |
setDropTypes(java.lang.String... dropTypes)
When a drag and drop interaction occurs, if a
dragType is
configured on the source widget, it is compared to the dropTypes configured on the target widget, and a
drop is only allowed if the dragType is listed in the target widget's dropTypes array. |
Canvas |
setDropTypes(java.lang.String dropTypes)
When a drag and drop interaction occurs, if a
dragType is
configured on the source widget, it is compared to the dropTypes configured on the target widget, and a
drop is only allowed if the dragType is listed in the target widget's dropTypes array. |
Canvas |
setDynamicContents(java.lang.Boolean dynamicContents)
Dynamic contents allows the contents string to be treated as a simple but powerful template.
|
Canvas |
setEdgeBackgroundColor(java.lang.String edgeBackgroundColor)
Background color for the EdgedCanvas created to decorate this component.
|
Canvas |
setEdgeCenterBackgroundColor(java.lang.String edgeCenterBackgroundColor)
Background color for the center section only.
|
Canvas |
setEdgeImage(java.lang.String edgeImage)
Base name of images for edges.
|
Canvas |
setEdgeMarginSize(int edgeMarginSize)
How far into the edge of an object do we consider the "edge" for drag resize purposes?
|
Canvas |
setEdgeOffset(java.lang.Integer edgeOffset)
Amount the contained Canvas should be offset.
|
Canvas |
setEdgeOpacity(java.lang.Integer edgeOpacity)
Opacity of the edges.
|
Canvas |
setEdgeShowCenter(java.lang.Boolean edgeShowCenter)
Whether to show media in the center section, that is, behind the decorated Canvas.
|
Canvas |
setEdgeSize(int edgeSize)
Size in pixels for corners and edges
|
void |
setEditMode(boolean editingOn)
Enable or disable edit mode for this component.
|
void |
setEditMode(boolean editingOn,
EditContext editContext) |
void |
setEditMode(boolean editingOn,
EditContext editContext,
EditNode editNode)
Enable or disable edit mode for this component.
|
Canvas |
setEditProxyConstructor(java.lang.String editProxyConstructor)
Default class used to construct the
EditProxy for this component when the component is
first placed into edit mode . |
protected void |
setElement(com.google.gwt.user.client.Element elem)
Normal usage of SmartGWT is to call draw() on SmartGWT widgets, not to use use RootPanel.add().
|
Canvas |
setEnableWhen(AdvancedCriteria enableWhen)
Criteria to be evaluated to determine whether this Canvas should be enabled.
|
Canvas |
setEndLine(java.lang.Boolean endLine)
Whether this canvas should end the line it's in when used as a tile in a
FlowLayout . |
Canvas |
setExtraSpace(int extraSpace)
When this Canvas is included as a member in a Layout, extra blank space that should be left after this member in a
Layout.
|
Canvas |
setFacetId(java.lang.String facetId)
If a Canvas is dropped onto a
CubeGrid , and it has a facetId property specified then
the Cube treats this as adding that facetId at the drop location. |
Canvas |
setFloatingScrollbars(boolean floatingScrollbars)
If
showCustomScrollbars is true, should the
scrollbars be drawn floating over the component handle, or should the handle shrink to accommodate them? |
Canvas |
setForwardSVGeventsToObject(java.lang.Boolean forwardSVGeventsToObject)
If true, events sent to the SVG inside an object tag are forwarded to the object itself by Framework handlers.
|
Canvas |
setGroupBorderCSS(java.lang.String groupBorderCSS)
Sets the style for the grouping frame around the canvas.
|
Canvas |
setGroupLabelBackgroundColor(java.lang.String groupLabelBackgroundColor)
If set, the background color of the grouping label.
|
Canvas |
setGroupLabelStyleName(java.lang.String groupLabelStyleName)
Sets the style for the grouping label.
|
Canvas |
setGroupPadding(java.lang.Integer groupPadding)
Padding to apply inside the border when this canvas is showing a group
border and label . |
Canvas |
setGroupTitle(java.lang.String groupTitle)
The title/label for the grouping.
|
Canvas |
setHeight(int height) |
Canvas |
setHeight(java.lang.Integer height)
The
canvas.width attribute specifies the size for a component's horizontal dimension;
canvas.height specifies the size for the vertical dimension. |
void |
setHeight(java.lang.String height)
The
canvas.width attribute specifies the size for a component's horizontal dimension;
canvas.height specifies the size for the vertical dimension. |
Canvas |
setHeight100()
Convenience method that sets the height to 100%.
|
Canvas |
setHideUsingDisplayNone(boolean hideUsingDisplayNone)
When this widget is hidden (see
visibility and hide() ), should display:none be applied to the outer element ? |
Canvas |
setHoverAlign(Alignment hoverAlign)
If
this.showHover is true, this property can be used to customize the alignment of content in the hover
canvas. |
Canvas |
setHoverAutoDestroy(java.lang.Boolean hoverAutoDestroy)
If
this.showHover is true and getHoverComponent() is implemented, should the hoverCanvas returned from it be automatically destroyed when it is
hidden? |
Canvas |
setHoverAutoFitMaxWidth(int hoverAutoFitMaxWidth)
Maximum auto-fit width for a hover if
hoverAutoFitWidth
is enabled. |
Canvas |
setHoverAutoFitMaxWidth(java.lang.String hoverAutoFitMaxWidth)
Maximum auto-fit width for a hover if
hoverAutoFitWidth
is enabled. |
Canvas |
setHoverAutoFitWidth(java.lang.Boolean hoverAutoFitWidth)
if
showHover is true, this property will cause the specified
hoverWidth to be treated as a minimum width for the hover. |
Canvas |
setHoverDelay(int hoverDelay)
If
this.canHover is true, how long should the mouse be kept over this widget before the hover event is
fired |
Canvas |
setHoverFocusKey(java.lang.String hoverFocusKey)
For canvases
showing a hover , this attribute gives users a way
to pin the hover in place so they can interact with it (scroll it, click embedded links, etc). |
Canvas |
setHoverHeight(java.lang.Integer hoverHeight)
If
this.showHover is true, this property can be used to customize the height of the hover canvas shown. |
Canvas |
setHoverMoveWithMouse(java.lang.Boolean hoverMoveWithMouse)
If
this.showHover is true, should this widget's hover canvas be moved with the mouse while visible? |
Canvas |
setHoverOpacity(java.lang.Integer hoverOpacity)
If
this.showHover is true, should the hover canvas be shown with opacity other than 100? |
Canvas |
setHoverPersist(HoverPersistMode hoverPersist)
Allows interaction with hovers when the cursor is positioned over them.
|
Canvas |
setHoverScreen(java.lang.String hoverScreen)
Screen to create (via
createScreen() ) in lieu of calling getHoverComponent() . |
Canvas |
setHoverStyle(java.lang.String hoverStyle)
If
this.showHover is true, this property can be used to specify the css style to apply to the hover canvas. |
Canvas |
setHoverVAlign(VerticalAlignment hoverVAlign)
If
this.showHover is true, this property can be used to customize the vertical alignment of content in the
hover canvas. |
Canvas |
setHoverWidth(int hoverWidth)
If
this.showHover is true, this property can be used to
customize the width of the hover canvas shown. |
Canvas |
setHoverWrap(java.lang.Boolean hoverWrap)
If
this.showHover is true, this property can be used to customize the whether content in the hover canvas
is displayed in a single line, or wraps. |
Canvas |
setHtmlElement(com.google.gwt.dom.client.Element htmlElement)
If specified as a pointer to an HTML element present in the DOM, this canvas will be rendered inside that element on
draw() . |
Canvas |
setHtmlElement(java.lang.String htmlElement)
If specified as a pointer to an HTML element present in the DOM, this canvas will be rendered inside that element on
draw() . |
Canvas |
setHtmlPosition(DrawPosition htmlPosition)
If
htmlElement is specified, this attribute specifies the
position where the canvas should be inserted relative to the htmlElement in the DOM. |
void |
setImage(java.lang.String identifier,
java.lang.String URL)
Set the URL of an image or SVG object element by name.
|
void |
setImage(java.lang.String identifier,
java.lang.String URL,
java.lang.String imgDir)
Set the URL of an image or SVG object element by name.
|
void |
setInitHandler(CanvasInitHandler initHandler)
Specify a notification method to fire when this Canvas is initialized in JavaScript.
|
Canvas |
setIsGroup(boolean isGroup)
Should a grouping frame be shown around this canvas if a non-empty string has been specified for
groupTitle . |
Canvas |
setIsRuleScope(java.lang.Boolean isRuleScope)
Marks this Canvas as the
ruleScope that will be discovered by
any contained DataBoundComponent s which do not specify an explicit
ruleScope . |
Canvas |
setIsSnapAlignCandidate(java.lang.Boolean isSnapAlignCandidate)
Flag to disable snapping to alignment against this Canvas when other Canvases dragged into the same parent when
childrenSnapAlign is enabled on this Canvas' parent. |
Canvas |
setKeepInParentRect(java.lang.Boolean keepInParentRect)
Constrains drag-resizing and drag-repositioning of this canvas to either the rect of its parent (if set to true) or an
arbitrary rect based on its parent (if set to a [Left,Top,Width,Height] rect array).
|
Canvas |
setKeepInParentRect(java.lang.Integer... keepInParentRect)
Constrains drag-resizing and drag-repositioning of this canvas to either the rect of its parent (if set to true) or an
arbitrary rect based on its parent (if set to a [Left,Top,Width,Height] rect array).
|
Canvas |
setKeepInParentRect(Rectangle rectangle) |
Canvas |
setLayoutAlign(Alignment layoutAlign)
When this Canvas is included as a member in a Layout, layoutAlign controls alignment on the breadth axis of the layout.
|
Canvas |
setLayoutAlign(VerticalAlignment layoutAlign)
When this Canvas is included as a member in a Layout, layoutAlign controls alignment on the breadth axis of the layout.
|
Canvas |
setLeaveGroupLabelSpace(java.lang.Boolean leaveGroupLabelSpace)
When showing this widget in a
group , should any content be shifted
down so that the group-label doesn't sit in front of it? |
Canvas |
setLeavePageSpace(java.lang.Integer leavePageSpace)
If set, overrides the global
defaultPageSpace . |
Canvas |
setLeft(int left)
Number of pixels the left side of the widget is offset to the right from its default drawing context (either its
parent's topleft corner, or the document flow, depending on the value of the
position property). |
Canvas |
setLeft(java.lang.String left)
Number of pixels the left side of the widget is offset to the right from its default drawing context (either its
parent's topleft corner, or the document flow, depending on the value of the
position property). |
Canvas |
setLocateByIDOnly(boolean locateByIDOnly)
If
true , when retrieving a locator for this component
always return a reference directly to this component by widget ID ,
using the compact format "///canvasID" , ignoring any parent elements and ignoring any configured
testRoot . |
Canvas |
setLocateChildrenBy(LocatorStrategy locateChildrenBy)
Strategy to use when locating children in this canvas from an autoTest locator string.
|
Canvas |
setLocateChildrenType(LocatorTypeStrategy locateChildrenType)
LocatorTypeStrategy to use when finding children within this canvas. |
Canvas |
setLocatePeersBy(LocatorStrategy locatePeersBy)
Strategy to use when locating peers of this canvas from an autoTest locator string.
|
Canvas |
setLocatePeersType(LocatorTypeStrategy locatePeersType)
LocatorTypeStrategy to use when finding peers of this canvas. |
Canvas |
setLocatorName(java.lang.String locatorName)
Local name for referencing this canvas from an autoTest locator string.
|
boolean |
setLocatorParent(Canvas locatorParent,
java.lang.String childName)
This method will set mark the target canvas as the "locator parent" for this canvas, using the specified child name.
|
boolean |
setLocatorParent(Canvas locatorParent,
java.lang.String childName,
java.lang.String attributeName)
This method will set mark the target canvas as the "locator parent" for this canvas, using the specified child name.
|
com.smartgwt.logicalstructure.core.LogicalStructureObject |
setLogicalStructure(com.smartgwt.logicalstructure.widgets.CanvasLogicalStructure s)
Setter implementing the
LogicalStructure interface,
which supports Eclipse's logical structure debugging facility. |
Canvas |
setMargin(java.lang.Integer margin)
Set the CSS Margin, in pixels, for this component.
|
Canvas |
setMatchElement(java.lang.Boolean matchElement)
If
htmlElement is specified, should this canvas be drawn at
the same dimensions as the htmlElement?See also matchElementWidth and matchElementHeight |
Canvas |
setMatchElementHeight(MatchElementSizeMode matchElementHeight)
For canvases with a specified
htmlElement where persistentMatchElement is set to true, how should the
canvas match the element's height? |
Canvas |
setMatchElementWidth(MatchElementSizeMode matchElementWidth)
For canvases with a specified
htmlElement where persistentMatchElement is set to true, how should the
canvas match the element's width? |
Canvas |
setMaxHeight(int maxHeight)
Maximum height available to this Canvas.
|
Canvas |
setMaxWidth(int maxWidth)
Maximum width available to this Canvas.
|
Canvas |
setMaxZoomOverflowError(int maxZoomOverflowError)
When
correctZoomOverflow is true and browser or
OS-level zoom is active, determines how much overflow must occur before the Framework enables scrolling for this canvas. |
Canvas |
setMenuConstructor(java.lang.String menuConstructor)
Default class used to construct menus created by this component, including context menus.
|
Canvas |
setMinHeight(int minHeight)
Minimum height available to this Canvas.
|
Canvas |
setMinNonEdgeSize(int minNonEdgeSize)
If the widget has drag resize configured on one or more of it's edges, and the edgeMarginSize is large enough that the
remaining space is less than
minNonEdgeSize , the edgeMarginSize will be reduced such that the non-edge part
of the widget is at least 1/3 of the total space (with two draggable edges) or half of it (with one draggable edge). |
Canvas |
setMinWidth(int minWidth)
Minimum width available to this Canvas.
|
Canvas |
setMomentumScrollMinSpeed(double momentumScrollMinSpeed)
The minimum speed in pixels per second that must be reached for momentum scrolling to kick in.
|
Canvas |
setMouseStillDownDelay(int mouseStillDownDelay)
Amount of time (in milliseconds) between repeated 'mouseStillDown' events for this canvas.
|
Canvas |
setMouseStillDownInitialDelay(int mouseStillDownInitialDelay)
Amount of time (in milliseconds) before mouseStillDown events start to be fired repeatedly for this canvas.
|
Canvas |
setName(java.lang.String name)
Optional name for the canvas, which can later be used to reference it.
|
Canvas |
setNativeAutoHideScrollbars(java.lang.Boolean nativeAutoHideScrollbars)
In some platform/browser configurations, scrollable regions do not show visible scrollbars until the user attempts to
interact with the region.
|
static void |
setNeverUseFilters(boolean neverUseFilters)
Changes the system-wide
neverUseFilters setting. |
Canvas |
setNoDoubleClicks(java.lang.Boolean noDoubleClicks)
If true, this canvas will receive all mouse-clicks as single
click events rather than as doubleClick events. |
Canvas |
setNoDropCursor(Cursor noDropCursor)
Specifies the cursor image to display when the user drags a droppable canvas over this if it is not a valid drop
target for the event and
showNoDropIndicator is
true. |
Canvas |
setOpacity(java.lang.Integer opacity)
Renders the widget to be partly transparent.
|
Canvas |
setOverflow(Overflow overflow)
Controls what happens when the drawn size of the content of a Canvas is either greater or smaller than the
specified size of the Canvas.
|
Canvas |
setPadding(java.lang.Integer padding)
Set the CSS padding of this component, in pixels.
|
void |
setPageLeft(int left)
Set the page-relative left coordinate of this widget.
|
void |
setPageTop(int top)
Set the page-relative top coordinate of this widget.
|
void |
setPanelContainer(Canvas container)
Sets this Canvas's "panel container".
|
Canvas |
setParentCanvas(Canvas parentCanvas)
This Canvas's immediate parent, if any.
|
Canvas |
setParentElement(Canvas parentElement)
Deprecated.
As of Smartclient version 9.1, deprecated in favor of
parentCanvas and getParentCanvas() |
Canvas |
setPeers(Canvas... peers)
Array of all Canvii that are peers of this Canvas.
|
Canvas |
setPendingMarkerStyle(java.lang.String pendingMarkerStyle)
CSS class used to apply additional styles to this canvas when
showPendingMarker() is called, or when pendingMarkerVisible has been set. |
Canvas |
setPendingMarkerVisible(java.lang.Boolean pendingMarkerVisible)
This attribute indicates whether the
pending marker
class should be appended to the list of CSS classes applied to this canvas. |
Canvas |
setPercentBox(PercentBoxModel percentBox)
Governs the model to be used when sizing canvases with percentage width or height, or positioning widgets with a
specified
snapTo . |
Canvas |
setPercentSource(Canvas percentSource)
If this canvas has its size specified as a percentage, this property allows the user to explicitly designate another
canvas upon which sizing will be based.
|
Canvas |
setPersistentMatchElement(java.lang.Boolean persistentMatchElement)
If this canvas has a specified
htmlElement and matchElement is set to true, should the canvas perform a one time
resize to fit the target element on draw, or should it continue to match the target element as its size changes due to
page reflows? |
Canvas |
setPointerSettings(PointerSettings pointerSettings)
Detail settings of the
pointer such as where it should be
located along the outside of the canvas. |
Canvas |
setPointerTarget(java.lang.String pointerTarget)
This property in conjunction with the
pointerSettings.snapTo places
the canvas in relation to the target canvas. |
Canvas |
setPosition(Positioning position)
Absolute or relative, corresponding to the "absolute" (with respect to parent) or
"relative" (with respect to document flow) values for the CSS position attribute.
|
Canvas |
setPrefix(java.lang.String prefix) |
Canvas |
setPrintChildrenAbsolutelyPositioned(java.lang.Boolean printChildrenAbsolutelyPositioned)
Should this canvas print its children absolutely positioned when generating
printable HTML . |
Canvas |
setPrintStyleName(java.lang.String printStyleName)
The CSS class to apply when printing this widget.
|
Canvas |
setPrompt(java.lang.String prompt)
Prompt displayed in hover canvas if
showHover is true. |
Canvas |
setProportionalResizeModifiers(java.lang.String... proportionalResizeModifiers)
If
proportionalResizing is set to
ProportionalResizeMode.MODIFIER or
ProportionalResizeMode.MODIFIER_OFF then proportional resizing of the DrawItem
is activated or deactivated, respectively, whenever at least one key in this set of modifier keys is pressed. |
Canvas |
setProportionalResizing(ProportionalResizeMode proportionalResizing)
If
canDragResize is true, this property specifies the
conditions for when proportional resizing is used. |
Canvas |
setReceiveScrollbarEvents(boolean receiveScrollbarEvents)
Whether this canvas should receive
events from its scrollbars, which are peers . |
Canvas |
setRect(int left,
int top,
int width,
int height)
Set all four coordinates, relative to the enclosing context, at once.
|
Canvas |
setRect(Rectangle rectangle)
Set all four coordinates, relative to the enclosing context, at once.
|
Canvas |
setRedrawOnResize(java.lang.Boolean redrawOnResize)
Should this element be redrawn in response to a resize?
|
void |
setRelativeTabPosition(java.lang.Integer position)
Assign a relative tab position for this canvas.
|
Canvas |
setResizeBarTarget(java.lang.String resizeBarTarget)
When this Canvas is included as a member in a Layout, and
showResizeBar is set to true so that a resizeBar is created, resizeBarTarget:"next" can be
set to indicate that the resizeBar should resize the next member of the layout rather than this one. |
Canvas |
setResizeFrom(EdgeName... resizeFrom)
When drag resizing is enabled via
canDragResize , restricts
resizes to only certain edges or corners. |
Canvas |
setResizeFrom(java.lang.String... resizeFrom)
Deprecated.
use
#setResizeFrom(EdgeName) instead. |
void |
setRight(int right)
Resizes the widget horizontally to position its right side at the specified coordinate.
|
Canvas |
setRuleScope(java.lang.String ruleScope)
ID of the component that gathers the context for evaluation of
criteria-based
rules specified by properties such as FormItem.visibleWhen ,
Dynamic Properties, and DynamicCriteria such as
ListGrid.initialCriteria . |
Canvas |
setScrollbarConstructor(java.lang.String scrollbarConstructor)
The class that will be used to create custom scrollbars for this component.
|
Canvas |
setScrollbarSize(int scrollbarSize)
How thick should we make the scrollbars for this canvas.
|
Canvas |
setShadowColor(java.lang.String shadowColor)
Color for the css-based drop shadow shown if
useCSSShadow is
true and showShadow is true. |
Canvas |
setShadowDepth(int shadowDepth)
Depth of the shadow, or the virtual height above the page of the widget throwing the shadow.
|
Canvas |
setShadowHOffset(java.lang.Integer shadowHOffset)
Horizontal offset for the
shadow . |
Canvas |
setShadowImage(java.lang.String shadowImage)
If
useCSSShadow is false, (or for browsers that do not
support css3), this property supplies the base name of the series of images for the sides, corners, and center of the
shadow. |
Canvas |
setShadowOffset(java.lang.Integer shadowOffset)
Offset of the shadow.
|
Canvas |
setShadowSoftness(java.lang.Integer shadowSoftness)
Softness, or degree of blurring, of the shadow.
|
Canvas |
setShadowSpread(java.lang.Integer shadowSpread)
Explicit spread for the css-based drop shadow shown if
useCSSShadow is true and showShadow is true. |
Canvas |
setShadowVOffset(java.lang.Integer shadowVOffset)
Vertical offset for the
shadow . |
Canvas |
setShouldPrint(java.lang.Boolean shouldPrint)
Whether this canvas should be included in a printable view.
|
Canvas |
setShowCustomScrollbars(boolean showCustomScrollbars)
Whether to use the browser's native scrollbars or Smart GWT-based scrollbars.
|
Canvas |
setShowDragShadow(java.lang.Boolean showDragShadow)
When this widget is dragged, if its dragAppearance is
"target" , should we show a shadow behind the canvas
during the drag. |
Canvas |
setShowEdges(java.lang.Boolean showEdges)
Whether an
EdgedCanvas should be used to show image-based edges around this
component. |
Canvas |
setShowHover(java.lang.Boolean showHover)
If
this.canHover is true, should we show the global hover canvas by default when the user hovers over this
canvas? |
Canvas |
setShowHoverComponents(java.lang.Boolean showHoverComponents)
When set to true, shows a widget hovering at the mouse point instead of the builtin hover label.
|
Canvas |
setShowPointer(java.lang.Boolean showPointer)
Should a pointer be shown? A pointer can be placed on the border to identify the target of the canvas contents.
|
Canvas |
setShowResizeBar(java.lang.Boolean showResizeBar)
When this Canvas is included as a member in a
Layout , whether a resizeBar
should be shown after this member in the layout, to allow it to be resized. |
Canvas |
setShowShadow(java.lang.Boolean showShadow)
Whether to show a drop shadow for this Canvas.
|
Canvas |
setShowSnapGrid(java.lang.Boolean showSnapGrid)
Whether to show a snap grid for this Canvas.
|
Canvas |
setShrinkElementOnHide(boolean shrinkElementOnHide)
This is an advanced setting.
|
Canvas |
setSizeMayChangeOnRedraw(java.lang.Boolean sizeMayChangeOnRedraw)
Is it possible that a call to
redraw() on this widget will change its
size? |
Canvas |
setSkinImgDir(java.lang.String skinImgDir)
Default directory for skin images (those defined by the class), relative to the Page-wide
skinDir . |
Canvas |
setSmoothFade(java.lang.Boolean smoothFade) |
Canvas |
setSnapAlignCandidates(Canvas... snapAlignCandidates)
When
childrenSnapAlign is enabled, list of candidates to
check for alignment. |
Canvas |
setSnapAlignCenterLineStyle(java.lang.String snapAlignCenterLineStyle)
CSS border declaration used for the line shown to indicate snapping to a center line when
childrenSnapAlign is set. |
Canvas |
setSnapAlignEdgeLineStyle(java.lang.String snapAlignEdgeLineStyle)
CSS border declaration used for the line shown to indicate snapping to a edge line when
childrenSnapAlign is set. |
Canvas |
setSnapAxis(java.lang.String snapAxis)
Describes which axes to apply snap-to-grid to.
|
Canvas |
setSnapEdge(java.lang.String snapEdge)
If
snapTo is defined to this widget, this property can be used to
define which edge of this widget should be snapped to an edge of the master or parent element. |
Canvas |
setSnapGridLineProperties(DrawLine snapGridLineProperties)
Specifies line styling to use when drawing the grid of lines for
SnapGridStyle :
"lines". |
Canvas |
setSnapGridStyle(SnapGridStyle snapGridStyle)
Specifies indication style to use for snap points, either a grid of lines or an array of crosses.
|
Canvas |
setSnapHDirection(java.lang.String snapHDirection)
The horizontal snap direction.
|
Canvas |
setSnapHGap(int snapHGap)
The horizontal grid size to use, in pixels, when snap-to-grid is enabled.
|
Canvas |
setSnapOffsetLeft(java.lang.Integer snapOffsetLeft)
If
snapTo is defined for this widget, this property can be used to
specify an offset in px or percentage for the left coordinate of this widget. |
Canvas |
setSnapOffsetTop(java.lang.Integer snapOffsetTop)
If
snapTo is defined for this widget, this property can be used to
specify an offset in px or percentage for the top coordinate of this widget. |
Canvas |
setSnapOnDrop(java.lang.Boolean snapOnDrop)
When this canvas is dropped onto an object supporting snap-to-grid, should it snap to the grid (true, the default) or
just drop wherever the mouse is (false).
|
Canvas |
setSnapResizeToAlign(java.lang.Boolean snapResizeToAlign)
Flag to disable snapping to alignment when this Canvas is resized.
|
Canvas |
setSnapResizeToGrid(java.lang.Boolean snapResizeToGrid)
Causes this canvas to snap to its parent's grid when resizing.
|
Canvas |
setSnapTo(java.lang.String snapTo)
Position this widget such that it is aligned with ("snapped to") an edge of its
master (if specified), or its parent canvas . |
Canvas |
setSnapToAlign(java.lang.Boolean snapToAlign)
Flag to disable snapping to alignment when this Canvas is dragged when
childrenSnapAlign is enabled on this Canvas' parent. |
Canvas |
setSnapToCenterAlign(java.lang.Boolean snapToCenterAlign)
Flag to disable snapping to center alignment when this Canvas is dragged when
childrenSnapAlign is enabled on this Canvas' parent. |
Canvas |
setSnapToEdgeAlign(java.lang.Boolean snapToEdgeAlign)
Flag to disable snapping to edge alignment when this Canvas is dragged when
childrenSnapAlign is enabled on this Canvas' parent. |
Canvas |
setSnapToGrid(java.lang.Boolean snapToGrid)
Causes this canvas to snap to its parent's grid when dragging.
|
Canvas |
setSnapVDirection(java.lang.String snapVDirection)
The vertical snap direction.
|
Canvas |
setSnapVGap(int snapVGap)
The vertical grid size to use, in pixels, when snap-to-grid is enabled.
|
Canvas |
setStartLine(java.lang.Boolean startLine)
Whether this canvas should always start a new line when used as a tile in a
FlowLayout . |
void |
setStyleName(java.lang.String styleName)
The CSS class applied to this widget as a whole.
|
Canvas |
setTabIndex(java.lang.Integer tabIndex)
If specified this governs the tabIndex of the widget in the page's tab order.
|
Canvas |
setTestDataContext(DataContext testDataContext)
A
DataContext to be used if no dataContext is provided (directly or indirectly via a parent). |
void |
setTitle(java.lang.String title)
Synonym for
setPrompt(String) |
Canvas |
setTooltip(java.lang.String tooltip)
Synonym for
setPrompt(String) |
Canvas |
setTop(int top)
Number of pixels the top of the widget is offset down from its default drawing context (either its parent's top-left
corner, or the document flow, depending on the value of the
position property). |
Canvas |
setTop(java.lang.String top)
Number of pixels the top of the widget is offset down from its default drawing context (either its parent's top-left
corner, or the document flow, depending on the value of the
position property). |
Canvas |
setUpdateTabPositionOnDraw(boolean updateTabPositionOnDraw)
Should canvases with no
parent canvas be moved to the end of
the TabIndexManager tree on draw()? |
Canvas |
setUpdateTabPositionOnReparent(boolean updateTabPositionOnReparent)
Should canvases with a
parent canvas be added to the
TabIndexManager under the parent as described in updateChildTabPositions() and updateChildTabPosition() ? |
Canvas |
setUseBackMask(java.lang.Boolean useBackMask)
In earlier versions of Internet Explorer (pre IE9), a native limitation exists whereby if HTML elements are overlapping
on the page, certain elements can appear to "burn through" elements in the same position with a higher z-index.
|
Canvas |
setUseCSSShadow(boolean useCSSShadow)
If
showShadow is true, should we use the css
box-shadow property (where supported) to achieve the shadow? |
Canvas |
setUseDragMask(boolean useDragMask)
This flag controls whether we register the component as a maskable item with the EventHandler.
|
Canvas |
setUseImageForSVG(boolean useImageForSVG)
If set, forces the main SVG image or icon in the canvas to be rendered in an image tag rather than an object tag, the
default.
|
Canvas |
setUseNativeDrag(java.lang.Boolean useNativeDrag)
If set, native HTML5 drag and drop will be used for all drags initiated on this widget (on browsers where this is
supported), and native HTML5 drop events occurring over this widget will be processed.
|
Canvas |
setUseOpacityFilter(java.lang.Boolean useOpacityFilter)
Configures where the Opacity filter is used for IE6-8.
|
Canvas |
setUseTouchScrolling(java.lang.Boolean useTouchScrolling)
On
touch devices , if this Canvas can be scrolled, should
touch-dragging the content area result in scrolling? Set to false if touch-dragging should not cause
scrolling. |
Canvas |
setValuesManager(java.lang.String valuesManager)
ValuesManager for managing values displayed in this component. |
Canvas |
setValuesManager(ValuesManager valuesManager)
ValuesManager for managing values displayed in this component. |
Canvas |
setVisibility(Visibility visibility)
Controls widget visibility when the widget is initialized.
|
void |
setVisible(boolean visible) |
Canvas |
setVisibleWhen(AdvancedCriteria visibleWhen)
Criteria to be evaluated to determine whether this Canvas should be visible.
|
Canvas |
setWidth(int width) |
Canvas |
setWidth(java.lang.Integer width)
The
canvas.width attribute specifies the size for a component's horizontal dimension;
canvas.height specifies the size for the vertical dimension. |
void |
setWidth(java.lang.String width)
The
canvas.width attribute specifies the size for a component's horizontal dimension;
canvas.height specifies the size for the vertical dimension. |
Canvas |
setWidth100()
Convenience method that sets the width to 100%.
|
Canvas |
setWorkflows(Process... workflows)
List of screen-global
workflows that can be shared by event handler
workflows using a StartProcessTask . |
Canvas |
setZIndex(int newIndex)
Set the z-Index of the canvas.
|
void |
shouldDragScroll()
If this widget is showing scrollbars, and a user drags close to the edge of the viewport, should we scroll the viewport
in the appropriate direction? Returns this.canDragScroll if there are scrollbars, else false.
|
void |
show()
Sets this widget's visibility to "inherit", so that it becomes visible if all of its parents are visible or it has no
parents.
|
java.lang.String |
showClickMask(Function clickActionCallback,
ClickMaskMode mode,
Canvas[] unmaskedTargets)
Show a clickMask over the entire screen that intercepts mouse clicks and fires some action.
|
void |
showComponentMask()
Temporariy block all user interaction with children of this widget, with the exception of those passed in in the
unmaskedChildren parameter. |
void |
showComponentMask(Canvas... unmaskedChildren)
Temporariy block all user interaction with children of this widget, with the exception of those passed in in the
unmaskedChildren parameter. |
void |
showNextTo(Canvas otherWidget)
Show this widget next to another widget on the page, positioned such that it will not extend beyond the browser
viewport.
|
void |
showNextTo(Canvas otherWidget,
java.lang.String side) |
void |
showNextTo(Canvas otherWidget,
java.lang.String side,
boolean canOcclude) |
void |
showNextTo(Canvas otherWidget,
java.lang.String side,
boolean canOcclude,
boolean skipAnimation)
Show this widget next to another widget on the page, positioned such that it will not extend beyond the browser
viewport.
|
void |
showPendingMarker()
Manually move this component into the "pending changes" visual state (based on the
pendingMarker style , or the Pending suffix in stateful
components). |
static void |
showPrintPreview(Canvas component)
Show a PrintWindow containing a printable view of the component passed in containing print HTML.
|
static void |
showPrintPreview(java.lang.Object[] components)
Show a Print containing a printable view of the components passed in.
|
static void |
showPrintPreview(java.lang.Object[] components,
PrintProperties printProperties,
java.lang.String title,
PrintPreviewCallback callback)
Show a Print containing a printable view of the components passed in.
|
static void |
showPrintPreview(java.lang.Object[] components,
PrintProperties printProperties,
java.lang.String title,
PrintPreviewCallback callback,
Window printWindowProperties,
java.lang.String printButtonTitle)
Show a Print containing a printable view of the components passed in.
|
void |
showRecursively()
Recursively show the canvas and all its parents so the canvas will be visible.
|
static void |
startDebuggingOverflow(DebugOverflowSettings settings)
Start to track and report excessive overflow per the supplied settings.
|
static void |
stopDebuggingOverflow()
Stop tracking and reporting excessive overflow.
|
void |
updateChildTabPosition(Canvas child)
Ensure that a specific child is slotted correctly into the page's tab order.
|
void |
updateChildTabPositions()
Update the childrens' tab positions, slotting them under this widget in the
TabIndexManager , in the order defined by getChildTabPosition() . |
void |
updateEditNode(EditContext editContext,
EditNode editNode)
A callback invoked for each
liveObject by EditContext when the EditContext is being serialized. |
void |
updateHover()
If this canvas is currently showing a hover (see
handleHover() ),
this method can be called to update the HTML contents of the hover. |
void |
updateHover(java.lang.String hoverHTML)
If this canvas is currently showing a hover (see
handleHover() ),
this method can be called to update the HTML contents of the hover. |
void |
updateShadow()
Update the canvas shadow.
|
void |
updateTabPositionForDraw()
This method is executed on draw.
|
java.lang.Boolean |
visibleAtPoint(int x,
int y,
boolean withinViewport,
Canvas ignoreWidgets,
Canvas upToParent)
Does this widget contain the specified global (x,y) coordinates, and have no other widgets also at the specified
position, obscuring this one? This is commonly used for (for example) drag and drop interactions.
|
java.lang.Boolean |
willAcceptDrop()
Returns true if the widget object being dragged can be dropped on this widget, and false or null otherwise.
|
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 Canvas()
public Canvas(com.google.gwt.core.client.JavaScriptObject jsObj)
public Canvas(java.lang.String id)
public static Canvas getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)
public java.util.Map getPaletteDefaults()
PaletteNode
. Use it when you need to
work with PaletteNodes indirectly, such when setting up
TileRecord
s that will be used in a
TilePalette
. See
the dev tools overview
for examples of how to
assemble and acquire a suitable defaults object when you are creating a PaletteNode
indirectlypublic 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()
create
in class BaseWidget
public Canvas setAccessKey(java.lang.String accessKey)
This should be set to a character - when a user hits the html accessKey modifier for the browser, plus this character, focus will be given to the widget in question. The accessKey modifier can vary by browser and platform.
The following list of default behavior is for reference only, developers should also consult browser documentation for additional information.
Alt
+ accessKeyAlt+Shift
+ accessKeyCtrl+Opt
+
accessKeyAlt
+ accessKeyCtrl+Opt
+ accessKeyThe accessKey can be set to any alphanumeric character (symbols not supported) Having set an accessKey, the canvas will be given focus when the user hits Alt+[accessKey], or in Mozilla Firefox 2.0 and above, Shift+Alt+[accessKey].
Note : This is an advanced setting
public java.lang.String getAccessKey()
This should be set to a character - when a user hits the html accessKey modifier for the browser, plus this character, focus will be given to the widget in question. The accessKey modifier can vary by browser and platform.
The following list of default behavior is for reference only, developers should also consult browser documentation for additional information.
Alt
+ accessKeyAlt+Shift
+ accessKeyCtrl+Opt
+
accessKeyAlt
+ accessKeyCtrl+Opt
+ accessKeyFocus
public Canvas setAdaptiveHeightPriority(java.lang.Integer adaptiveHeightPriority) throws java.lang.IllegalStateException
adaptiveHeightPriority
- New adaptiveHeightPriority value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Integer getAdaptiveHeightPriority()
public Canvas setAdaptiveWidthPriority(java.lang.Integer adaptiveWidthPriority) throws java.lang.IllegalStateException
adaptive width
,
adaptiveWidthPriority
can be set to indicate which of the components should be given priority access to
space. The widget with the highest priority setting will be offered surplus space first, and asked to give up space
last. Lack of a priority setting is treated as zero. Any adaptive widgets with the same priority setting will be asked
to give up or release space according to their order in Layout.members
.
adaptiveWidthPriority
- New adaptiveWidthPriority value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdsetCanAdaptWidth(java.lang.Boolean)
public java.lang.Integer getAdaptiveWidthPriority()
adaptive width
,
adaptiveWidthPriority
can be set to indicate which of the components should be given priority access to
space. The widget with the highest priority setting will be offered surplus space first, and asked to give up space
last. Lack of a priority setting is treated as zero. Any adaptive widgets with the same priority setting will be asked
to give up or release space according to their order in Layout.members
.
getCanAdaptWidth()
public Canvas setAlwaysManageFocusNavigation(java.lang.Boolean alwaysManageFocusNavigation) throws java.lang.IllegalStateException
TabIndexManager.shiftFocus()
API? Setting
this property to true
will cause the registered TabIndexManager entry for this canvas to be marked as
useExplicitFocusNavigation:true
, and
will cause standard event handling for the canvas and its descendents to intercept Tab keystrokes and explicitly call
TabIndexManager.shiftFocus()
rather than relying on
native browser Tab navigation
alwaysManageFocusNavigation
- New alwaysManageFocusNavigation value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getAlwaysManageFocusNavigation()
TabIndexManager.shiftFocus()
API? Setting
this property to true
will cause the registered TabIndexManager entry for this canvas to be marked as
useExplicitFocusNavigation:true
, and
will cause standard event handling for the canvas and its descendents to intercept Tab keystrokes and explicitly call
TabIndexManager.shiftFocus()
rather than relying on
native browser Tab navigation
public Canvas setAlwaysShowScrollbars(java.lang.Boolean alwaysShowScrollbars) throws java.lang.IllegalStateException
showCustomScrollbars
is true? On touch devices
that support native
touch scrolling, if showCustomScrollbars
is
true
and touch scrolling has not been disabled by the useTouchScrolling
and/or disableTouchScrollingForDrag
settings, should custom
scrollbars and native touch scrolling be enabled for this component? If false
or unset, then only
native touch scrolling will be enabled. If true
, then both scrolling mechanisms will be enabled.
NOTE: Because native touch scrolling (also called momentum scrolling) is computationally intensive, some mobile browsers implement an optimization where the state of the DOM for the element being scrolled will be frozen or partially frozen during the scroll animation. This results in a delay between when the scroll position reaches a certain point in the animation and when the positions of the custom scrollbar thumbs are updated to reflect that scroll position.
For non-touch devices, setting this property to true
will override nativeAutoHideScrollbars
, and ensure custom scrollbars
are shown for the component
Note : This is an advanced setting
alwaysShowScrollbars
- New alwaysShowScrollbars value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdScrolling overview and related methods
public java.lang.Boolean getAlwaysShowScrollbars()
showCustomScrollbars
is true? On touch devices
that support native
touch scrolling, if showCustomScrollbars
is
true
and touch scrolling has not been disabled by the useTouchScrolling
and/or disableTouchScrollingForDrag
settings, should custom
scrollbars and native touch scrolling be enabled for this component? If false
or unset, then only
native touch scrolling will be enabled. If true
, then both scrolling mechanisms will be enabled.
NOTE: Because native touch scrolling (also called momentum scrolling) is computationally intensive, some mobile browsers implement an optimization where the state of the DOM for the element being scrolled will be frozen or partially frozen during the scroll animation. This results in a delay between when the scroll position reaches a certain point in the animation and when the positions of the custom scrollbar thumbs are updated to reflect that scroll position.
For non-touch devices, setting this property to true
will override nativeAutoHideScrollbars
, and ensure custom scrollbars
are shown for the component
Scrolling overview and related methods
public Canvas setAnimateAcceleration(AnimationAcceleration animateAcceleration)
Note : This is an advanced setting
animateAcceleration
- New animateAcceleration value. Default value is "smoothEnd"Canvas
instance, for chaining setter callspublic AnimationAcceleration getAnimateAcceleration()
public Canvas setAnimateFadeTime(java.lang.Integer animateFadeTime)
this.animateTime
will be used by default instead
Note : This is an advanced setting
animateFadeTime
- New animateFadeTime value. Default value is nullCanvas
instance, for chaining setter callspublic java.lang.Integer getAnimateFadeTime()
this.animateTime
will be used by default insteadpublic Canvas setAnimateHideAcceleration(AnimationAcceleration animateHideAcceleration)
this.animateAcceleration
will be
used by default instead
Note : This is an advanced setting
animateHideAcceleration
- New animateHideAcceleration value. Default value is nullCanvas
instance, for chaining setter callspublic AnimationAcceleration getAnimateHideAcceleration()
this.animateAcceleration
will be
used by default insteadpublic Canvas setAnimateHideTime(java.lang.Integer animateHideTime)
this.animateTime
will be used by default instead
Note : This is an advanced setting
animateHideTime
- New animateHideTime value. Default value is nullCanvas
instance, for chaining setter callspublic java.lang.Integer getAnimateHideTime()
this.animateTime
will be used by default insteadpublic Canvas setAnimateMoveAcceleration(AnimationAcceleration animateMoveAcceleration)
this.animateAcceleration
will be
used by default instead
Note : This is an advanced setting
animateMoveAcceleration
- New animateMoveAcceleration value. Default value is nullCanvas
instance, for chaining setter callspublic AnimationAcceleration getAnimateMoveAcceleration()
this.animateAcceleration
will be
used by default insteadpublic Canvas setAnimateMoveTime(java.lang.Integer animateMoveTime)
this.animateTime
will be used by default instead
Note : This is an advanced setting
animateMoveTime
- New animateMoveTime value. Default value is nullCanvas
instance, for chaining setter callspublic java.lang.Integer getAnimateMoveTime()
this.animateTime
will be used by default insteadpublic Canvas setAnimateRectAcceleration(AnimationAcceleration animateRectAcceleration)
this.animateAcceleration
will be used by default instead
Note : This is an advanced setting
animateRectAcceleration
- New animateRectAcceleration value. Default value is nullCanvas
instance, for chaining setter callspublic AnimationAcceleration getAnimateRectAcceleration()
this.animateAcceleration
will be used by default insteadpublic Canvas setAnimateRectTime(java.lang.Integer animateRectTime)
this.animateTime
will be used by default
instead
Note : This is an advanced setting
animateRectTime
- New animateRectTime value. Default value is nullCanvas
instance, for chaining setter callspublic java.lang.Integer getAnimateRectTime()
this.animateTime
will be used by default
insteadpublic Canvas setAnimateResizeAcceleration(AnimationAcceleration animateResizeAcceleration)
this.animateAcceleration
will
be used by default instead
Note : This is an advanced setting
animateResizeAcceleration
- New animateResizeAcceleration value. Default value is nullCanvas
instance, for chaining setter callspublic AnimationAcceleration getAnimateResizeAcceleration()
this.animateAcceleration
will
be used by default insteadpublic Canvas setAnimateResizeLayoutMode(AnimationLayoutMode animateResizeLayoutMode)
child layout
for a size animation
. Updating the child layout more often may improve
appearance, but risks prohibitive overhead with more complicated widget hierarchies.
Note : This is an advanced setting
animateResizeLayoutMode
- New animateResizeLayoutMode value. Default value is "atEnd"Canvas
instance, for chaining setter callspublic AnimationLayoutMode getAnimateResizeLayoutMode()
child layout
for a size animation
. Updating the child layout more often may improve
appearance, but risks prohibitive overhead with more complicated widget hierarchies.public Canvas setAnimateResizeTime(java.lang.Integer animateResizeTime)
this.animateTime
will be used by default instead
Note : This is an advanced setting
animateResizeTime
- New animateResizeTime value. Default value is nullCanvas
instance, for chaining setter callspublic java.lang.Integer getAnimateResizeTime()
this.animateTime
will be used by default insteadpublic Canvas setAnimateScrollAcceleration(AnimationAcceleration animateScrollAcceleration)
this.animateAcceleration
will
be used by default instead
Note : This is an advanced setting
animateScrollAcceleration
- New animateScrollAcceleration value. Default value is nullCanvas
instance, for chaining setter callspublic AnimationAcceleration getAnimateScrollAcceleration()
this.animateAcceleration
will
be used by default insteadpublic Canvas setAnimateScrollTime(java.lang.Integer animateScrollTime)
this.animateTime
will be used by default instead
Note : This is an advanced setting
animateScrollTime
- New animateScrollTime value. Default value is nullCanvas
instance, for chaining setter callspublic java.lang.Integer getAnimateScrollTime()
this.animateTime
will be used by default insteadpublic Canvas setAnimateShowAcceleration(AnimationAcceleration animateShowAcceleration)
this.animateAcceleration
will be
used by default instead
Note : This is an advanced setting
animateShowAcceleration
- New animateShowAcceleration value. Default value is nullCanvas
instance, for chaining setter callspublic AnimationAcceleration getAnimateShowAcceleration()
this.animateAcceleration
will be
used by default insteadpublic Canvas setAnimateShowTime(java.lang.Integer animateShowTime)
this.animateTime
will be used by default instead
Note : This is an advanced setting
animateShowTime
- New animateShowTime value. Default value is nullCanvas
instance, for chaining setter callspublic java.lang.Integer getAnimateShowTime()
this.animateTime
will be used by default insteadpublic Canvas setAnimateTime(int animateTime)
duration
parameter into the appropriate animate...() method.
Note : This is an advanced setting
animateTime
- New animateTime value. Default value is 300Canvas
instance, for chaining setter callspublic int getAnimateTime()
duration
parameter into the appropriate animate...() method.public Canvas setAppImgDir(java.lang.String appImgDir)
appImgDir
.
Note : This is an advanced setting
appImgDir
- New appImgDir value. Default value is ""Canvas
instance, for chaining setter callsURL
,
Images overview and related methods
public java.lang.String getAppImgDir()
appImgDir
.URL
,
Images overview and related methods
public Canvas setAriaRole(java.lang.String ariaRole) throws java.lang.IllegalStateException
Accessibility
.ariaRole
- New ariaRole value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdAccessibility / Section 508 compliance
public java.lang.String getAriaRole()
Accessibility
.Accessibility / Section 508 compliance
public Canvas setAutoMaskComponents(java.lang.Boolean autoMaskComponents) throws java.lang.IllegalStateException
EditProxy.autoMaskChildren
EditProxy.useEditMask
true
if not explicitly set?autoMaskComponents
- New autoMaskComponents value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getAutoMaskComponents()
EditProxy.autoMaskChildren
EditProxy.useEditMask
true
if not explicitly set?public Canvas setAutoParent(java.lang.String autoParent) throws java.lang.IllegalStateException
childName
of another
already-created auto-child, or "none"
to cause the component to be created without being added as a child
to any other widget.addAutoChild(...)
was called. See autoChildren
for an overview of the autoChild subsystem.
Note : This is an advanced setting
autoParent
- New autoParent value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getAutoParent()
childName
of another
already-created auto-child, or "none"
to cause the component to be created without being added as a child
to any other widget.addAutoChild(...)
was called. See autoChildren
for an overview of the autoChild subsystem.
public Canvas setAutoPopulateData(java.lang.Boolean autoPopulateData) throws java.lang.IllegalStateException
dataContext
is provided, should subcomponents
automatically bind to the data? In general, if you provide a primaryKey
value for a record, that specific record will be
shown or edited, or have its related records loaded. If you provide other field values without the primaryKey
value, those values will be treated as either criteria (for a grid) or as initial values (for a form).
Components will respond to dataContext
differently depending on whether they typically work with just a
single record (such as form
or a DetailViewer
), or whether they usually work with lists of records (such as ListGrid
or TileGrid
, which have component.dataArity
set to multipe
by
default).
Specifically, the following rules are used:
dataContext
of Status:"In
Process" would fetch records with that status dataContext
, related records
will be fetched, using the PK value (similarly to if fetchRelatedData()
had been called. For example,
if an orderNumber value was provided, a grid bound to OrderDetail would fetch line items
for that orderNumber. autoPopulateData
to false on the specific component that should not be auto-populated. Specific examples, using the Order and OrderDetail sample DataSources, where OrderDetail records are associated (many-to-1) with Order records, and the PK of Order is orderNumber:
This fulfills a common use case of viewing or editing an Order and its related OrderDetail records.
This fulfills a common use case of
viewing Order records that match certain criteria. The OrderDetail grid would generally be
populated only by an event handler installed on the Order grid, which would call fetchRelatedData
.
This fulfills two possible use cases:
recordClick
-> form.editSelectedData()
. By default,
autoPopulateData
is true for any component that is contained with a "screen" RPCManager.createScreen()
and false for any component that is an com.smartgwt.client.types.AutoChild
.
Note that, if there is a non-DBC in your screen that wants to access fields in the expected dataContext, the DynamicProperty can refer to properties that auto-populated DBCs will place into the ruleContext. For example, with a DynamicForm "itemEditor" bound to "supplyItem", a header above could use itemEditor.values.itemName to display the name of the item. The header will then show the expected value as soon as the DynamicForm is auto-populated.
Similarly, the DataView.drawn()
StringMethod fires after auto-population has occurred, so any startup actions in a screen will likewise be able to
utilize data from the dataContext
by just referring to it via ruleScope
.
autoPopulateData
- New autoPopulateData value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getAutoPopulateData()
dataContext
is provided, should subcomponents
automatically bind to the data? In general, if you provide a primaryKey
value for a record, that specific record will be
shown or edited, or have its related records loaded. If you provide other field values without the primaryKey
value, those values will be treated as either criteria (for a grid) or as initial values (for a form).
Components will respond to dataContext
differently depending on whether they typically work with just a
single record (such as form
or a DetailViewer
), or whether they usually work with lists of records (such as ListGrid
or TileGrid
, which have component.dataArity
set to multipe
by
default).
Specifically, the following rules are used:
dataContext
of Status:"In
Process" would fetch records with that status dataContext
, related records
will be fetched, using the PK value (similarly to if fetchRelatedData()
had been called. For example,
if an orderNumber value was provided, a grid bound to OrderDetail would fetch line items
for that orderNumber. autoPopulateData
to false on the specific component that should not be auto-populated. Specific examples, using the Order and OrderDetail sample DataSources, where OrderDetail records are associated (many-to-1) with Order records, and the PK of Order is orderNumber:
This fulfills a common use case of viewing or editing an Order and its related OrderDetail records.
This fulfills a common use case of
viewing Order records that match certain criteria. The OrderDetail grid would generally be
populated only by an event handler installed on the Order grid, which would call fetchRelatedData
.
This fulfills two possible use cases:
recordClick
-> form.editSelectedData()
. By default,
autoPopulateData
is true for any component that is contained with a "screen" RPCManager.createScreen()
and false for any component that is an com.smartgwt.client.types.AutoChild
.
Note that, if there is a non-DBC in your screen that wants to access fields in the expected dataContext, the DynamicProperty can refer to properties that auto-populated DBCs will place into the ruleContext. For example, with a DynamicForm "itemEditor" bound to "supplyItem", a header above could use itemEditor.values.itemName to display the name of the item. The header will then show the expected value as soon as the DynamicForm is auto-populated.
Similarly, the DataView.drawn()
StringMethod fires after auto-population has occurred, so any startup actions in a screen will likewise be able to
utilize data from the dataContext
by just referring to it via ruleScope
.
public Canvas setAutoShowParent(java.lang.Boolean autoShowParent)
Note : This is an advanced setting
autoShowParent
- New autoShowParent value. Default value is falseCanvas
instance, for chaining setter callsAppearance overview and related methods
public java.lang.Boolean getAutoShowParent()
Appearance overview and related methods
public Canvas setBackgroundColor(java.lang.String backgroundColor)
newColor
.backgroundColor
- new background color, or null
to remove the current background color. Default value is nullCanvas
instance, for chaining setter callsCSSColor
,
Appearance overview and related methods
public java.lang.String getBackgroundColor()
CSSColor
,
Appearance overview and related methods
public Canvas setBackgroundImage(java.lang.String backgroundImage)
backgroundImage
- new URL (local to Page image directory) for background image. Default value is nullCanvas
instance, for chaining setter callsSCImgURL
,
Appearance overview and related methods
public java.lang.String getBackgroundImage()
SCImgURL
,
Appearance overview and related methods
public Canvas setBackgroundPosition(java.lang.String backgroundPosition) throws java.lang.IllegalStateException
backgroundPosition
- New backgroundPosition value. Default value is nullCanvas
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.String getBackgroundPosition()
Appearance overview and related methods
public Canvas setBackgroundRepeat(BackgroundRepeat backgroundRepeat)
background-repeat
attribute. The default of null means no background-repeat
CSS will be
written out. See BackgroundRepeat
type for details on other settings.
NOTE: this
setting directly sets the CSS property background-repeat
but does not attempt to work around various known
bugs with this setting, or lack of support in IE6. If you need to apply CSS-based workarounds for browser limitations
with this setting, it's best to do so via setting styleName
.
backgroundRepeat
- New backgroundRepeat value. Default value is nullCanvas
instance, for chaining setter callsAppearance overview and related methods
public BackgroundRepeat getBackgroundRepeat()
background-repeat
attribute. The default of null means no background-repeat
CSS will be
written out. See BackgroundRepeat
type for details on other settings.
NOTE: this
setting directly sets the CSS property background-repeat
but does not attempt to work around various known
bugs with this setting, or lack of support in IE6. If you need to apply CSS-based workarounds for browser limitations
with this setting, it's best to do so via setting styleName
.
Appearance overview and related methods
public Canvas setBorder(java.lang.String border)
This property applies the same border to all four sides of this component. Different per-side borders can
be set in a CSS style and applied via styleName
.
If a grouping frame
is being shown then border is derived from the groupBorderCSS
attribute, not from the explicit border property.
If this method is called after the component has been drawn/initialized:
Set the CSS border of this component, as a CSS string including border-width, border-style, and/or color (eg "2px solid blue").
This property applies the same border to all four sides of this component. Different per-side borders can be set in a CSS style and applied via styleName
.
border
- new border to set to (eg: "2px solid black"). Default value is nullCanvas
instance, for chaining setter callsAppearance overview and related methods
public java.lang.String getBorder()
This property applies the same border to all four sides of this component. Different per-side borders can
be set in a CSS style and applied via styleName
.
If a grouping frame
is being shown then border is derived from the groupBorderCSS
attribute, not from the explicit border property.
Appearance overview and related methods
public Canvas setBorderRadius(java.lang.String borderRadius)
borderRadius
- New borderRadius value. Default value is nullCanvas
instance, for chaining setter callsAppearance overview and related methods
public java.lang.String getBorderRadius()
Appearance overview and related methods
public Canvas setCanAcceptDrop(java.lang.Boolean canAcceptDrop)
Note : This is an advanced setting
canAcceptDrop
- New canAcceptDrop value. Default value is falseCanvas
instance, for chaining setter callsDrag and Drop
,
Drag create Examplepublic java.lang.Boolean getCanAcceptDrop()
Drag and Drop
,
Drag create Examplepublic Canvas setCanAdaptHeight(java.lang.Boolean canAdaptHeight)
canAdaptWidth
.canAdaptHeight
- New canAdaptHeight value. Default value is nullCanvas
instance, for chaining setter callspublic java.lang.Boolean getCanAdaptHeight()
canAdaptWidth
.public Canvas setCanAdaptWidth(java.lang.Boolean canAdaptWidth)
Unlike simply indicating a flexible size via width:"*", setting canAdaptWidth
indicates that a component has 2 (or more) different ways of rendering itself with different discrete sizes, but
does not have the ability to use every additional available pixel.
For example, a menu embedded in a toolbar might show as only a fixed-size icon which reveals menu options when clicked, or if enough space is available, could show all of the menu options directly in the toolbar. In this example, the menu should either be allocated just enough space for an icon, or enough space for all options to appear inline; any other amount of space being allocated is just a waste.
When a component with canAdaptWidth
is part of a Layout, AdaptWidthByCustomizer.adaptWidthBy()
will be called
every time component sizes are being calculated, passing a positive or negative pixel value:
minWidth
declared on the
canAdaptWidth
component itself Overflow
(introduce scrollbars, clip content, etc) unless
some component or set of components gives up at least this many pixels If a non-zero value is returned
from adaptWidthBy
, this means that the component is willing to shrink or expand by that many pixels.
Returning 0 means that the component is unable to reduce size further, or for a surplus, cannot make good use of the
surplus space.
AdaptWidthByCustomizer.adaptWidthBy()
may surrender as many pixels as desired (as long as the widget won't drop below
its minimum allowed width), no matter whether a positive (surplus) or negative (overflow) pixel value is supplied, but
AdaptWidthByCustomizer.adaptWidthBy()
may not increase its size by more than the number of offered pixels - so if an
overflow is present, it may not increase its size at all. Note that when the initial width is specified as a
stretch size (e.g. "*"), then after AdaptWidthByCustomizer.adaptWidthBy()
is called, the Framework will stretch (but not shrink) the member like any other
stretch-size Layout member, but the unadaptedWidth
argument will always reflect the unstretched width
requested by the previous call to AdaptWidthByCustomizer.adaptWidthBy()
. This behavior may be disabled by specifying the initial width as a number, or
leaving it unspecified.
Behavior is slightly different for overflow: "visible" members - in this case the
unadaptedWidth
passed in will reflect the current visible width of the member, rather than the last width
requested by the previous call to AdaptWidthByCustomizer.adaptWidthBy()
or the specified width (on the first call). However, note that the visible length
will match your requested width unless the member is actually overflowed. Stretch sizing is not supported for
adaptive-width members with overflow: "visible".
Caution: you must either determine the current size of the canvas
by maintaining your own internal state, or use the unadaptedWidth
parameter passed to AdaptWidthByCustomizer.adaptWidthBy()
. You must not
call getWidth()
or getVisibleWidth()
on the canvas itself inside AdaptWidthByCustomizer.adaptWidthBy()
as the size is in
the processing of being determined, but you may draw children or call getVisibleWidth()
on them, as we guarantee that the adaptive-width
canvas is drawn before the first call to AdaptWidthByCustomizer.adaptWidthBy()
. An example of drawing children in AdaptWidthByCustomizer.adaptWidthBy()
to compute
overall width may be seen in the Inlined Menu Mobile Sample.
Note that reasonable settings for minWidth
should be applied to all other flexible-sized members of a
layout where a canAdaptWidth
component appears, because when too little space is available, a
canAdaptWidth
component will absorb all available space until minimums for other components are hit (or the
canAdaptWidth
component reaches its maximum size). If more than one canAdaptWidth
component
is present, adaptiveWidthPriority
to give priority
to a particular component when allocating space.
All of the above behaviors are exactly the same for height, using
canAdaptHeight
and AdaptHeightByCustomizer.adaptHeightBy()
.
canAdaptWidth
- New canAdaptWidth value. Default value is nullCanvas
instance, for chaining setter callssetCanAdaptHeight(java.lang.Boolean)
,
AdaptWidthByCustomizer.adaptWidthBy(int, int)
,
AdaptHeightByCustomizer.adaptHeightBy(int, int)
,
Inlined Menu Examplepublic java.lang.Boolean getCanAdaptWidth()
Unlike simply indicating a flexible size via width:"*", setting canAdaptWidth
indicates that a component has 2 (or more) different ways of rendering itself with different discrete sizes, but
does not have the ability to use every additional available pixel.
For example, a menu embedded in a toolbar might show as only a fixed-size icon which reveals menu options when clicked, or if enough space is available, could show all of the menu options directly in the toolbar. In this example, the menu should either be allocated just enough space for an icon, or enough space for all options to appear inline; any other amount of space being allocated is just a waste.
When a component with canAdaptWidth
is part of a Layout, AdaptWidthByCustomizer.adaptWidthBy()
will be called
every time component sizes are being calculated, passing a positive or negative pixel value:
minWidth
declared on the
canAdaptWidth
component itself Overflow
(introduce scrollbars, clip content, etc) unless
some component or set of components gives up at least this many pixels If a non-zero value is returned
from adaptWidthBy
, this means that the component is willing to shrink or expand by that many pixels.
Returning 0 means that the component is unable to reduce size further, or for a surplus, cannot make good use of the
surplus space.
AdaptWidthByCustomizer.adaptWidthBy()
may surrender as many pixels as desired (as long as the widget won't drop below
its minimum allowed width), no matter whether a positive (surplus) or negative (overflow) pixel value is supplied, but
AdaptWidthByCustomizer.adaptWidthBy()
may not increase its size by more than the number of offered pixels - so if an
overflow is present, it may not increase its size at all. Note that when the initial width is specified as a
stretch size (e.g. "*"), then after AdaptWidthByCustomizer.adaptWidthBy()
is called, the Framework will stretch (but not shrink) the member like any other
stretch-size Layout member, but the unadaptedWidth
argument will always reflect the unstretched width
requested by the previous call to AdaptWidthByCustomizer.adaptWidthBy()
. This behavior may be disabled by specifying the initial width as a number, or
leaving it unspecified.
Behavior is slightly different for overflow: "visible" members - in this case the
unadaptedWidth
passed in will reflect the current visible width of the member, rather than the last width
requested by the previous call to AdaptWidthByCustomizer.adaptWidthBy()
or the specified width (on the first call). However, note that the visible length
will match your requested width unless the member is actually overflowed. Stretch sizing is not supported for
adaptive-width members with overflow: "visible".
Caution: you must either determine the current size of the canvas
by maintaining your own internal state, or use the unadaptedWidth
parameter passed to AdaptWidthByCustomizer.adaptWidthBy()
. You must not
call getWidth()
or getVisibleWidth()
on the canvas itself inside AdaptWidthByCustomizer.adaptWidthBy()
as the size is in
the processing of being determined, but you may draw children or call getVisibleWidth()
on them, as we guarantee that the adaptive-width
canvas is drawn before the first call to AdaptWidthByCustomizer.adaptWidthBy()
. An example of drawing children in AdaptWidthByCustomizer.adaptWidthBy()
to compute
overall width may be seen in the Inlined Menu Mobile Sample.
Note that reasonable settings for minWidth
should be applied to all other flexible-sized members of a
layout where a canAdaptWidth
component appears, because when too little space is available, a
canAdaptWidth
component will absorb all available space until minimums for other components are hit (or the
canAdaptWidth
component reaches its maximum size). If more than one canAdaptWidth
component
is present, adaptiveWidthPriority
to give priority
to a particular component when allocating space.
All of the above behaviors are exactly the same for height, using
canAdaptHeight
and AdaptHeightByCustomizer.adaptHeightBy()
.
getCanAdaptHeight()
,
AdaptWidthByCustomizer.adaptWidthBy(int, int)
,
AdaptHeightByCustomizer.adaptHeightBy(int, int)
,
Inlined Menu Examplepublic Canvas setCanDrag(java.lang.Boolean canDrag)
canDragReposition
or canDragResize
would be used instead of this property. Note: this property may be manipulated by higher-level dragging semantics.
If useNativeDrag
is true and this widget has been drawn, then this
widget must be redrawn
in order for a change of the value of this
attribute to take effect.
Note : This is an advanced setting
canDrag
- New canDrag value. Default value is falseCanvas
instance, for chaining setter callsDrag and Drop
,
Drag create Examplepublic java.lang.Boolean getCanDrag()
canDragReposition
or canDragResize
would be used instead of this property. Note: this property may be manipulated by higher-level dragging semantics.
If useNativeDrag
is true and this widget has been drawn, then this
widget must be redrawn
in order for a change of the value of this
attribute to take effect.
Drag and Drop
,
Drag create Examplepublic Canvas setCanDragReposition(java.lang.Boolean canDragReposition)
Note : This is an advanced setting
canDragReposition
- New canDragReposition value. Default value is falseCanvas
instance, for chaining setter callsDrag and Drop
,
Drag effects Examplepublic java.lang.Boolean getCanDragReposition()
Drag and Drop
,
Drag effects Examplepublic Canvas setCanDragResize(java.lang.Boolean canDragResize)
Note : This is an advanced setting
canDragResize
- New canDragResize value. Default value is falseCanvas
instance, for chaining setter callsDrag and Drop
,
Drag resize Examplepublic java.lang.Boolean getCanDragResize()
Drag and Drop
,
Drag resize Examplepublic Canvas setCanDragScroll(boolean canDragScroll)
Note : This is an advanced setting
canDragScroll
- New canDragScroll value. Default value is trueCanvas
instance, for chaining setter callsshouldDragScroll()
public boolean getCanDragScroll()
shouldDragScroll()
public Canvas setCanDrop(java.lang.Boolean canDrop)
Note : This is an advanced setting
canDrop
- New canDrop value. Default value is falseCanvas
instance, for chaining setter callsDrag and Drop
,
Drag create Examplepublic java.lang.Boolean getCanDrop()
Drag and Drop
,
Drag create Examplepublic Canvas setCanDropBefore(java.lang.Boolean canDropBefore)
Note : This is an advanced setting
canDropBefore
- New canDropBefore value. Default value is nullCanvas
instance, for chaining setter callsLayout
,
LayoutMember overview and related methods
public java.lang.Boolean getCanDropBefore()
Layout
,
LayoutMember overview and related methods
public Canvas setCanFocus(java.lang.Boolean canFocus)
If canFocus is unset (the default), only scrollable widgets with visible scrollbars are focusable, to allow for keyboard scrolling.
A widget normally
receives focus by being clicked on or tabbed to.
If this method is called after the component has been drawn/initialized:
Change whether a widget can accept keyboard focus.
Note : This is an advanced setting
canFocus
- whether the widget should now accept focus. Default value is nullCanvas
instance, for chaining setter callsFocus
,
Focus & Tabbing Examplepublic java.lang.Boolean getCanFocus()
If canFocus is unset (the default), only scrollable widgets with visible scrollbars are focusable, to allow for keyboard scrolling.
A widget normally receives focus by being clicked on or tabbed to.
Focus
,
Focus & Tabbing Examplepublic Canvas setCanHover(java.lang.Boolean canHover)
canHover
- New canHover value. Default value is nullCanvas
instance, for chaining setter callssetShowHover(java.lang.Boolean)
,
HoverEvent
public java.lang.Boolean getCanHover()
getShowHover()
,
HoverEvent
public Canvas setCanSelectText(java.lang.Boolean canSelectText)
Note that setting this property to
false
will not avoid text selection which is initiated outside this Canvas from continuing into this
Canvas, even if text selection began in another Canvas.
Note : This is an advanced setting
canSelectText
- New canSelectText value. Default value is falseCanvas
instance, for chaining setter callspublic java.lang.Boolean getCanSelectText()
Note that setting this property to
false
will not avoid text selection which is initiated outside this Canvas from continuing into this
Canvas, even if text selection began in another Canvas.
public CanvasItem getCanvasItem() throws java.lang.IllegalStateException
CanvasItem
, this property will be
set to point at the item. Otherwise this property will be null.
Note : This method should be called only after the widget has been rendered.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public Canvas[] getChildren()
Use addChild()
and removeChild()
to add and remove children after a Canvas has been created/drawn.
See Containment
for an overview of parent/child relationships.
Component Containment and Hierarchy
public Canvas setChildrenResizeSnapAlign(java.lang.Boolean childrenResizeSnapAlign)
childrenResizeSnapAlign
- New childrenResizeSnapAlign value. Default value is nullCanvas
instance, for chaining setter callsSnapGridDragging overview and related methods
public java.lang.Boolean getChildrenResizeSnapAlign()
SnapGridDragging overview and related methods
public Canvas setChildrenSnapAlign(java.lang.Boolean childrenSnapAlign)
childrenSnapToGrid
is enabled,
children dragged within this Canvas will also snap to positions where their edges or center lines would be aligned with
the edges or centers of other components, and lines will be shown to point out the possible alignment (with appearance
controlled by snapAlignCenterLineStyle
and snapAlignEdgeLineStyle
respectively. By default, edge-
or center-snapping is enabled for all components, but the set of eligible components can be explicitly set via snapAlignCandidates
.
See also childrenSnapCenterAlign
and childrenSnapEdgeAlign
for enabling or disabling center
alignment or edge alignment individually.
childrenSnapAlign
- New childrenSnapAlign value. Default value is nullCanvas
instance, for chaining setter callsSnapGridDragging overview and related methods
public java.lang.Boolean getChildrenSnapAlign()
childrenSnapToGrid
is enabled,
children dragged within this Canvas will also snap to positions where their edges or center lines would be aligned with
the edges or centers of other components, and lines will be shown to point out the possible alignment (with appearance
controlled by snapAlignCenterLineStyle
and snapAlignEdgeLineStyle
respectively. By default, edge-
or center-snapping is enabled for all components, but the set of eligible components can be explicitly set via snapAlignCandidates
.
See also childrenSnapCenterAlign
and childrenSnapEdgeAlign
for enabling or disabling center
alignment or edge alignment individually.
SnapGridDragging overview and related methods
public Canvas setChildrenSnapCenterAlign(java.lang.Boolean childrenSnapCenterAlign)
childrenSnapAlign
. This setting enables or disables
snapping on center alignment only.childrenSnapCenterAlign
- New childrenSnapCenterAlign value. Default value is nullCanvas
instance, for chaining setter callsSnapGridDragging overview and related methods
public java.lang.Boolean getChildrenSnapCenterAlign()
childrenSnapAlign
. This setting enables or disables
snapping on center alignment only.SnapGridDragging overview and related methods
public Canvas setChildrenSnapEdgeAlign(java.lang.Boolean childrenSnapEdgeAlign)
childrenSnapAlign
. This setting enables or disables
snapping on edge alignment only.childrenSnapEdgeAlign
- New childrenSnapEdgeAlign value. Default value is nullCanvas
instance, for chaining setter callsSnapGridDragging overview and related methods
public java.lang.Boolean getChildrenSnapEdgeAlign()
childrenSnapAlign
. This setting enables or disables
snapping on edge alignment only.SnapGridDragging overview and related methods
public Canvas setChildrenSnapResizeToGrid(java.lang.Boolean childrenSnapResizeToGrid)
snapToGrid
or snapResizeToGrid
value on the child.childrenSnapResizeToGrid
- New childrenSnapResizeToGrid value. Default value is nullCanvas
instance, for chaining setter callsSnapGridDragging overview and related methods
public java.lang.Boolean getChildrenSnapResizeToGrid()
snapToGrid
or snapResizeToGrid
value on the child.SnapGridDragging overview and related methods
public Canvas setChildrenSnapToGrid(java.lang.Boolean childrenSnapToGrid)
snapToGrid
value on the child.childrenSnapToGrid
- New childrenSnapToGrid value. Default value is nullCanvas
instance, for chaining setter callsSnapGridDragging overview and related methods
public java.lang.Boolean getChildrenSnapToGrid()
snapToGrid
value on the child.SnapGridDragging overview and related methods
public Canvas getComponentMask() throws java.lang.IllegalStateException
showComponentMask()
is called.
This component is an AutoChild named "componentMask". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.getComponentMaskDefaults()
public Canvas setComponentMaskDefaults(Canvas componentMaskDefaults) throws java.lang.IllegalStateException
componentMask
autoChild. Default properties
include backgroundColor
being set to "black"
and opacity
being set to 20
.componentMaskDefaults
- New componentMaskDefaults value. Default value is {...}Canvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdSGWTProperties
public Canvas getComponentMaskDefaults()
componentMask
autoChild. Default properties
include backgroundColor
being set to "black"
and opacity
being set to 20
.public Canvas setContents(java.lang.String contents)
When dynamicContents
is set, setContents()
can also be called with no arguments to cause contents to be re-evaluated.
Note : This is an advanced setting
contents
- an HTML string to be set as the contents of this widget. Default value is " "Canvas
instance, for chaining setter callssetDynamicContents(java.lang.Boolean)
,
HTMLString
public java.lang.String getContents()
getDynamicContents()
,
HTMLString
public Canvas setContextMenu(Menu contextMenu)
Note: if destroy()
is called on a canvas, any specified context menu is not
automatically destroyed as well. This is in contrast to MenuButton
s which
automatically destroy their specified MenuButton.menu
by
default. The behavior is intentional as context menus are commonly reused across components.
Note : This is an advanced setting
contextMenu
- New contextMenu value. Default value is nullCanvas
instance, for chaining setter callsShowContextMenuEvent
,
Cues overview and related methods
,
Context menus Examplepublic Menu getContextMenu()
Note: if destroy()
is called on a canvas, any specified context menu is not
automatically destroyed as well. This is in contrast to MenuButton
s which
automatically destroy their specified MenuButton.menu
by
default. The behavior is intentional as context menus are commonly reused across components.
ShowContextMenuEvent
,
Cues overview and related methods
,
Context menus Examplepublic Canvas setCorrectZoomOverflow(java.lang.Boolean correctZoomOverflow)
maxZoomOverflowError
of overflow before enabling scrolling and displaying custom scrollbars. Only relevant when overflow
is "auto". This property is defaulted to true in the Canvas
prototype for those browsers where the situation has been observed, except for
Firefox, where a better solution is applied that doesn't rely on maxZoomOverflowError
and never clips any content. Setting
this property false will disable the workaround for all browsers, including Firefox. Without a workaround, scrollbars
may oscillate rapidly when the browser or OS is zoomed.
Note : This is an advanced setting
correctZoomOverflow
- New correctZoomOverflow value. Default value is variesCanvas
instance, for chaining setter callspublic java.lang.Boolean getCorrectZoomOverflow()
maxZoomOverflowError
of overflow before enabling scrolling and displaying custom scrollbars. Only relevant when overflow
is "auto". This property is defaulted to true in the Canvas
prototype for those browsers where the situation has been observed, except for
Firefox, where a better solution is applied that doesn't rely on maxZoomOverflowError
and never clips any content. Setting
this property false will disable the workaround for all browsers, including Firefox. Without a workaround, scrollbars
may oscillate rapidly when the browser or OS is zoomed.
public Canvas setCursor(Cursor cursor)
Cursor
for valid values.
Note that the cursor may also be controlled by the following attributes in various cases:
disabledCursor
noDropCursor
dragRepositionCursor
edgeCursorMap
If no cursor is explicitly specified
for a component, the cursor will be derived from the component's ancestors
. If cursor
is not explicitly set in the
ancestor chain, "default"
will be used.
If this method is called after the component has been drawn/initialized:
Sets the cursor for this widget to cursor. See the cursor property for possible values.
Note : This is an advanced setting
cursor
- new cursor. Default value is nullCanvas
instance, for chaining setter callsCues overview and related methods
,
Drag create Example,
Cursors Examplepublic Cursor getCursor()
Cursor
for valid values.
Note that the cursor may also be controlled by the following attributes in various cases:
disabledCursor
noDropCursor
dragRepositionCursor
edgeCursorMap
If no cursor is explicitly specified
for a component, the cursor will be derived from the component's ancestors
. If cursor
is not explicitly set in the
ancestor chain, "default"
will be used.
Cues overview and related methods
,
Drag create Example,
Cursors Examplepublic Canvas setDataContext(DataContext dataContext)
DataSource
IDs to specific Records
from those DataSources, that DataBoundComponents
contained within this Canvas should automatically bind to if a DataSource is provided but data is not provided (directly
or indirectly, for example, indirectly via setting ListGrid.autoFetchData
. See autoPopulateData
for
details on how this is done.
DataSources included in the dataContext
are immediately provided to rule context
when used if no other component has done so already. These
records are found in rule context 'dataContext' section (ex. dataContext.Customer
for a Customer record in
dataContext
) so they do not conflict with normal DataSource records.
If this method is called after the component has been drawn/initialized:
Provides a new DataContext
to the Canvas. If the DataContext is new, DataBoundComponents
contained within this Canvas will be automatically bound as described in dataContext
. If the DataContext replaces an existing one, any contained components that were originally bound against the DataContext will be re-bound.
dataContext
- dataContext to use for automatic binding. Default value is nullCanvas
instance, for chaining setter callspublic DataContext getDataContext()
DataSource
IDs to specific Records
from those DataSources, that DataBoundComponents
contained within this Canvas should automatically bind to if a DataSource is provided but data is not provided (directly
or indirectly, for example, indirectly via setting ListGrid.autoFetchData
. See autoPopulateData
for
details on how this is done.
DataSources included in the dataContext
are immediately provided to rule context
when used if no other component has done so already. These
records are found in rule context 'dataContext' section (ex. dataContext.Customer
for a Customer record in
dataContext
) so they do not conflict with normal DataSource records.
public Canvas setDataPath(java.lang.String dataPath)
NOTE: the dataPath feature is intended to help certain legacy architectures,
such as systems that work in terms of exchanging large messages with several different
entity types in one message, and are incapable of providing separate access to each
entity type.
See the DataPath overview
for more information.
For components which support displaying or editing data values, (such as DynamicForm
or
ListGrid
components), the dataPath may be set to specify how the components
data is
accessed. In this case the dataPath essentially specifies a nested object to edit - typically
a path to a field value within a dataSource record. Note that a ValuesManager will be required
to handle connecting the dataBoundcomponent to the appropriate sub object. This may be explicitly
specified on the component, or a parent of the component, or automatically generated
if a DataSource is specified on either the component or a parent thereof.
To provide a simple example - if a complex object existed with the following format:
Map values = new HashMap(); values.put("companyName", "Some company"); Map addressMap = new HashMap(); addressMap.put("street", "123 Main Street"); addressMap.put("city", "New York"); addressMap.put("state", "NY"); values.put("address", addressMap);a developer could specify a DynamicForm instance with 'dataPath' set to "address" to edit the nested address object:
ValuesManager vm = new ValuesManager(); Map values = new HashMap(); values.put("companyName", "Some company"); Map addressMap = new HashMap(); addressMap.put("street", "123 Main Street"); addressMap.put("city", "New York"); addressMap.put("state", "NY"); values.put("address", addressMap); vm.setValues(values); DynamicForm form = new DynamicForm(); form.setValuesManager(vm); form.setDataPath("address"); TextItem streetField = new TextItem("street"); TextItem cityField = new TextItem("city"); TextItem stateField = new TextItem("state"); form.setItems(streetField, cityField, stateField);If a component is specified with a
dataPath
attribute but does not have an
explicitly specified valuesManager, it will check its parent element chain for a specified
valuesManager and automatically bind to that. This simplifies binding multiple components used
to view or edit a nested data structure as the valuesManager needs only be defined once at a
reasonably high level component. Here's an example of this approach:
ValuesManager vm = new ValuesManager(); Map values = new HashMap(); values.put("companyName", "Some company"); Map addressMap = new HashMap(); addressMap.put("street", "123 Main Street"); addressMap.put("city", "New York"); addressMap.put("state", "NY"); values.put("address", addressMap); vm.setValues(values); Layout layout = new Layout(); layout.setValuesManager(vm); DynamicForm form = new DynamicForm(); form.setDataPath("/"); TextItem companyNameField = new TextItem("companyName"); form.setItems(companyNameField); DynamicForm form1 = new DynamicForm(); form1.setDataPath("address"); TextItem streetField = new TextItem("street"); TextItem cityField = new TextItem("city"); TextItem stateField = new TextItem("state"); form1.setItems(streetField, cityField, stateField); layout.addMember(form); layout.addMember(form1);Note that in this case the valuesManager is specified on a Layout, which has no 'values' management behavior of its own, but contains items with a specified dataPath which do. In this example you'd see 2 forms allowing editing of the nested data structure.
dataPaths from multiple nested components may also be combined. For example:
ValuesManager vm = new ValuesManager(); Map values = new HashMap(); values.put("companyName", "Some company"); Map addressMap = new HashMap(); addressMap.put("street", "123 Main Street"); addressMap.put("city", "New York"); addressMap.put("state", "NY"); values.put("address", addressMap); Map values1 = new HashMap(); values1.put("companyName", "Some Corporation"); Map addressMap1 = new HashMap(); addressMap1.put("street", "1 High Street"); addressMap1.put("city", "New York"); addressMap1.put("state", "NY"); values1.put("address", addressMap1); values.put("parentCompany", values1); vm.setValues(values); Layout layout = new Layout(); layout.setValuesManager(vm); DynamicForm form = new DynamicForm(); form.setDataPath("/"); TextItem companyNameField = new TextItem("companyName"); form.setItems(companyNameField); DynamicForm form1 = new DynamicForm(); form1.setDataPath("address"); TextItem streetField = new TextItem("street"); TextItem cityField = new TextItem("city"); TextItem stateField = new TextItem("state"); form1.setItems(streetField, cityField, stateField); Layout innerlayout = new Layout(); innerlayout.setDataPath("parentCompany"); DynamicForm form3 = new DynamicForm(); form3.setDataPath(""); StaticTextItem companyNameField1 = new StaticTextItem("companyName"); form3.setItems(companyNameField1); DetailViewer detailViewer = new DetailViewer(); detailViewer.setDataPath("address"); DetailViewerField streetDVField = new DetailViewerField("street"); DetailViewerField cityDVField = new DetailViewerField("city"); DetailViewerField stateDVField = new DetailViewerField("state"); detailViewer.setFields(streetDVField, cityDVField, stateDVField); innerlayout.addMember(form3); innerlayout.addMember(detailViewer); layout.addMember(form); layout.addMember(form1); layout.addMember(innerlayout);In this example the detailViewer will display data from the
parentCompany.address
object within the base record.
Note that if a component has a specified dataSource and shows child components with a
specified dataPath, there is no need to explicitly declare a valuesManager at all. If a component
with a dataPath has a dataSource, or an ancestor with a dataSource specified, it will, a
valuesManager will automatically be generated on the higher level component (and be available as
component.valuesManager
).
If that isn't clear, consider the form for entering the parent company name in the above
example. The correct dataPath to the field is /parentCompany/companyName
. We
have the "parentCompany" part of that path provided by the containing Layout, so we cannot
reiterate it on the form itself. However, if we omit the dataPath property altogether, the
framework will not seek to apply dataPath at all. So, we specify the empty string, which
tells Smart GWT to use dataPath and to retain the portion of the path derived so far from
the containment hierarchy.
One further clarification: relative paths are only different from absolute paths if they are
relative to something other than the root. So in the above example, although we specify
"/" as the dataPath of the "main" company name form, we would get exactly the same behavior
by specifying it as "", because the correct dataPath for the companyName field is
"/companyName" - ie, it is relative to the root.
If this method is called after the component has been drawn/initialized:
Setter for the dataPath
attribute. This method may be called directly at runtime to set the dataPath on a component, and will also be re-run automatically whenever a canvas' parent changes due to a call to addChild(). This method handles automatically binding the component to the appropriate valuesManager if necessary.
Note : This is an advanced setting
dataPath
- new dataPath. Default value is nullCanvas
instance, for chaining setter callssetRuleScope(java.lang.String)
,
DataPath
public java.lang.String getDataPath()
NOTE: the dataPath feature is intended to help certain legacy architectures,
such as systems that work in terms of exchanging large messages with several different
entity types in one message, and are incapable of providing separate access to each
entity type.
See the DataPath overview
for more information.
For components which support displaying or editing data values, (such as DynamicForm
or
ListGrid
components), the dataPath may be set to specify how the components
data is
accessed. In this case the dataPath essentially specifies a nested object to edit - typically
a path to a field value within a dataSource record. Note that a ValuesManager will be required
to handle connecting the dataBoundcomponent to the appropriate sub object. This may be explicitly
specified on the component, or a parent of the component, or automatically generated
if a DataSource is specified on either the component or a parent thereof.
To provide a simple example - if a complex object existed with the following format:
Map values = new HashMap(); values.put("companyName", "Some company"); Map addressMap = new HashMap(); addressMap.put("street", "123 Main Street"); addressMap.put("city", "New York"); addressMap.put("state", "NY"); values.put("address", addressMap);a developer could specify a DynamicForm instance with 'dataPath' set to "address" to edit the nested address object:
ValuesManager vm = new ValuesManager(); Map values = new HashMap(); values.put("companyName", "Some company"); Map addressMap = new HashMap(); addressMap.put("street", "123 Main Street"); addressMap.put("city", "New York"); addressMap.put("state", "NY"); values.put("address", addressMap); vm.setValues(values); DynamicForm form = new DynamicForm(); form.setValuesManager(vm); form.setDataPath("address"); TextItem streetField = new TextItem("street"); TextItem cityField = new TextItem("city"); TextItem stateField = new TextItem("state"); form.setItems(streetField, cityField, stateField);If a component is specified with a
dataPath
attribute but does not have an
explicitly specified valuesManager, it will check its parent element chain for a specified
valuesManager and automatically bind to that. This simplifies binding multiple components used
to view or edit a nested data structure as the valuesManager needs only be defined once at a
reasonably high level component. Here's an example of this approach:
ValuesManager vm = new ValuesManager(); Map values = new HashMap(); values.put("companyName", "Some company"); Map addressMap = new HashMap(); addressMap.put("street", "123 Main Street"); addressMap.put("city", "New York"); addressMap.put("state", "NY"); values.put("address", addressMap); vm.setValues(values); Layout layout = new Layout(); layout.setValuesManager(vm); DynamicForm form = new DynamicForm(); form.setDataPath("/"); TextItem companyNameField = new TextItem("companyName"); form.setItems(companyNameField); DynamicForm form1 = new DynamicForm(); form1.setDataPath("address"); TextItem streetField = new TextItem("street"); TextItem cityField = new TextItem("city"); TextItem stateField = new TextItem("state"); form1.setItems(streetField, cityField, stateField); layout.addMember(form); layout.addMember(form1);Note that in this case the valuesManager is specified on a Layout, which has no 'values' management behavior of its own, but contains items with a specified dataPath which do. In this example you'd see 2 forms allowing editing of the nested data structure.
dataPaths from multiple nested components may also be combined. For example:
ValuesManager vm = new ValuesManager(); Map values = new HashMap(); values.put("companyName", "Some company"); Map addressMap = new HashMap(); addressMap.put("street", "123 Main Street"); addressMap.put("city", "New York"); addressMap.put("state", "NY"); values.put("address", addressMap); Map values1 = new HashMap(); values1.put("companyName", "Some Corporation"); Map addressMap1 = new HashMap(); addressMap1.put("street", "1 High Street"); addressMap1.put("city", "New York"); addressMap1.put("state", "NY"); values1.put("address", addressMap1); values.put("parentCompany", values1); vm.setValues(values); Layout layout = new Layout(); layout.setValuesManager(vm); DynamicForm form = new DynamicForm(); form.setDataPath("/"); TextItem companyNameField = new TextItem("companyName"); form.setItems(companyNameField); DynamicForm form1 = new DynamicForm(); form1.setDataPath("address"); TextItem streetField = new TextItem("street"); TextItem cityField = new TextItem("city"); TextItem stateField = new TextItem("state"); form1.setItems(streetField, cityField, stateField); Layout innerlayout = new Layout(); innerlayout.setDataPath("parentCompany"); DynamicForm form3 = new DynamicForm(); form3.setDataPath(""); StaticTextItem companyNameField1 = new StaticTextItem("companyName"); form3.setItems(companyNameField1); DetailViewer detailViewer = new DetailViewer(); detailViewer.setDataPath("address"); DetailViewerField streetDVField = new DetailViewerField("street"); DetailViewerField cityDVField = new DetailViewerField("city"); DetailViewerField stateDVField = new DetailViewerField("state"); detailViewer.setFields(streetDVField, cityDVField, stateDVField); innerlayout.addMember(form3); innerlayout.addMember(detailViewer); layout.addMember(form); layout.addMember(form1); layout.addMember(innerlayout);In this example the detailViewer will display data from the
parentCompany.address
object within the base record.
Note that if a component has a specified dataSource and shows child components with a
specified dataPath, there is no need to explicitly declare a valuesManager at all. If a component
with a dataPath has a dataSource, or an ancestor with a dataSource specified, it will, a
valuesManager will automatically be generated on the higher level component (and be available as
component.valuesManager
).
If that isn't clear, consider the form for entering the parent company name in the above
example. The correct dataPath to the field is /parentCompany/companyName
. We
have the "parentCompany" part of that path provided by the containing Layout, so we cannot
reiterate it on the form itself. However, if we omit the dataPath property altogether, the
framework will not seek to apply dataPath at all. So, we specify the empty string, which
tells Smart GWT to use dataPath and to retain the portion of the path derived so far from
the containment hierarchy.
One further clarification: relative paths are only different from absolute paths if they are relative to something other than the root. So in the above example, although we specify "/" as the dataPath of the "main" company name form, we would get exactly the same behavior by specifying it as "", because the correct dataPath for the companyName field is "/companyName" - ie, it is relative to the root.
getRuleScope()
,
DataPath
public Canvas setDefaultHeight(int defaultHeight)
For a component that should potentially be
sized automatically by a Layout, set this property rather than height
directly, because Layouts regard a height setting as an explicit size that shouldn't be changed.
Note : This is an advanced setting
defaultHeight
- New defaultHeight value. Default value is 100Canvas
instance, for chaining setter callsSizing overview and related methods
public int getDefaultHeight()
For a component that should potentially be
sized automatically by a Layout, set this property rather than height
directly, because Layouts regard a height setting as an explicit size that shouldn't be changed.
Sizing overview and related methods
public Canvas setDefaultWidth(int defaultWidth)
For a component that should potentially be
sized automatically by a Layout, set this property rather than width
directly, because Layouts regard a width setting as an explicit size that shouldn't be changed.
Note : This is an advanced setting
defaultWidth
- New defaultWidth value. Default value is 100Canvas
instance, for chaining setter callsSizing overview and related methods
public int getDefaultWidth()
For a component that should potentially be
sized automatically by a Layout, set this property rather than width
directly, because Layouts regard a width setting as an explicit size that shouldn't be changed.
Sizing overview and related methods
public Canvas setDefiningProperty(java.lang.String definingProperty)
getDefiningPropertyName()
for this property when generating
and resolving AutoTest locators with search segments
.
Note : This is an advanced setting
definingProperty
- New definingProperty value. Default value is nullCanvas
instance, for chaining setter callspublic java.lang.String getDefiningProperty()
getDefiningPropertyName()
for this property when generating
and resolving AutoTest locators with search segments
.public Canvas setDefiningPropertyNameOptions(java.lang.String... definingPropertyNameOptions)
definingProperty
was specified for this
component,
this array denotes a list of options to use as a
defining property
when generating and resolving
AutoTest locators with search segments
.
The first attribute in this array that is non-null for this component will
be used as the defining property for locator search segments.
The default set of options are as follows:
[ "locatorName", "dataSource" ]
Note : This is an advanced setting
definingPropertyNameOptions
- New definingPropertyNameOptions value. Default value is [...]Canvas
instance, for chaining setter callspublic java.lang.String[] getDefiningPropertyNameOptions()
definingProperty
was specified for this
component,
this array denotes a list of options to use as a
defining property
when generating and resolving
AutoTest locators with search segments
.
The first attribute in this array that is non-null for this component will
be used as the defining property for locator search segments.
The default set of options are as follows:
[ "locatorName", "dataSource" ]
public java.lang.Boolean getDestroyed() throws java.lang.IllegalStateException
true
, the destroy()
method
has been called on this canvas. This implies the canvas is no longer valid. Its ID has been removed from global scope,
and calling standard canvas APIs on it is likely to result in errors.
Note : This method should be called only after the widget has been rendered.
java.lang.IllegalStateException
- if this widget has not yet been rendered.BaseWidget.destroy()
public java.lang.Boolean getDestroying() throws java.lang.IllegalStateException
destroy()
method is called on a
widget. If this property is true, but destroyed
is not, this
indicates the canvas is in the process of being destroyed.
Note : This method should be called only after the widget has been rendered.
java.lang.IllegalStateException
- if this widget has not yet been rendered.BaseWidget.destroy()
public Canvas setDisabledCursor(Cursor disabledCursor)
Note : This is an advanced setting
disabledCursor
- New disabledCursor value. Default value is Canvas.DEFAULTCanvas
instance, for chaining setter callsCues overview and related methods
public Cursor getDisabledCursor()
Cues overview and related methods
public Canvas setDisableTouchScrollingForDrag(java.lang.Boolean disableTouchScrollingForDrag) throws java.lang.IllegalStateException
useTouchScrolling
whenever a built-in drag
operation has been enabled which is known to be non-functional if touch scrolling is enabled. Default behavior is to
leave touch scrolling enabled even if it makes other enabled drag operations non-functional, since any accessible
application must provide an alternative way to perform drag and drop
operations anyway. disableTouchScrollingForDrag
exists so that applications can change the default
setting on a per-component basis (via setDefaultProperties
), in order to make a system-wide or
per-component-type decision about whether to favor touch scrolling vs retaining the ability to drag and drop via finger
drags, instead of having to set useTouchScrolling
on each individual instance.
See the Mobile Development overview
for more background information.
disableTouchScrollingForDrag
- New disableTouchScrollingForDrag value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdScrolling overview and related methods
public java.lang.Boolean getDisableTouchScrollingForDrag()
useTouchScrolling
whenever a built-in drag
operation has been enabled which is known to be non-functional if touch scrolling is enabled. Default behavior is to
leave touch scrolling enabled even if it makes other enabled drag operations non-functional, since any accessible
application must provide an alternative way to perform drag and drop
operations anyway. disableTouchScrollingForDrag
exists so that applications can change the default
setting on a per-component basis (via setDefaultProperties
), in order to make a system-wide or
per-component-type decision about whether to favor touch scrolling vs retaining the ability to drag and drop via finger
drags, instead of having to set useTouchScrolling
on each individual instance.
See the Mobile Development overview
for more background information.
Scrolling overview and related methods
public Canvas setDoubleClickDelay(int doubleClickDelay)
Note : This is an advanced setting
doubleClickDelay
- New doubleClickDelay value. Default value is 250Canvas
instance, for chaining setter callspublic int getDoubleClickDelay()
public Canvas setDragAppearance(DragAppearance dragAppearance)
dragResizeAppearance
and dragRepositionAppearance
.
Note : This is an advanced setting
dragAppearance
- New dragAppearance value. Default value is EventHandler.OUTLINECanvas
instance, for chaining setter callsDrag and Drop
public DragAppearance getDragAppearance()
dragResizeAppearance
and dragRepositionAppearance
.Drag and Drop
public Canvas setDragIntersectStyle(DragIntersectStyle dragIntersectStyle)
Note : This is an advanced setting
dragIntersectStyle
- New dragIntersectStyle value. Default value is "mouse"Canvas
instance, for chaining setter callsDrag and Drop
public DragIntersectStyle getDragIntersectStyle()
Drag and Drop
public Canvas setDragMaskType(DragMaskType dragMaskType)
useDragMask
is enabled.dragMaskType
- New dragMaskType value. Default value is "div"Canvas
instance, for chaining setter callsDrag and Drop
public DragMaskType getDragMaskType()
useDragMask
is enabled.Drag and Drop
public Canvas setDragMaxHeight(int dragMaxHeight)
dragMaxHeight
and maxHeight
.
Note : This is an advanced setting
dragMaxHeight
- New dragMaxHeight value. Default value is 10000Canvas
instance, for chaining setter callsSizing overview and related methods
public int getDragMaxHeight()
dragMaxHeight
and maxHeight
.Sizing overview and related methods
public Canvas setDragMaxWidth(int dragMaxWidth)
dragMaxWidth
and maxWidth
.
Note : This is an advanced setting
dragMaxWidth
- New dragMaxWidth value. Default value is 10000Canvas
instance, for chaining setter callsSizing overview and related methods
public int getDragMaxWidth()
dragMaxWidth
and maxWidth
.Sizing overview and related methods
public Canvas setDragMinHeight(int dragMinHeight)
dragMinWidth
for details of behavior.
Note : This is an advanced setting
dragMinHeight
- New dragMinHeight value. Default value is 10Canvas
instance, for chaining setter callssetMinHeight(int)
,
Sizing overview and related methods
public int getDragMinHeight()
dragMinWidth
for details of behavior.getMinHeight()
,
Sizing overview and related methods
public Canvas setDragMinWidth(int dragMinWidth)
dragMinWidth
and minWidth
. Note that a Canvas with overflow:"visible" has an implicit minimize size based on it's contents.
Note that dragMinWidth
affects only user-initiated
drag resizes. To set the minimum width of a Canvas embedded in a Layout, you can set +{minWidth}, or Layout.minMemberLength
to constrain the minimum size along
the length axis of all members of the Layout
.
Note : This is an advanced setting
dragMinWidth
- New dragMinWidth value. Default value is 10Canvas
instance, for chaining setter callsSizing overview and related methods
public int getDragMinWidth()
dragMinWidth
and minWidth
. Note that a Canvas with overflow:"visible" has an implicit minimize size based on it's contents.
Note that dragMinWidth
affects only user-initiated
drag resizes. To set the minimum width of a Canvas embedded in a Layout, you can set +{minWidth}, or Layout.minMemberLength
to constrain the minimum size along
the length axis of all members of the Layout
.
Sizing overview and related methods
public Canvas setDragOpacity(java.lang.Integer dragOpacity)
"target"
, this value specifies the opacity to render the target while it
is being dragged. A null value implies we do not modify the opacity.
Note : This is an advanced setting
dragOpacity
- New dragOpacity value. Default value is nullCanvas
instance, for chaining setter callsDrag and Drop
,
Drag effects Examplepublic java.lang.Integer getDragOpacity()
"target"
, this value specifies the opacity to render the target while it
is being dragged. A null value implies we do not modify the opacity.Drag and Drop
,
Drag effects Examplepublic Canvas setDragRepositionAppearance(DragAppearance dragRepositionAppearance)
canDragReposition
is true, this attribute specifies
the visual appearance to show during drag reposition. If unset dragAppearance
will be used.
Note : This is an advanced setting
dragRepositionAppearance
- New dragRepositionAppearance value. Default value is nullCanvas
instance, for chaining setter callsDrag and Drop
public DragAppearance getDragRepositionAppearance()
canDragReposition
is true, this attribute specifies
the visual appearance to show during drag reposition. If unset dragAppearance
will be used.Drag and Drop
public Canvas setDragRepositionCursor(Cursor dragRepositionCursor)
Note : This is an advanced setting
dragRepositionCursor
- New dragRepositionCursor value. Default value is Canvas.MOVECanvas
instance, for chaining setter callsDrag and Drop
public Cursor getDragRepositionCursor()
Drag and Drop
public Canvas setDragResizeAppearance(DragAppearance dragResizeAppearance)
canDragResize
is true, this attribute specifies the
visual appearance to show during drag resize. If unset dragAppearance
will be used.
Note : This is an advanced setting
dragResizeAppearance
- New dragResizeAppearance value. Default value is nullCanvas
instance, for chaining setter callsDrag and Drop
public DragAppearance getDragResizeAppearance()
canDragResize
is true, this attribute specifies the
visual appearance to show during drag resize. If unset dragAppearance
will be used.Drag and Drop
public Canvas setDragScrollDelay(int dragScrollDelay)
Note : This is an advanced setting
dragScrollDelay
- New dragScrollDelay value. Default value is 100Canvas
instance, for chaining setter callspublic int getDragScrollDelay()
public Canvas setDragStartDistance(int dragStartDistance)
Note : This is an advanced setting
dragStartDistance
- New dragStartDistance value. Default value is 5Canvas
instance, for chaining setter callsDrag and Drop
public int getDragStartDistance()
Drag and Drop
public Canvas setDragTarget(Canvas dragTarget)
Valid dragTarget
values are:
null
(default) [this widget is its own
drag target] "parent"
drag target is this widget's parentCanvas
"top"
drag target is this widget's
topElement
Note that for dragging to work as intended,
the resizeFrom
setting on the dragTarget
must be
null or a superset of the resizeFrom
on this canvas.
Note : This is an advanced setting
dragTarget
- New dragTarget value. Default value is nullCanvas
instance, for chaining setter callsEventHandler.getDragTarget()
,
Drag and Drop
public Canvas getDragTarget()
Valid dragTarget
values are:
null
(default) [this widget is its own
drag target] "parent"
drag target is this widget's parentCanvas
"top"
drag target is this widget's
topElement
Note that for dragging to work as intended,
the resizeFrom
setting on the dragTarget
must be
null or a superset of the resizeFrom
on this canvas.
EventHandler.getDragTarget()
,
Drag and Drop
public Canvas setDragTarget(java.lang.String dragTarget)
Valid dragTarget
values are:
null
(default) [this widget is its own
drag target] "parent"
drag target is this widget's parentCanvas
"top"
drag target is this widget's
topElement
Note that for dragging to work as intended,
the resizeFrom
setting on the dragTarget
must be
null or a superset of the resizeFrom
on this canvas.
Note : This is an advanced setting
dragTarget
- New dragTarget value. Default value is nullCanvas
instance, for chaining setter callsEventHandler.getDragTarget()
,
Drag and Drop
public java.lang.String getDragTargetAsString()
Valid dragTarget
values are:
null
(default) [this widget is its own
drag target] "parent"
drag target is this widget's parentCanvas
"top"
drag target is this widget's
topElement
Note that for dragging to work as intended,
the resizeFrom
setting on the dragTarget
must be
null or a superset of the resizeFrom
on this canvas.
EventHandler.getDragTarget()
,
Drag and Drop
public Canvas setDragType(java.lang.String dragType)
dragType
for this widget used, to be compared to dropTypes
on possible drop target widgets. See dropTypes
for a full explanation.
Note : This is an advanced setting
dragType
- New dragType value. Default value is nullCanvas
instance, for chaining setter callsDrag and Drop
public java.lang.String getDragType()
dragType
for this widget used, to be compared to dropTypes
on possible drop target widgets. See dropTypes
for a full explanation.Drag and Drop
public Canvas setDropTarget(Canvas dropTarget)
Note : This is an advanced setting
dropTarget
- New dropTarget value. Default value is nullCanvas
instance, for chaining setter callsEventHandler.getDragTarget()
,
setDragTarget(com.smartgwt.client.widgets.Canvas)
,
Drag and Drop
public Canvas getDropTarget()
EventHandler.getDragTarget()
,
getDragTarget()
,
Drag and Drop
public Canvas setDropTarget(java.lang.String dropTarget)
Note : This is an advanced setting
dropTarget
- New dropTarget value. Default value is nullCanvas
instance, for chaining setter callsEventHandler.getDragTarget()
,
setDragTarget(com.smartgwt.client.widgets.Canvas)
,
Drag and Drop
public java.lang.String getDropTargetAsString()
EventHandler.getDragTarget()
,
getDragTarget()
,
Drag and Drop
public Canvas setDropTypes(java.lang.String... dropTypes)
dragType
is
configured on the source widget, it is compared to the dropTypes
configured on the target widget, and a
drop is only allowed if the dragType
is listed in the target widget's dropTypes
array. The
default setting means any dragType
is eligible for dropping on this widget, including no
dragType
setting.
See also willAcceptDrop()
for dynamic determination of drop eligibility.
Note : This is an advanced setting
dropTypes
- New dropTypes value. Default value is Canvas.ANYTHINGCanvas
instance, for chaining setter callsDrag and Drop
public java.lang.String[] getDropTypes()
dragType
is
configured on the source widget, it is compared to the dropTypes
configured on the target widget, and a
drop is only allowed if the dragType
is listed in the target widget's dropTypes
array. The
default setting means any dragType
is eligible for dropping on this widget, including no
dragType
setting.
See also willAcceptDrop()
for dynamic determination of drop eligibility.
Drag and Drop
public Canvas setDropTypes(java.lang.String dropTypes)
dragType
is
configured on the source widget, it is compared to the dropTypes
configured on the target widget, and a
drop is only allowed if the dragType
is listed in the target widget's dropTypes
array. The
default setting means any dragType
is eligible for dropping on this widget, including no
dragType
setting.
See also willAcceptDrop()
for dynamic determination of drop eligibility.
Note : This is an advanced setting
dropTypes
- New dropTypes value. Default value is Canvas.ANYTHINGCanvas
instance, for chaining setter callsDrag and Drop
public java.lang.String getDropTypesAsString()
dragType
is
configured on the source widget, it is compared to the dropTypes
configured on the target widget, and a
drop is only allowed if the dragType
is listed in the target widget's dropTypes
array. The
default setting means any dragType
is eligible for dropping on this widget, including no
dragType
setting.
See also willAcceptDrop()
for dynamic determination of drop eligibility.
Drag and Drop
public Canvas setDynamicContents(java.lang.Boolean dynamicContents)
${[JavaScript to evaluate]}
. For example, to include the current date in a templated
message, canvas.contents
could be set to:
"Today's date is <b>${new
Date().toUSShortDate()}</b>"
Embedded expressions will be evaluated when the canvas is drawn or
redrawn, and the result of the evaluated expression will be displayed to the user. If the expression does not evaluate
to a String, the toString()
representation of the returned object will be displayed automatically
Dynamic expressions are evaluated in the scope of the canvas displaying the content, so the this
keyword
may be used within your expression to refer to the canvas. Developers may also explicitly supply values for variables
to be used within the evaluation via the dynamicContentsVars
property.
Notes:
Developer
Console
and the error string will be embedded in place of the expected value in the Canvas. Note : This is an advanced setting
dynamicContents
- New dynamicContents value. Default value is falseCanvas
instance, for chaining setter callssetContents(java.lang.String)
,
com.smartgwt.client.widgets.Canvas#setDynamicContentsVars
public java.lang.Boolean getDynamicContents()
${[JavaScript to evaluate]}
. For example, to include the current date in a templated
message, canvas.contents
could be set to:
"Today's date is <b>${new
Date().toUSShortDate()}</b>"
Embedded expressions will be evaluated when the canvas is drawn or
redrawn, and the result of the evaluated expression will be displayed to the user. If the expression does not evaluate
to a String, the toString()
representation of the returned object will be displayed automatically
Dynamic expressions are evaluated in the scope of the canvas displaying the content, so the this
keyword
may be used within your expression to refer to the canvas. Developers may also explicitly supply values for variables
to be used within the evaluation via the dynamicContentsVars
property.
Notes:
Developer
Console
and the error string will be embedded in place of the expected value in the Canvas. getContents()
,
com.smartgwt.client.widgets.Canvas#getDynamicContentsVars
public Canvas setEdgeBackgroundColor(java.lang.String edgeBackgroundColor) throws java.lang.IllegalStateException
public java.lang.String getEdgeBackgroundColor()
CSSColor
public Canvas setEdgeCenterBackgroundColor(java.lang.String edgeCenterBackgroundColor) throws java.lang.IllegalStateException
public java.lang.String getEdgeCenterBackgroundColor()
CSSColor
public Canvas setEdgeImage(java.lang.String edgeImage) throws java.lang.IllegalStateException
The full list of extensions is: "_TL", "_TR", "_BL", "_BR", "_T", "_L", "_B", "_R", "_center".
edgeImage
- New edgeImage value. Default value is "[SKIN]edge.gif"Canvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdSCImgURL
,
Edges Examplepublic java.lang.String getEdgeImage()
The full list of extensions is: "_TL", "_TR", "_BL", "_BR", "_T", "_L", "_B", "_R", "_center".
SCImgURL
,
Edges Examplepublic Canvas setEdgeMarginSize(int edgeMarginSize)
Note : This is an advanced setting
edgeMarginSize
- New edgeMarginSize value. Default value is 5Canvas
instance, for chaining setter callsDrag and Drop
,
Drag resize Examplepublic int getEdgeMarginSize()
Drag and Drop
,
Drag resize Examplepublic Canvas setEdgeOffset(java.lang.Integer edgeOffset) throws java.lang.IllegalStateException
edgeOffset
- New edgeOffset value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Integer getEdgeOffset()
public Canvas setEdgeOpacity(java.lang.Integer edgeOpacity) throws java.lang.IllegalStateException
setOpacity()
is called on a Canvas where edgeOpacity is set, edgeOpacity will be considered a percentage of the
parent's opacity (so 50% opaque parent plus edgeOpacity 50 means 25% opaque edges)
edgeOpacity
and mark the canvas for redrawedgeOpacity
- new edge-opacity level. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Integer getEdgeOpacity()
setOpacity()
is called on a Canvas where edgeOpacity is set, edgeOpacity will be considered a percentage of the
parent's opacity (so 50% opaque parent plus edgeOpacity 50 means 25% opaque edges)public Canvas setEdgeShowCenter(java.lang.Boolean edgeShowCenter) throws java.lang.IllegalStateException
edgeShowCenter
- New edgeShowCenter value. Default value is falseCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getEdgeShowCenter()
public Canvas setEdgeSize(int edgeSize) throws java.lang.IllegalStateException
edgeSize
- New edgeSize value. Default value is 10Canvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic int getEdgeSize()
public EditNode getEditNode() throws java.lang.IllegalStateException
EditNode
for a component that has been created by a Palette
from a PaletteNode
.
Note : This method should be called only after the widget has been rendered.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public EditProxy getEditProxy() throws java.lang.IllegalStateException
EditProxy
controls the behaviors of a component when it is placed into editing mode
. The editProxy
AutoChild is created when a component is
first placed into edit mode via setEditMode()
.
editProxy
properties can be supplied on a PaletteNode
or EditNode
as editProxyProperties
, but must be provided before the component is first placed into edit mode.
Most editable
components use a custom EditProxy. See the documentation for each class' editProxyConstructor
to determine the class.
This component is an AutoChild named "editProxy". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.setEditMode(boolean)
public Canvas setEditProxyConstructor(java.lang.String editProxyConstructor) throws java.lang.IllegalStateException
EditProxy
for this component when the component is
first placed into edit mode
.editProxyConstructor
- New editProxyConstructor value. Default value is "CanvasEditProxy"Canvas
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
.SCClassName
public Canvas setEnableWhen(AdvancedCriteria enableWhen) throws java.lang.IllegalStateException
ruleScope
changes. A basic criteria uses textMatchStyle:"exact".
When specified in Component XML
this property allows shorthand formats
for defining criteria.
enableWhen
- New enableWhen value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdDynamic Rules
public AdvancedCriteria getEnableWhen()
ruleScope
changes. A basic criteria uses textMatchStyle:"exact".
When specified in Component XML
this property allows shorthand formats
for defining criteria.
Dynamic Rules
public Canvas setEndLine(java.lang.Boolean endLine)
FlowLayout
. This property is not supported in a TileLayout
with TileLayout.layoutPolicy
: "fit" or if databound (i.e.TileGrid
).endLine
- New endLine value. Default value is falseCanvas
instance, for chaining setter callsTileLayout.setAutoWrapLines(java.lang.Boolean)
public java.lang.Boolean getEndLine()
FlowLayout
. This property is not supported in a TileLayout
with TileLayout.layoutPolicy
: "fit" or if databound (i.e.TileGrid
).TileLayout.getAutoWrapLines()
public Canvas setExtraSpace(int extraSpace) throws java.lang.IllegalStateException
extraSpace
- New extraSpace value. Default value is 0Canvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdLayoutSpacer
,
LayoutMember overview and related methods
public int getExtraSpace()
LayoutSpacer
,
LayoutMember overview and related methods
public Canvas setFloatingScrollbars(boolean floatingScrollbars) throws java.lang.IllegalStateException
showCustomScrollbars
is true, should the
scrollbars be drawn floating over the component handle, or should the handle shrink to accommodate them? Floating
scrollbars are typically only appropriate for scrollbars that are hidden by default and get shown as the user actively
scrolls the widget handle, such as in the nativeAutoHideScrollbars
case. If floating scrollbars are permanently visible over the component handle, they may
block some of the widget's content.
Note : This is an advanced setting
floatingScrollbars
- New floatingScrollbars value. Default value is falseCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic boolean getFloatingScrollbars()
showCustomScrollbars
is true, should the
scrollbars be drawn floating over the component handle, or should the handle shrink to accommodate them? Floating
scrollbars are typically only appropriate for scrollbars that are hidden by default and get shown as the user actively
scrolls the widget handle, such as in the nativeAutoHideScrollbars
case. If floating scrollbars are permanently visible over the component handle, they may
block some of the widget's content.
public Canvas setForwardSVGeventsToObject(java.lang.Boolean forwardSVGeventsToObject) throws java.lang.IllegalStateException
The advantage of forwarding events is that it allows hover CSS or any other event-driven logic on the SVG to work as expected. If "pointer-events:none" is written out, no GUI interaction will trigger events in the SVG, including hover CSS. The disadvantage is that only a few critical events are forwarded, such as "mouseDown", "mouseMove", and "mouseUp" for non-touch platforms, and "click" for touch platforms. Other events will be delivered to the SVG, but not forwarded up to the parent document/object tag.
Note : This is an advanced setting
forwardSVGeventsToObject
- New forwardSVGeventsToObject value. Default value is trueCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdEventHandler
,
setUseImageForSVG(boolean)
,
Images overview and related methods
public java.lang.Boolean getForwardSVGeventsToObject()
The advantage of forwarding events is that it allows hover CSS or any other event-driven logic on the SVG to work as expected. If "pointer-events:none" is written out, no GUI interaction will trigger events in the SVG, including hover CSS. The disadvantage is that only a few critical events are forwarded, such as "mouseDown", "mouseMove", and "mouseUp" for non-touch platforms, and "click" for touch platforms. Other events will be delivered to the SVG, but not forwarded up to the parent document/object tag.
EventHandler
,
getUseImageForSVG()
,
Images overview and related methods
public Canvas setGroupBorderCSS(java.lang.String groupBorderCSS) throws java.lang.IllegalStateException
grouping frame
.groupBorderCSS
- New groupBorderCSS value. Default value is "2px solid black"Canvas
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.String getGroupBorderCSS()
grouping frame
.Appearance overview and related methods
public Canvas setGroupLabelBackgroundColor(java.lang.String groupLabelBackgroundColor)
grouping frame
. This corresponds to the CSS background-color property on the grouping label. You can set this property to an RGB value (e.g. #22AAFF) or a named color (e.g. red) from a list of browser supported color names.
The getter for this attribute, getGroupLabelBackgroundColor()
, returns
the color that will actually be used; i.e. if groupLabelBackgroundColor is left unset or is set to null, then
getGroupLabelBackgroundColor() returns the color string that will be used.
If this method is called after the component has been drawn/initialized:
Setter for groupLabelBackgroundColor
.
groupLabelBackgroundColor
- the new grouping label background color. Default value is nullCanvas
instance, for chaining setter callsCSSColor
,
Appearance overview and related methods
public java.lang.String getGroupLabelBackgroundColor()
grouping frame
. This corresponds to the CSS background-color property on the grouping label. You can set this property to an RGB value (e.g. #22AAFF) or a named color (e.g. red) from a list of browser supported color names.
The getter for this attribute, getGroupLabelBackgroundColor()
, returns
the color that will actually be used; i.e. if groupLabelBackgroundColor is left unset or is set to null, then
getGroupLabelBackgroundColor() returns the color string that will be used.
CSSColor
,
Appearance overview and related methods
public Canvas setGroupLabelStyleName(java.lang.String groupLabelStyleName) throws java.lang.IllegalStateException
grouping frame
. Note that groupLabelBackgroundColor
overrides any
background-color of this style.
groupLabelStyleName
- New groupLabelStyleName value. Default value is "groupLabel"Canvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdCSSStyleName
,
Appearance overview and related methods
public java.lang.String getGroupLabelStyleName()
grouping frame
. Note that groupLabelBackgroundColor
overrides any
background-color of this style.
CSSStyleName
,
Appearance overview and related methods
public Canvas setGroupPadding(java.lang.Integer groupPadding) throws java.lang.IllegalStateException
border and label
.groupPadding
- New groupPadding value. Default value is 10Canvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdsetIsGroup(boolean)
,
Appearance overview and related methods
public java.lang.Integer getGroupPadding()
border and label
.getIsGroup()
,
Appearance overview and related methods
public Canvas setGroupTitle(java.lang.String groupTitle)
isGroup
is
set to true. No grouping frame
or title/label will be shown
unless this property is a non-empty string.
groupTitle
.groupTitle
- The new title for the grouping. Default value is nullCanvas
instance, for chaining setter callsHTMLString
,
Appearance overview and related methods
public java.lang.String getGroupTitle()
isGroup
is
set to true. No grouping frame
or title/label will be shown
unless this property is a non-empty string.HTMLString
,
Appearance overview and related methods
public Canvas setHeight(java.lang.Integer height)
canvas.width
attribute specifies the size for a component's horizontal dimension;
canvas.height
specifies the size for the vertical dimension. May be set to an integer value (a number of pixels), a percentage value like "50%", or "*".
See PercentSizing
for details
on how percentage or "*"
values are resolved actual size.
If overflow
is set to "visible", the specified size acts as a minimum, and
the component may overflow to show all content and/or children.
Note that developers wishing to set a default width
or height for a component class should set defaultWidth
or
defaultHeight
instead of specifying an explicit default
width
or height
. This is important for components added to a Layout
as members - it allows the Layout to determine whether the canvas has an
explicitly specified size that must be respected, or whether it can participate in its sizing policies
.
If this method is called after the component has been drawn/initialized:
Resizes the widget vertically to the specified height (moves the bottom side of the widget). The height parameter can be expressed as a percentage of viewport size or as the number of pixels.
NOTE: if you're setting multiple coordinates, use resizeTo() or setRect() instead
height
- new height. Default value is nullCanvas
instance, for chaining setter callsSizing overview and related methods
public java.lang.Integer getHeight()
canvas.width
attribute specifies the size for a component's horizontal dimension;
canvas.height
specifies the size for the vertical dimension. May be set to an integer value (a number of pixels), a percentage value like "50%", or "*".
See PercentSizing
for details
on how percentage or "*"
values are resolved actual size.
If overflow
is set to "visible", the specified size acts as a minimum, and
the component may overflow to show all content and/or children.
Note that developers wishing to set a default width
or height for a component class should set defaultWidth
or
defaultHeight
instead of specifying an explicit default
width
or height
. This is important for components added to a Layout
as members - it allows the Layout to determine whether the canvas has an
explicitly specified size that must be respected, or whether it can participate in its sizing policies
.
See GettingCanvasSize
. Default value is null
Sizing overview and related methods
public void setHeight(java.lang.String height)
canvas.width
attribute specifies the size for a component's horizontal dimension;
canvas.height
specifies the size for the vertical dimension. May be set to an integer value (a number of pixels), a percentage value like "50%", or "*".
See PercentSizing
for details
on how percentage or "*"
values are resolved actual size.
If overflow
is set to "visible", the specified size acts as a minimum, and
the component may overflow to show all content and/or children.
Note that developers wishing to set a default width
or height for a component class should set defaultWidth
or
defaultHeight
instead of specifying an explicit default
width
or height
. This is important for components added to a Layout
as members - it allows the Layout to determine whether the canvas has an
explicitly specified size that must be respected, or whether it can participate in its sizing policies
.
If this method is called after the component has been drawn/initialized:
Resizes the widget vertically to the specified height (moves the bottom side of the widget). The height parameter can be expressed as a percentage of viewport size or as the number of pixels.
NOTE: if you're setting multiple coordinates, use resizeTo() or setRect() instead
setHeight
in class com.google.gwt.user.client.ui.UIObject
height
- new height. Default value is nullSizing overview and related methods
public Canvas setHideUsingDisplayNone(boolean hideUsingDisplayNone) throws java.lang.IllegalStateException
visibility
and hide()
), should display:none be applied to the outer element
? This setting is not supported for general use, but in certain cases, it has been shown that display:none is a work-around for browser bugs involving burn-through of iframes or plugins, where the content of the iframe or plugin may still be visible despite the containing widget being hidden.
Note : This is an advanced setting
hideUsingDisplayNone
- New hideUsingDisplayNone value. Default value is falseCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdVisibility
,
Appearance overview and related methods
public boolean getHideUsingDisplayNone()
visibility
and hide()
), should display:none be applied to the outer element
? This setting is not supported for general use, but in certain cases, it has been shown that display:none is a work-around for browser bugs involving burn-through of iframes or plugins, where the content of the iframe or plugin may still be visible despite the containing widget being hidden.
Visibility
,
Appearance overview and related methods
public Canvas setHoverAlign(Alignment hoverAlign)
this.showHover
is true, this property can be used to customize the alignment of content in the hover
canvas.hoverAlign
- New hoverAlign value. Default value is nullCanvas
instance, for chaining setter callssetShowHover(java.lang.Boolean)
public Alignment getHoverAlign()
this.showHover
is true, this property can be used to customize the alignment of content in the hover
canvas.getShowHover()
public Canvas setHoverAutoDestroy(java.lang.Boolean hoverAutoDestroy)
this.showHover
is true and getHoverComponent()
is implemented, should the hoverCanvas returned from it be automatically destroyed when it is
hidden? The default of null indicates that the component will be automatically destroyed. Set to false to prevent this.
hoverAutoDestroy
- New hoverAutoDestroy value. Default value is nullCanvas
instance, for chaining setter callssetShowHover(java.lang.Boolean)
public java.lang.Boolean getHoverAutoDestroy()
this.showHover
is true and getHoverComponent()
is implemented, should the hoverCanvas returned from it be automatically destroyed when it is
hidden? The default of null indicates that the component will be automatically destroyed. Set to false to prevent this.
getShowHover()
public Canvas setHoverAutoFitMaxWidth(int hoverAutoFitMaxWidth)
hoverAutoFitWidth
is enabled. May be specified as a pixel value, or a percentage of page width.hoverAutoFitMaxWidth
- New hoverAutoFitMaxWidth value. Default value is 200Canvas
instance, for chaining setter callspublic int getHoverAutoFitMaxWidth()
hoverAutoFitWidth
is enabled. May be specified as a pixel value, or a percentage of page width.public Canvas setHoverAutoFitMaxWidth(java.lang.String hoverAutoFitMaxWidth)
hoverAutoFitWidth
is enabled. May be specified as a pixel value, or a percentage of page width.hoverAutoFitMaxWidth
- New hoverAutoFitMaxWidth value. Default value is 200Canvas
instance, for chaining setter callspublic java.lang.String getHoverAutoFitMaxWidthAsString()
hoverAutoFitWidth
is enabled. May be specified as a pixel value, or a percentage of page width.public Canvas setHoverAutoFitWidth(java.lang.Boolean hoverAutoFitWidth)
showHover
is true, this property will cause the specified
hoverWidth
to be treated as a minimum width for the hover. If
the hover content string exceeds this, the hover will expand to accommodate it up to hoverAutoFitMaxWidth
(without the text wrapping). Using
this settings differs from simply disabling wrapping via hoverWrap:false
as the content will wrap if the hoverAutoFitMaxWidth
is exceeded.
Note : This is an advanced setting
hoverAutoFitWidth
- New hoverAutoFitWidth value. Default value is trueCanvas
instance, for chaining setter callssetShowHover(java.lang.Boolean)
public java.lang.Boolean getHoverAutoFitWidth()
showHover
is true, this property will cause the specified
hoverWidth
to be treated as a minimum width for the hover. If
the hover content string exceeds this, the hover will expand to accommodate it up to hoverAutoFitMaxWidth
(without the text wrapping). Using
this settings differs from simply disabling wrapping via hoverWrap:false
as the content will wrap if the hoverAutoFitMaxWidth
is exceeded.
getShowHover()
public Canvas setHoverDelay(int hoverDelay)
this.canHover
is true, how long should the mouse be kept over this widget before the hover event is
firedhoverDelay
- New hoverDelay value. Default value is 300Canvas
instance, for chaining setter callssetCanHover(java.lang.Boolean)
,
HoverEvent
public int getHoverDelay()
this.canHover
is true, how long should the mouse be kept over this widget before the hover event is
firedgetCanHover()
,
HoverEvent
public Canvas setHoverFocusKey(java.lang.String hoverFocusKey)
showing a hover
, this attribute gives users a way
to pin the hover in place so they can interact with it (scroll it, click embedded links, etc). Clicking outside the
hover (on some other component) will still dismiss it. When enabled, the standard hover canvas will display the
focusKeyHintLabel
to prompt the user on how to give the
hover focus. This behavior may be disabled by setting showFocusKeyHint
to false
Note that setting a hoverFocusKey also sets hoverPersist
to "clickPin". This makes hovers stay visible while
the cursor is over them, and become pinned if clicked, the same as pressing the hoverFocusKey.
public java.lang.String getHoverFocusKey()
showing a hover
, this attribute gives users a way
to pin the hover in place so they can interact with it (scroll it, click embedded links, etc). Clicking outside the
hover (on some other component) will still dismiss it. When enabled, the standard hover canvas will display the
focusKeyHintLabel
to prompt the user on how to give the
hover focus. This behavior may be disabled by setting showFocusKeyHint
to false
Note that setting a hoverFocusKey also sets hoverPersist
to "clickPin". This makes hovers stay visible while
the cursor is over them, and become pinned if clicked, the same as pressing the hoverFocusKey.
KeyName
public Canvas setHoverHeight(java.lang.Integer hoverHeight)
this.showHover
is true, this property can be used to customize the height of the hover canvas shown.hoverHeight
- New hoverHeight value. Default value is nullCanvas
instance, for chaining setter callssetShowHover(java.lang.Boolean)
public java.lang.Integer getHoverHeight()
this.showHover
is true, this property can be used to customize the height of the hover canvas shown.getShowHover()
public Canvas setHoverMoveWithMouse(java.lang.Boolean hoverMoveWithMouse)
this.showHover
is true, should this widget's hover canvas be moved with the mouse while visible?hoverMoveWithMouse
- New hoverMoveWithMouse value. Default value is nullCanvas
instance, for chaining setter callssetShowHover(java.lang.Boolean)
public java.lang.Boolean getHoverMoveWithMouse()
this.showHover
is true, should this widget's hover canvas be moved with the mouse while visible?getShowHover()
public Canvas setHoverOpacity(java.lang.Integer hoverOpacity)
this.showHover
is true, should the hover canvas be shown with opacity other than 100?hoverOpacity
- New hoverOpacity value. Default value is nullCanvas
instance, for chaining setter callssetShowHover(java.lang.Boolean)
,
Hovers / Tooltips Examplepublic java.lang.Integer getHoverOpacity()
this.showHover
is true, should the hover canvas be shown with opacity other than 100?getShowHover()
,
Hovers / Tooltips Examplepublic Canvas setHoverPersist(HoverPersistMode hoverPersist)
hoverPersist
- New hoverPersist value. Default value is nullCanvas
instance, for chaining setter callscom.smartgwt.client.widgets.Hover#persistent
public HoverPersistMode getHoverPersist()
com.smartgwt.client.widgets.Hover#persistent
public Canvas setHoverScreen(java.lang.String hoverScreen) throws java.lang.IllegalStateException
createScreen()
) in lieu of calling getHoverComponent()
.hoverScreen
- New hoverScreen value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getHoverScreen()
createScreen()
) in lieu of calling getHoverComponent()
.public Canvas setHoverStyle(java.lang.String hoverStyle)
this.showHover
is true, this property can be used to specify the css style to apply to the hover canvas.hoverStyle
- New hoverStyle value. Default value is nullCanvas
instance, for chaining setter callssetShowHover(java.lang.Boolean)
,
CSSStyleName
,
Hovers / Tooltips Examplepublic java.lang.String getHoverStyle()
this.showHover
is true, this property can be used to specify the css style to apply to the hover canvas.getShowHover()
,
CSSStyleName
,
Hovers / Tooltips Examplepublic Canvas setHoverVAlign(VerticalAlignment hoverVAlign)
this.showHover
is true, this property can be used to customize the vertical alignment of content in the
hover canvas.hoverVAlign
- New hoverVAlign value. Default value is nullCanvas
instance, for chaining setter callssetShowHover(java.lang.Boolean)
public VerticalAlignment getHoverVAlign()
this.showHover
is true, this property can be used to customize the vertical alignment of content in the
hover canvas.getShowHover()
public Canvas setHoverWidth(int hoverWidth)
this.showHover
is true, this property can be used to
customize the width of the hover canvas shown. See also hoverAutoFitWidth
and hoverAutoFitMaxWidth
.hoverWidth
- New hoverWidth value. Default value is 1Canvas
instance, for chaining setter callssetShowHover(java.lang.Boolean)
,
Hovers / Tooltips Examplepublic int getHoverWidth()
this.showHover
is true, this property can be used to
customize the width of the hover canvas shown. See also hoverAutoFitWidth
and hoverAutoFitMaxWidth
.getShowHover()
,
Hovers / Tooltips Examplepublic Canvas setHoverWrap(java.lang.Boolean hoverWrap)
this.showHover
is true, this property can be used to customize the whether content in the hover canvas
is displayed in a single line, or wraps. Note that if developers wish to have hovers expand horizontally to fit
their text without wrapping *up to some maximum*, and then wrap rather than exceeding that maximum, the hoverAutoFitWidth
and hoverAutoFitMaxWidth
attributes may be used instead of
simply setting hoverWrap to false.
hoverWrap
- New hoverWrap value. Default value is nullCanvas
instance, for chaining setter callssetShowHover(java.lang.Boolean)
public java.lang.Boolean getHoverWrap()
this.showHover
is true, this property can be used to customize the whether content in the hover canvas
is displayed in a single line, or wraps. Note that if developers wish to have hovers expand horizontally to fit
their text without wrapping *up to some maximum*, and then wrap rather than exceeding that maximum, the hoverAutoFitWidth
and hoverAutoFitMaxWidth
attributes may be used instead of
simply setting hoverWrap to false.
getShowHover()
public Canvas setHtmlElement(com.google.gwt.dom.client.Element htmlElement)
draw()
. If provided as a String, the String will be replaced by a DOM
node as returned from document.getElementById(htmlElement) on initialization. NOTES:
This feature is
intended for integration with other JavaScript frameworks and legacy page architectures only; the native browser's
reaction to DOM insertion is unspecified and unsupported. For consistent cross-browser layout and positioning semantics,
use Canvas parents (especially Layouts) and use absolute positioning at top level.
In some cases, the target element may need a specified height to be rendered correctly. In this cases, you can expect to find a message like the following in the JavaScript console: "isc_DataView_0:can't resize to height: 0; clamping to 1 [enable 'sizing' log for stack trace]"
Persistence of htmlElement: If htmlPosition
is set to "replace"
the htmlElement will be removed from the DOM when the canvas is drawn - therefore the
htmlElement attribute will be cleared at this time. Otherwise if a Canvas is clear()d and then draw()n again it will be
rendered inside the same htmlElement.
If a Canvas is added as a child to Canvas parent, its htmlElement will be
dropped.
position
should typically be set to
"relative"
if the widget is to be rendered inline within a standard page.
If this method is called after the component has been drawn/initialized:
Setter for the htmlElement
.
Note : This is an advanced setting
setHtmlElement
in class BaseWidget
htmlElement
- New htmlElement for this canvas or Null to clear the existing htmlElement. You may also provide a string with
the elements ID, which will have the effect of setting htmlElement
to the node returned by document.getElementById(element). Note that you may need to set
position:relative explicitly following a call to this function. Default value is nullCanvas
instance, for chaining setter callsPositioning overview and related methods
public com.google.gwt.dom.client.Element getHtmlElement()
draw()
. If provided as a String, the String will be replaced by a DOM
node as returned from document.getElementById(htmlElement) on initialization. NOTES:
This feature is
intended for integration with other JavaScript frameworks and legacy page architectures only; the native browser's
reaction to DOM insertion is unspecified and unsupported. For consistent cross-browser layout and positioning semantics,
use Canvas parents (especially Layouts) and use absolute positioning at top level.
In some cases, the target element may need a specified height to be rendered correctly. In this cases, you can expect to find a message like the following in the JavaScript console: "isc_DataView_0:can't resize to height: 0; clamping to 1 [enable 'sizing' log for stack trace]"
Persistence of htmlElement: If htmlPosition
is set to "replace"
the htmlElement will be removed from the DOM when the canvas is drawn - therefore the
htmlElement attribute will be cleared at this time. Otherwise if a Canvas is clear()d and then draw()n again it will be
rendered inside the same htmlElement.
If a Canvas is added as a child to Canvas parent, its htmlElement will be
dropped.
position
should typically be set to
"relative"
if the widget is to be rendered inline within a standard page.
Positioning overview and related methods
public Canvas setHtmlElement(java.lang.String htmlElement)
draw()
. If provided as a String, the String will be replaced by a DOM
node as returned from document.getElementById(htmlElement) on initialization. NOTES:
This feature is
intended for integration with other JavaScript frameworks and legacy page architectures only; the native browser's
reaction to DOM insertion is unspecified and unsupported. For consistent cross-browser layout and positioning semantics,
use Canvas parents (especially Layouts) and use absolute positioning at top level.
In some cases, the target element may need a specified height to be rendered correctly. In this cases, you can expect to find a message like the following in the JavaScript console: "isc_DataView_0:can't resize to height: 0; clamping to 1 [enable 'sizing' log for stack trace]"
Persistence of htmlElement: If htmlPosition
is set to "replace"
the htmlElement will be removed from the DOM when the canvas is drawn - therefore the
htmlElement attribute will be cleared at this time. Otherwise if a Canvas is clear()d and then draw()n again it will be
rendered inside the same htmlElement.
If a Canvas is added as a child to Canvas parent, its htmlElement will be
dropped.
position
should typically be set to
"relative"
if the widget is to be rendered inline within a standard page.
If this method is called after the component has been drawn/initialized:
Setter for the htmlElement
.
Note : This is an advanced setting
htmlElement
- New htmlElement for this canvas or Null to clear the existing htmlElement. You may also provide a string with
the elements ID, which will have the effect of setting htmlElement
to the node returned by document.getElementById(element). Note that you may need to set
position:relative explicitly following a call to this function. Default value is nullCanvas
instance, for chaining setter callsPositioning overview and related methods
public java.lang.String getHtmlElementAsString()
draw()
. If provided as a String, the String will be replaced by a DOM
node as returned from document.getElementById(htmlElement) on initialization. NOTES:
This feature is
intended for integration with other JavaScript frameworks and legacy page architectures only; the native browser's
reaction to DOM insertion is unspecified and unsupported. For consistent cross-browser layout and positioning semantics,
use Canvas parents (especially Layouts) and use absolute positioning at top level.
In some cases, the target element may need a specified height to be rendered correctly. In this cases, you can expect to find a message like the following in the JavaScript console: "isc_DataView_0:can't resize to height: 0; clamping to 1 [enable 'sizing' log for stack trace]"
Persistence of htmlElement: If htmlPosition
is set to "replace"
the htmlElement will be removed from the DOM when the canvas is drawn - therefore the
htmlElement attribute will be cleared at this time. Otherwise if a Canvas is clear()d and then draw()n again it will be
rendered inside the same htmlElement.
If a Canvas is added as a child to Canvas parent, its htmlElement will be
dropped.
position
should typically be set to
"relative"
if the widget is to be rendered inline within a standard page.
Positioning overview and related methods
public Canvas setHtmlPosition(DrawPosition htmlPosition)
htmlElement
is specified, this attribute specifies the
position where the canvas should be inserted relative to the htmlElement
in the DOM.
htmlPosition
.
Note : This is an advanced setting
htmlPosition
- New htmlPosition for this canvas. Default value is "afterBegin"Canvas
instance, for chaining setter callsPositioning overview and related methods
public DrawPosition getHtmlPosition()
htmlElement
is specified, this attribute specifies the
position where the canvas should be inserted relative to the htmlElement
in the DOM.Positioning overview and related methods
public Canvas setIsGroup(boolean isGroup) throws java.lang.IllegalStateException
groupTitle
.isGroup
- New isGroup value. Default value is trueCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdsetGroupBorderCSS(java.lang.String)
,
setGroupLabelStyleName(java.lang.String)
,
setGroupLabelBackgroundColor(java.lang.String)
,
Appearance overview and related methods
public boolean getIsGroup()
groupTitle
.getGroupBorderCSS()
,
getGroupLabelStyleName()
,
getGroupLabelBackgroundColor()
,
Appearance overview and related methods
public java.lang.Boolean getIsPrinting() throws java.lang.IllegalStateException
showPrintPreview()
(or just getPrintHTML()
). Note that this flag is set recursively as parent
widgets generate print HTML for their children. This is a read-only property and should not be modified by application code.
Note : This method should be called only after the widget has been rendered.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public Canvas setIsRuleScope(java.lang.Boolean isRuleScope) throws java.lang.IllegalStateException
ruleScope
that will be discovered by
any contained DataBoundComponent
s which do not specify an explicit
ruleScope
.isRuleScope
- New isRuleScope value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getIsRuleScope()
ruleScope
that will be discovered by
any contained DataBoundComponent
s which do not specify an explicit
ruleScope
.public Canvas setIsSnapAlignCandidate(java.lang.Boolean isSnapAlignCandidate)
childrenSnapAlign
is enabled on this Canvas' parent.isSnapAlignCandidate
- New isSnapAlignCandidate value. Default value is nullCanvas
instance, for chaining setter callsSnapGridDragging overview and related methods
public java.lang.Boolean getIsSnapAlignCandidate()
childrenSnapAlign
is enabled on this Canvas' parent.SnapGridDragging overview and related methods
public Canvas setKeepInParentRect(java.lang.Boolean keepInParentRect)
If this canvas has no parent, constrains dragging to within the browser window.
Affects target and outline dragAppearance, not tracker.
Note: keepInParentRect affects only user drag interactions, not programmatic moves.
Example use cases:
keepInParentRect: true
-
confine to parent
keepInParentRect: [0, 0, 500, 500]
- confine to top left 500x500 region within
parent
keepInParentRect: [0, 0, 10000, 10000]
- in combination with overflow: "auto", confine to
parent, but allow moving off the right and bottom of the parent to force scrolling (and hence enlarge the scrollWidth of
the parent).
Note : This is an advanced setting
keepInParentRect
- New keepInParentRect value. Default value is nullCanvas
instance, for chaining setter callsDrag and Drop
,
Drag create Examplepublic java.lang.Boolean getKeepInParentRect()
If this canvas has no parent, constrains dragging to within the browser window.
Affects target and outline dragAppearance, not tracker.
Note: keepInParentRect affects only user drag interactions, not programmatic moves.
Example use cases:
keepInParentRect: true
-
confine to parent
keepInParentRect: [0, 0, 500, 500]
- confine to top left 500x500 region within
parent
keepInParentRect: [0, 0, 10000, 10000]
- in combination with overflow: "auto", confine to
parent, but allow moving off the right and bottom of the parent to force scrolling (and hence enlarge the scrollWidth of
the parent).
Drag and Drop
,
Drag create Examplepublic Canvas setKeepInParentRect(java.lang.Integer... keepInParentRect)
If this canvas has no parent, constrains dragging to within the browser window.
Affects target and outline dragAppearance, not tracker.
Note: keepInParentRect affects only user drag interactions, not programmatic moves.
Example use cases:
keepInParentRect: true
-
confine to parent
keepInParentRect: [0, 0, 500, 500]
- confine to top left 500x500 region within
parent
keepInParentRect: [0, 0, 10000, 10000]
- in combination with overflow: "auto", confine to
parent, but allow moving off the right and bottom of the parent to force scrolling (and hence enlarge the scrollWidth of
the parent).
Note : This is an advanced setting
keepInParentRect
- New keepInParentRect value. Default value is nullCanvas
instance, for chaining setter callsDrag and Drop
,
Drag create Examplepublic Canvas setLayoutAlign(Alignment layoutAlign)
layoutAlign
- New layoutAlign value. Default value is nullCanvas
instance, for chaining setter callsLayoutMember overview and related methods
public Alignment getLayoutAlign()
LayoutMember overview and related methods
public Canvas setLayoutAlign(VerticalAlignment layoutAlign)
layoutAlign
- New layoutAlign value. Default value is nullCanvas
instance, for chaining setter callsLayoutMember overview and related methods
public Canvas setLeaveGroupLabelSpace(java.lang.Boolean leaveGroupLabelSpace) throws java.lang.IllegalStateException
group
, should any content be shifted
down so that the group-label doesn't sit in front of it?leaveGroupLabelSpace
- New leaveGroupLabelSpace value. Default value is trueCanvas
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 getLeaveGroupLabelSpace()
group
, should any content be shifted
down so that the group-label doesn't sit in front of it?Appearance overview and related methods
public Canvas setLeavePageSpace(java.lang.Integer leavePageSpace)
defaultPageSpace
.
leavePageSpace
.
Note : This is an advanced setting
leavePageSpace
- new value for leavePageSpace
. Default value is nullCanvas
instance, for chaining setter callsPositioning overview and related methods
public java.lang.Integer getLeavePageSpace()
defaultPageSpace
.Positioning overview and related methods
public Canvas setLeft(int left)
position
property). Can also be set as a percentage, specified as a
String ending in '%', eg, "50%". In this case the top coordinate is considered as a percentage of the specified width
of the parent
.
If this method is called after the component has been drawn/initialized:
Set the left coordinate of this object, relative to its enclosing context, in pixels. NOTE: if you're setting multiple coordinates, use setRect(), moveTo() or resizeTo() instead
left
- new left coordinate. Default value is 0Canvas
instance, for chaining setter callsPositioning overview and related methods
public int getLeft()
position
property). Can also be set as a percentage, specified as a
String ending in '%', eg, "50%". In this case the top coordinate is considered as a percentage of the specified width
of the parent
.
Positioning overview and related methods
public Canvas setLeft(java.lang.String left)
position
property). Can also be set as a percentage, specified as a
String ending in '%', eg, "50%". In this case the top coordinate is considered as a percentage of the specified width
of the parent
.
If this method is called after the component has been drawn/initialized:
Set the left coordinate of this object, relative to its enclosing context, in pixels. NOTE: if you're setting multiple coordinates, use setRect(), moveTo() or resizeTo() instead
left
- new left coordinate. Default value is 0Canvas
instance, for chaining setter callsPositioning overview and related methods
public Canvas setLocateByIDOnly(boolean locateByIDOnly)
true
, when retrieving a locator
for this component
always return a reference directly to this component by widget ID
,
using the compact format "///canvasID"
, ignoring any parent elements and ignoring any configured
testRoot
. This format of locator will always be resolved back to the
component by ID regardless of any changes in its position in the UI structure of an application. This setting is
appropriate for components which are expected to always be present in an application with a stable ID
.
Note : This is an advanced setting
locateByIDOnly
- New locateByIDOnly value. Default value is falseCanvas
instance, for chaining setter callspublic boolean getLocateByIDOnly()
true
, when retrieving a locator
for this component
always return a reference directly to this component by widget ID
,
using the compact format "///canvasID"
, ignoring any parent elements and ignoring any configured
testRoot
. This format of locator will always be resolved back to the
component by ID regardless of any changes in its position in the UI structure of an application. This setting is
appropriate for components which are expected to always be present in an application with a stable ID
.
public Canvas setLocateChildrenBy(LocatorStrategy locateChildrenBy)
Note : This is an advanced setting
locateChildrenBy
- New locateChildrenBy value. Default value is nullCanvas
instance, for chaining setter callspublic LocatorStrategy getLocateChildrenBy()
public Canvas setLocateChildrenType(LocatorTypeStrategy locateChildrenType)
LocatorTypeStrategy
to use when finding children within this canvas.
Note : This is an advanced setting
locateChildrenType
- New locateChildrenType value. Default value is nullCanvas
instance, for chaining setter callspublic LocatorTypeStrategy getLocateChildrenType()
LocatorTypeStrategy
to use when finding children within this canvas.public Canvas setLocatePeersBy(LocatorStrategy locatePeersBy)
Note : This is an advanced setting
locatePeersBy
- New locatePeersBy value. Default value is nullCanvas
instance, for chaining setter callspublic LocatorStrategy getLocatePeersBy()
public Canvas setLocatePeersType(LocatorTypeStrategy locatePeersType)
LocatorTypeStrategy
to use when finding peers of this canvas.
Note : This is an advanced setting
locatePeersType
- New locatePeersType value. Default value is nullCanvas
instance, for chaining setter callspublic LocatorTypeStrategy getLocatePeersType()
LocatorTypeStrategy
to use when finding peers of this canvas.public Canvas setLocatorName(java.lang.String locatorName)
index
if
found. This name must by unique within the parent component. By setting a static ID on certain top-level components and then using locatorName in contained components, stable locators can be created for these components without the need to pervasively assign IDs.
Note : This is an advanced setting
locatorName
- New locatorName value. Default value is nullCanvas
instance, for chaining setter callspublic java.lang.String getLocatorName()
index
if
found. This name must by unique within the parent component. By setting a static ID on certain top-level components and then using locatorName in contained components, stable locators can be created for these components without the need to pervasively assign IDs.
public Canvas setMargin(java.lang.Integer margin)
This property
sets the same thickness of margin on every side. Differing per-side margins can be set in a CSS style and applied via
styleName
.
Note that the specified size of the widget will
be the size including the margin thickness on each side.
If this method is called after the component has been drawn/initialized:
Set the CSS Margin, in pixels, for this component. Margin provides blank space outside of the border.
This property sets the same thickness of margin on every side. Differing per-side margins can be set in a CSS style and applied via styleName
.
Note that the specified size of the widget will be the size including the margin thickness on each side.
margin
- new margin in pixels. Default value is nullCanvas
instance, for chaining setter callsAppearance overview and related methods
public java.lang.Integer getMargin()
This property
sets the same thickness of margin on every side. Differing per-side margins can be set in a CSS style and applied via
styleName
.
Note that the specified size of the widget will be the size including the margin thickness on each side.
Appearance overview and related methods
public Canvas getMasterElement() throws java.lang.IllegalStateException
getMasterCanvas()
as of Smart GWT release 9.1Note : This method should be called only after the widget has been rendered.
java.lang.IllegalStateException
- if this widget has not yet been rendered.Component Containment and Hierarchy
public Canvas setMatchElement(java.lang.Boolean matchElement)
htmlElement
is specified, should this canvas be drawn at
the same dimensions as the htmlElement?matchElementWidth
and matchElementHeight
By
default, if htmlPosition
is anything other than
"replace"
, setting this property will cause the canvas resize with the element if the element itself
subsequently resizes (for example due to page reflow).
To disable this behavior for backwards compatibility or other
reasons, use persistentMatchElement
Note : This is an advanced setting
matchElement
- New matchElement value. Default value is nullCanvas
instance, for chaining setter callspublic java.lang.Boolean getMatchElement()
htmlElement
is specified, should this canvas be drawn at
the same dimensions as the htmlElement?matchElementWidth
and matchElementHeight
By
default, if htmlPosition
is anything other than
"replace"
, setting this property will cause the canvas resize with the element if the element itself
subsequently resizes (for example due to page reflow).
To disable this behavior for backwards compatibility or other
reasons, use persistentMatchElement
public Canvas setMatchElementHeight(MatchElementSizeMode matchElementHeight) throws java.lang.IllegalStateException
htmlElement
where persistentMatchElement
is set to true, how should the
canvas match the element's height?
Note : This is an advanced setting
matchElementHeight
- New matchElementHeight value. Default value is "matchElement"Canvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic MatchElementSizeMode getMatchElementHeight()
htmlElement
where persistentMatchElement
is set to true, how should the
canvas match the element's height?public Canvas setMatchElementWidth(MatchElementSizeMode matchElementWidth) throws java.lang.IllegalStateException
htmlElement
where persistentMatchElement
is set to true, how should the
canvas match the element's width?
Note : This is an advanced setting
matchElementWidth
- New matchElementWidth value. Default value is "matchElement"Canvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic MatchElementSizeMode getMatchElementWidth()
htmlElement
where persistentMatchElement
is set to true, how should the
canvas match the element's width?public Canvas setMaxHeight(int maxHeight)
maxWidth
for
details of behavior.
Note : This is an advanced setting
maxHeight
- New maxHeight value. Default value is 10000Canvas
instance, for chaining setter callssetDragMaxHeight(int)
,
Sizing overview and related methods
public int getMaxHeight()
maxWidth
for
details of behavior.getDragMaxHeight()
,
Sizing overview and related methods
public Canvas setMaxWidth(int maxWidth)
The maxWidth
and maxHeight
settings apply to:
Layout
, the maximum size the layout should apply to the
canvas. CanvasItem
(maxHeight
only) drag resizing
ListGrid recordComponents
.
Note : This is an advanced setting
maxWidth
- New maxWidth value. Default value is 10000Canvas
instance, for chaining setter callssetDragMaxWidth(int)
,
Sizing overview and related methods
public int getMaxWidth()
The maxWidth
and maxHeight
settings apply to:
Layout
, the maximum size the layout should apply to the
canvas. CanvasItem
(maxHeight
only) drag resizing
ListGrid recordComponents
.getDragMaxWidth()
,
Sizing overview and related methods
public Canvas setMaxZoomOverflowError(int maxZoomOverflowError)
correctZoomOverflow
is true and browser or
OS-level zoom is active, determines how much overflow must occur before the Framework enables scrolling for this canvas.
The larger the value, the more clipping that can occur before scrolling is enabled. So, this property should never be set larger than the minimum amount needed to prevent scrollbar oscillation when zoomed - which is the maximum scrollHeight or scrollWidth error.
Note : This is an advanced setting
maxZoomOverflowError
- New maxZoomOverflowError value. Default value is variesCanvas
instance, for chaining setter callspublic int getMaxZoomOverflowError()
correctZoomOverflow
is true and browser or
OS-level zoom is active, determines how much overflow must occur before the Framework enables scrolling for this canvas.
The larger the value, the more clipping that can occur before scrolling is enabled. So, this property should never be set larger than the minimum amount needed to prevent scrollbar oscillation when zoomed - which is the maximum scrollHeight or scrollWidth error.
public Canvas setMenuConstructor(java.lang.String menuConstructor) throws java.lang.IllegalStateException
menuConstructor
- New menuConstructor value. Default value is "Menu"Canvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdShowContextMenuEvent
,
SCClassName
,
Cues overview and related methods
public java.lang.String getMenuConstructor()
ShowContextMenuEvent
,
SCClassName
,
Cues overview and related methods
public Canvas setMinHeight(int minHeight)
minWidth
for details.
minHeight
.
Note : This is an advanced setting
minHeight
- new minimum height. Default value is 0Canvas
instance, for chaining setter callssetDragMinHeight(int)
,
Sizing overview and related methods
public int getMinHeight()
minWidth
for details.getDragMinHeight()
,
Sizing overview and related methods
public Canvas setMinNonEdgeSize(int minNonEdgeSize)
minNonEdgeSize
, the edgeMarginSize will be reduced such that the non-edge part
of the widget is at least 1/3 of the total space (with two draggable edges) or half of it (with one draggable edge).
Note : This is an advanced setting
minNonEdgeSize
- New minNonEdgeSize value. Default value is 0Canvas
instance, for chaining setter callsDrag and Drop
,
Drag resize Examplepublic int getMinNonEdgeSize()
minNonEdgeSize
, the edgeMarginSize will be reduced such that the non-edge part
of the widget is at least 1/3 of the total space (with two draggable edges) or half of it (with one draggable edge).Drag and Drop
,
Drag resize Examplepublic Canvas setMinWidth(int minWidth)
The minWidth
and minHeight
settings apply to:
Layout
, the minimum size the layout should apply to the
canvas. CanvasItem
(minHeight
only) drag resizing
Overflow
"visible" outside of a Layout - minimum size will be the greater of this
setting or the minimum size needed to make all content visible Minimum sizes do not apply in various
other circumstances where sizes are being determined, such as ListGrid recordComponents
.
See also Layout.minMemberLength
as a way of establishing minimum
sizes along the length axis for all members of a Layout
with a single
setting.
If this method is called after the component has been drawn/initialized:
Resizes the widget horizontally if required to satisfy the specified minWidth
.
Note : This is an advanced setting
minWidth
- new minimum width. Default value is 0Canvas
instance, for chaining setter callssetDragMinWidth(int)
,
Sizing overview and related methods
public int getMinWidth()
The minWidth
and minHeight
settings apply to:
Layout
, the minimum size the layout should apply to the
canvas. CanvasItem
(minHeight
only) drag resizing
Overflow
"visible" outside of a Layout - minimum size will be the greater of this
setting or the minimum size needed to make all content visible Minimum sizes do not apply in various
other circumstances where sizes are being determined, such as ListGrid recordComponents
.
See also Layout.minMemberLength
as a way of establishing minimum
sizes along the length axis for all members of a Layout
with a single
setting.
getDragMinWidth()
,
Sizing overview and related methods
public Canvas setMomentumScrollMinSpeed(double momentumScrollMinSpeed)
Note : This is an advanced setting
momentumScrollMinSpeed
- New momentumScrollMinSpeed value. Default value is 200Canvas
instance, for chaining setter callspublic double getMomentumScrollMinSpeed()
public Canvas setMouseStillDownDelay(int mouseStillDownDelay)
Canvas.mouseStillDown()
for details.
Note : This is an advanced setting
mouseStillDownDelay
- New mouseStillDownDelay value. Default value is 100Canvas
instance, for chaining setter callspublic int getMouseStillDownDelay()
Canvas.mouseStillDown()
for details.public Canvas setMouseStillDownInitialDelay(int mouseStillDownInitialDelay)
Canvas.mouseStillDown()
for details.
Note : This is an advanced setting
mouseStillDownInitialDelay
- New mouseStillDownInitialDelay value. Default value is 400Canvas
instance, for chaining setter callspublic int getMouseStillDownInitialDelay()
Canvas.mouseStillDown()
for details.public Canvas setName(java.lang.String name) throws java.lang.IllegalStateException
parent
to get defined results for Layout.getMember()
and Layout.getMemberNumber()
.name
- New name value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdBaseWidget.setID(java.lang.String)
,
Identifier
public java.lang.String getName()
parent
to get defined results for Layout.getMember()
and Layout.getMemberNumber()
.BaseWidget.getID()
,
Identifier
public Canvas setNativeAutoHideScrollbars(java.lang.Boolean nativeAutoHideScrollbars) throws java.lang.IllegalStateException
If nativeAutoHideScrollbars
is set to true, we
detect platforms that show scrollbars dynamically on user interaction and for components with showCustomScrollbars
we ignore the specified scrollbarConstructor
, and instead create system-managed
native scrollbars via the special NativeScrollbar class, and set floatingScrollbars
to true.
Not applicable to touch devices
Has no impact if alwaysShowScrollbars
is true.
If showCustomScrollbars
is false, this setting will have no
effect (we would be showing custom scrollbars in any case)
Also does not apply to touch scrolling interfaces
(where scrollbars are always hidden
unless alwaysShowScrollbars
is true).
Note : This is an advanced setting
nativeAutoHideScrollbars
- New nativeAutoHideScrollbars value. Default value is falseCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdScrolling overview and related methods
public java.lang.Boolean getNativeAutoHideScrollbars()
If nativeAutoHideScrollbars
is set to true, we
detect platforms that show scrollbars dynamically on user interaction and for components with showCustomScrollbars
we ignore the specified scrollbarConstructor
, and instead create system-managed
native scrollbars via the special NativeScrollbar class, and set floatingScrollbars
to true.
Not applicable to touch devices
Has no impact if alwaysShowScrollbars
is true.
If showCustomScrollbars
is false, this setting will have no
effect (we would be showing custom scrollbars in any case)
Also does not apply to touch scrolling interfaces
(where scrollbars are always hidden
unless alwaysShowScrollbars
is true).
Scrolling overview and related methods
public Canvas setNoDoubleClicks(java.lang.Boolean noDoubleClicks)
click
events rather than as doubleClick
events.
Note : This is an advanced setting
noDoubleClicks
- New noDoubleClicks value. Default value is nullCanvas
instance, for chaining setter callspublic java.lang.Boolean getNoDoubleClicks()
click
events rather than as doubleClick
events.public Canvas setNoDropCursor(Cursor noDropCursor)
showNoDropIndicator
is
true.
Note : This is an advanced setting
noDropCursor
- New noDropCursor value. Default value is Canvas.NOT_ALLOWEDCanvas
instance, for chaining setter callsCues overview and related methods
public Cursor getNoDropCursor()
showNoDropIndicator
is
true.Cues overview and related methods
public Canvas 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 useOpacityFilter
to true for specific components
on which opacity support is required.
Also note that opacity is incompatible with backMasks
.
If this method is called after the component has been drawn/initialized:
Sets the opacity for the widget to the newOpacity value. This newOpacity value must be within the range of 0 (transparent) to 100 (opaque). Null means don't specify opacity directly. Note that heavy use of opacity may have a performance impact on some older browsers.
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 useOpacityFilter
to true for specific components on which opacity support is required.
Also note that opacity is incompatible with backMasks
.
Note : This is an advanced setting
opacity
- new opacity level. Default value is nullCanvas
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 useOpacityFilter
to true for specific components
on which opacity support is required.
Also note that opacity is incompatible with backMasks
.
Cues overview and related methods
public Canvas setOverflow(Overflow overflow)
overflow
of a Canvas after it has been created.overflow
- New overflow value. Default value is Canvas.VISIBLECanvas
instance, for chaining setter callsSizing overview and related methods
public Overflow getOverflow()
Sizing overview and related methods
public Canvas setPadding(java.lang.Integer padding)
This property sets the same thickness of padding on every side. Differing per-side padding can be set in
a CSS style and applied via styleName
.
Note that CSS padding
does not affect the placement of children
. To provide a blank
area around children, either use CSS margins
or use a Layout
as the parent instead, and use properties such as Layout.layoutMargin
to create blank space.
If this method is called after the component has been drawn/initialized:
Set the CSS padding of this component, in pixels. Padding provides space between the border and the component's contents.
This property sets the same thickness of padding on every side. Differing per-side padding can be set in a CSS style and applied via styleName
.
padding
- new padding in pixels. Default value is nullCanvas
instance, for chaining setter callsAppearance overview and related methods
public java.lang.Integer getPadding()
This property sets the same thickness of padding on every side. Differing per-side padding can be set in
a CSS style and applied via styleName
.
Note that CSS padding
does not affect the placement of children
. To provide a blank
area around children, either use CSS margins
or use a Layout
as the parent instead, and use properties such as Layout.layoutMargin
to create blank space.
Appearance overview and related methods
public Canvas setParentCanvas(Canvas parentCanvas) throws java.lang.IllegalStateException
addChild()
and removeChild()
calls on the parent. The parent Canvas should be fetched using getParentCanvas()
. See Containment
for an overview of parent/child relationships.
parentCanvas
- New parentCanvas value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdComponent Containment and Hierarchy
public Canvas getParentCanvas()
addChild()
and removeChild()
calls on the parent. The parent Canvas should be fetched using getParentCanvas()
. See Containment
for an overview of parent/child relationships.
See Containment
for an overview of
parent/child relationships. Default value is null
Component Containment and Hierarchy
public Canvas setParentElement(Canvas parentElement) throws java.lang.IllegalStateException
parentCanvas
and getParentCanvas()
addChild()
and removeChild()
calls on the parent.
Note : This is an advanced setting
parentElement
- New parentElement value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdComponent Containment and Hierarchy
public Canvas getParentElement()
parentCanvas
and getParentCanvas()
addChild()
and removeChild()
calls on the parent.Component Containment and Hierarchy
public Canvas setPeers(Canvas... peers) throws java.lang.IllegalStateException
Use addPeer()
and removePeer()
to add and remove peers after a Canvas has been
created/drawn.
See Containment
for an overview of master/peer relationships.
Note : This is an advanced setting
peers
- New peers value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdComponent Containment and Hierarchy
public Canvas[] getPeers()
Use addPeer()
and removePeer()
to add and remove peers after a Canvas has been
created/drawn.
See Containment
for an overview of master/peer relationships.
Component Containment and Hierarchy
public Canvas setPendingMarkerStyle(java.lang.String pendingMarkerStyle)
showPendingMarker()
is called, or when pendingMarkerVisible
has been set. The default
pendingMarkerStyle
, pendingMarker, renders a small triangle in the top-left of the Canvas. You can
modify this class or provide a custom one to achieve a different display.
pendingMarkerStyle
- New pendingMarkerStyle value. Default value is "pendingMarker"Canvas
instance, for chaining setter callsCSSStyleName
public java.lang.String getPendingMarkerStyle()
showPendingMarker()
is called, or when pendingMarkerVisible
has been set. The default
pendingMarkerStyle
, pendingMarker, renders a small triangle in the top-left of the Canvas. You can
modify this class or provide a custom one to achieve a different display.
CSSStyleName
public Canvas setPendingMarkerVisible(java.lang.Boolean pendingMarkerVisible)
pending marker
class
should be appended to the list of CSS classes applied to this canvas. By default, this extra class overlays a
small shape in the corner of this canvas.pendingMarkerVisible
- New pendingMarkerVisible value. Default value is nullCanvas
instance, for chaining setter callspublic java.lang.Boolean getPendingMarkerVisible()
pending marker
class
should be appended to the list of CSS classes applied to this canvas. By default, this extra class overlays a
small shape in the corner of this canvas.public Canvas setPercentBox(PercentBoxModel percentBox) throws java.lang.IllegalStateException
snapTo
. Only affects widgets with a a specified
percentSource
, or widgets that have snapTo
set and are peers of some other canvas
.
Determines whether the coordinates used for sizing
(for percentage sized widgets) and positioning (if snapTo
is set) should be relative to the visible size or
the viewport size of the percentSource or master canvas
widget.
Note : This is an advanced setting
percentBox
- New percentBox value. Default value is "visible"Canvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdSizing overview and related methods
public PercentBoxModel getPercentBox()
snapTo
. Only affects widgets with a a specified
percentSource
, or widgets that have snapTo
set and are peers of some other canvas
.
Determines whether the coordinates used for sizing
(for percentage sized widgets) and positioning (if snapTo
is set) should be relative to the visible size or
the viewport size of the percentSource or master canvas
widget.
Sizing overview and related methods
public Canvas setPercentSource(Canvas percentSource)
If unset percentage sizing is based on
- the master canvas
if there is one and snapTo
is set,
- otherwise on the amount of space available in this
widget's parent canvas, if this is a child of some other widget
- otherwise the page size.
If this method is called after the component has been drawn/initialized:
Setter method for the percentSource
attribute.
Note : This is an advanced setting
percentSource
- eterNew percent source (if omitted existing percentSource will just be cleared). Default value is nullCanvas
instance, for chaining setter callssetPercentBox(com.smartgwt.client.types.PercentBoxModel)
,
Sizing overview and related methods
public Canvas getPercentSource()
If unset percentage sizing is based on
- the master canvas
if there is one and snapTo
is set,
- otherwise on the amount of space available in this
widget's parent canvas, if this is a child of some other widget
- otherwise the page size.
getPercentBox()
,
Sizing overview and related methods
public Canvas setPersistentMatchElement(java.lang.Boolean persistentMatchElement) throws java.lang.IllegalStateException
htmlElement
and matchElement
is set to true, should the canvas perform a one time
resize to fit the target element on draw, or should it continue to match the target element as its size changes due to
page reflows?
Note : This is an advanced setting
persistentMatchElement
- New persistentMatchElement value. Default value is trueCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getPersistentMatchElement()
htmlElement
and matchElement
is set to true, should the canvas perform a one time
resize to fit the target element on draw, or should it continue to match the target element as its size changes due to
page reflows?public Canvas setPointerSettings(PointerSettings pointerSettings) throws java.lang.IllegalStateException
pointer
such as where it should be
located along the outside of the canvas.pointerSettings
- New pointerSettings value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic PointerSettings getPointerSettings()
pointer
such as where it should be
located along the outside of the canvas.public Canvas setPointerTarget(java.lang.String pointerTarget) throws java.lang.IllegalStateException
pointerSettings.snapTo
places
the canvas in relation to the target canvas. Depending on the pointerSettings.snapTo
and the pointerSettings.targetSnapTo
the canvas will be positioned so the pointer
correctly points to the target.
A pointerTarget
can be specified ether as an AutoTestLocator
or a GlobalId
.
pointerTarget
- New pointerTarget value. Default value is nullCanvas
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdAutoTestLocator
public java.lang.String getPointerTarget()
pointerSettings.snapTo
places
the canvas in relation to the target canvas. Depending on the pointerSettings.snapTo
and the pointerSettings.targetSnapTo
the canvas will be positioned so the pointer
correctly points to the target.
A pointerTarget
can be specified ether as an AutoTestLocator
or a GlobalId
.
AutoTestLocator
public java.lang.String getPointerTargetAsString()
pointerSettings.snapTo
places
the canvas in relation to the target canvas. Depending on the pointerSettings.snapTo
and the pointerSettings.targetSnapTo
the canvas will be positioned so the pointer
correctly points to the target.
A pointerTarget
can be specified ether as an AutoTestLocator
or a GlobalId
.
AutoTestLocator
,
GlobalId
public Canvas setPosition(Positioning position)
Setting position:"relative"
enables Smart GWT components to be embedded
directly into the native HTML flow of a page, causing the component to be rendered
within an existing DOM structure.
This attribute should only be set to "relative"
on a top level component
(a component with no getParentCanvas()
).
There are 2 ways to embed relatively positioned canvases in the DOM - by default the
component will be written out inline when it gets drawn()n
. For example
to embed a canvas in an HTML table you could use this code:
<table> <tr> <td> <script> isc.Canvas.create({autoDraw:true, backgroundColor:"red", position:"relative"}); </script> <td> </tr> </table>Alternatively you can make use of the
htmlElement
attribute.
Relative positioning is intended as a short-term integration scenario while incrementally
upgrading existing applications.
Note that relative positioning is not used to manage layout within Smart GWT components -
instead the Layout
class would typically be used.
For best consistency and flexibility across browsers, all Smart GWT layout managers
use absolute positioning.
For canvases with a specified htmlElement
, this attribute
defaults to
"relative"
. In all other cases the default value will be
"absolute"
. Note that if you plan to call setHtmlElement()
after
init, you will need to set this value to "relative" explicitly.
Note : This is an advanced setting
position
- New position value. Default value is nullCanvas
instance, for chaining setter callsPositioning overview and related methods
public Positioning getPosition()
Setting position:"relative"
enables Smart GWT components to be embedded
directly into the native HTML flow of a page, causing the component to be rendered
within an existing DOM structure.
This attribute should only be set to "relative"
on a top level component
(a component with no getParentCanvas()
).
There are 2 ways to embed relatively positioned canvases in the DOM - by default the
component will be written out inline when it gets drawn()n
. For example
to embed a canvas in an HTML table you could use this code:
<table> <tr> <td> <script> isc.Canvas.create({autoDraw:true, backgroundColor:"red", position:"relative"}); </script> <td> </tr> </table>Alternatively you can make use of the
htmlElement
attribute.
Relative positioning is intended as a short-term integration scenario while incrementally
upgrading existing applications.
Note that relative positioning is not used to manage layout within Smart GWT components -
instead the Layout
class would typically be used.
For best consistency and flexibility across browsers, all Smart GWT layout managers
use absolute positioning.
For canvases with a specified htmlElement
, this attribute
defaults to
"relative"
. In all other cases the default value will be
"absolute"
. Note that if you plan to call setHtmlElement()
after
init, you will need to set this value to "relative" explicitly.
Positioning overview and related methods
public Canvas setPrintChildrenAbsolutelyPositioned(java.lang.Boolean printChildrenAbsolutelyPositioned)
printable HTML
. By default explicitly specified absolute positioning and sizing is ignored when generating print HTML. This is done intentionally: there is no way for the framework to predict how explicit sizes will translate to a the printed page and if HTML for printing includes the same absolute positioning and sizing as is displayed within an application it is very common to encounter undesirable effects, such as seeing tables get broken over several pages horizontally when there is enough room to print them on a single page of paper.
In some cases, however, a developer may wish to have explicit sizing and positioning respected
within the print-view. Setting this attribute to true
will cause this to occur.
Note : This is an advanced setting