public class EditProxy extends BaseClass
DevTools overview and related methods
config, configOnly, factoryCreated, factoryProperties, id, scClassName
Constructor and Description |
---|
EditProxy() |
EditProxy(com.google.gwt.core.client.JavaScriptObject jsObj) |
Modifier and Type | Method and Description |
---|---|
com.google.gwt.core.client.JavaScriptObject |
create() |
java.lang.Boolean |
getAllowNestedDrops()
This property acts as a component-specific override for the
EditContext.allowNestedDrops property. |
java.lang.Boolean |
getAutoMaskChildren()
When child nodes are added to an EditContext, should they be masked by setting
EditNode.useEditMask true if not explicitly set? |
java.lang.Boolean |
getBringToFrontOnSelect()
Should component be brought to front when selected? Applies when
EditNode.useEditMask :true. |
java.lang.Boolean |
getCanSelect()
Can this component be selected? Selection is allowed unless this property is set to
false . |
java.lang.Boolean |
getCanSelectChildren()
Whether to allow selection of the children of this
EditNode . |
java.lang.Boolean |
getChildrenSnapResizeToGrid()
If not null the
Canvas.childrenSnapResizeToGrid
on the component represented by this EditProxy is set to this value only while in edit mode. |
java.lang.Boolean |
getChildrenSnapToGrid()
If not null the
Canvas.childrenSnapToGrid on the
component represented by this EditProxy is set to this value only while in edit mode. |
Canvas |
getEditMask()
An editMask is created for any component placed into editMode with
EditNode.useEditMask :true. |
Canvas |
getHoopSelector()
Hoop selector canvas used for selecting multiple components.
|
InlineEditEvent |
getInlineEditEvent()
Event that triggers inline editing, showing the
inlineEditForm , which consists of a single text input (single or multi-line according to inlineEditMultiline ) shown in the inlineEditForm AutoChild. |
DynamicForm |
getInlineEditForm()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
Label |
getInlineEditInstructionLabel()
Label AutoChild used to display
inlineEditInstructions below the text entry area if provided. |
java.lang.String |
getInlineEditInstructions()
Instructions that appear below the text entry area if inline editing is enabled.
|
java.lang.Boolean |
getInlineEditMultiline()
Whether inline editing should be single or multi-line.
|
java.lang.Boolean |
getInlineEditOnDrop()
Should the inline editor be shown when new component is first dropped?
|
void |
getInlineEditText()
Returns the text based on the current component state to be edited inline.
|
com.google.gwt.core.client.JavaScriptObject |
getJsObj() |
com.google.gwt.core.client.JavaScriptObject |
getOrCreateJsObj() |
static EditProxy |
getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj) |
java.lang.Boolean |
getPersistCoordinates()
Changes to all child
liveObject 's position and size can be
persisted to their EditNodes based on this attribute setting and EditContext.persistCoordinates . |
SelectedAppearance |
getSelectedAppearance()
Appearance that is applied to selected component.
|
java.lang.String |
getSelectedBorder()
Set the CSS border to be applied to the selection outline of the selected components.
|
java.lang.String |
getSelectedLabelBackgroundColor()
The background color for the selection outline label.
|
java.lang.String |
getSelectedTintColor()
Mask color applied to
editMask of selected component when selectedAppearance is "tintMask". |
java.lang.Integer |
getSelectedTintOpacity()
Opacity applied to
editMask of selected component when selectedAppearance is "tintMask". |
java.lang.Boolean |
getSupportsInlineEdit()
Whether this EditProxy has an inline edit behavior, which allows an end user to configure a component by editing a
simple text representation of its configuration.
|
boolean |
isCreated() |
void |
setAllowNestedDrops(java.lang.Boolean allowNestedDrops)
This property acts as a component-specific override for the
EditContext.allowNestedDrops property. |
void |
setAutoMaskChildren(java.lang.Boolean autoMaskChildren)
When child nodes are added to an EditContext, should they be masked by setting
EditNode.useEditMask true if not explicitly set? |
void |
setBringToFrontOnSelect(java.lang.Boolean bringToFrontOnSelect)
Should component be brought to front when selected? Applies when
EditNode.useEditMask :true. |
void |
setCanSelect(java.lang.Boolean canSelect)
Can this component be selected? Selection is allowed unless this property is set to
false . |
void |
setCanSelectChildren(java.lang.Boolean canSelectChildren)
Whether to allow selection of the children of this
EditNode . |
void |
setChildrenSnapResizeToGrid(java.lang.Boolean childrenSnapResizeToGrid)
If not null the
Canvas.childrenSnapResizeToGrid
on the component represented by this EditProxy is set to this value only while in edit mode. |
void |
setChildrenSnapToGrid(java.lang.Boolean childrenSnapToGrid)
If not null the
Canvas.childrenSnapToGrid on the
component represented by this EditProxy is set to this value only while in edit mode. |
void |
setInlineEditEvent(InlineEditEvent inlineEditEvent)
Event that triggers inline editing, showing the
inlineEditForm , which consists of a single text input (single or multi-line according to inlineEditMultiline ) shown in the inlineEditForm AutoChild. |
void |
setInlineEditInstructions(java.lang.String inlineEditInstructions)
Instructions that appear below the text entry area if inline editing is enabled.
|
void |
setInlineEditMultiline(java.lang.Boolean inlineEditMultiline)
Whether inline editing should be single or multi-line.
|
void |
setInlineEditOnDrop(java.lang.Boolean inlineEditOnDrop)
Should the inline editor be shown when new component is first dropped?
|
void |
setInlineEditText(java.lang.String newValue)
Save the new value into the component's state.
|
void |
setJavaScriptObject(com.google.gwt.core.client.JavaScriptObject jsObj) |
void |
setPersistCoordinates(java.lang.Boolean persistCoordinates)
Changes to all child
liveObject 's position and size can be
persisted to their EditNodes based on this attribute setting and EditContext.persistCoordinates . |
void |
setSelectedAppearance(SelectedAppearance selectedAppearance)
Appearance that is applied to selected component.
|
void |
setSelectedBorder(java.lang.String selectedBorder)
Set the CSS border to be applied to the selection outline of the selected components.
|
void |
setSelectedLabelBackgroundColor(java.lang.String selectedLabelBackgroundColor)
The background color for the selection outline label.
|
void |
setSelectedTintColor(java.lang.String selectedTintColor)
Mask color applied to
editMask of selected component when selectedAppearance is "tintMask". |
void |
setSelectedTintOpacity(java.lang.Integer selectedTintOpacity)
Opacity applied to
editMask of selected component when selectedAppearance is "tintMask". |
void |
setSupportsInlineEdit(java.lang.Boolean supportsInlineEdit)
Whether this EditProxy has an inline edit behavior, which allows an end user to configure a component by editing a
simple text representation of its configuration.
|
void |
showSelectedAppearance(boolean show)
This method applies the
selectedAppearance to the
selected component or resets it to the non-selected appearance. |
void |
startInlineEditing()
Manual means of triggering inline editing.
|
void |
startInlineEditing(java.lang.String appendChar)
Manual means of triggering inline editing.
|
applyFactoryProperties, asSGWTComponent, createJsObj, destroy, doAddHandler, doInit, error, error, errorIfNotCreated, fireEvent, getAttribute, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDouble, getAttributeAsElement, getAttributeAsFloat, getAttributeAsInt, getAttributeAsJavaScriptObject, getAttributeAsMap, getAttributeAsString, getAttributeAsStringArray, getClassName, getConfig, getHandlerCount, getID, getRef, getScClassName, getTestInstance, hasAutoAssignedID, internalSetID, internalSetID, isConfigOnly, isFactoryCreated, onBind, onInit, registerID, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setConfig, setConfigOnly, setFactoryCreated, setID, setProperty, setProperty, setProperty, setProperty, setScClassName
public EditProxy()
public EditProxy(com.google.gwt.core.client.JavaScriptObject jsObj)
public static EditProxy getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)
public void setJavaScriptObject(com.google.gwt.core.client.JavaScriptObject jsObj)
setJavaScriptObject
in class BaseClass
public com.google.gwt.core.client.JavaScriptObject create()
public com.google.gwt.core.client.JavaScriptObject getJsObj()
public com.google.gwt.core.client.JavaScriptObject getOrCreateJsObj()
getOrCreateJsObj
in class BaseClass
public void setAllowNestedDrops(java.lang.Boolean allowNestedDrops) throws java.lang.IllegalStateException
EditContext.allowNestedDrops
property. Unless explicitly set
to false, the EditContext.allowNestedDrops
controls
whether a drop can be made into this component.allowNestedDrops
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the underlying component has been createdpublic java.lang.Boolean getAllowNestedDrops()
EditContext.allowNestedDrops
property. Unless explicitly set
to false, the EditContext.allowNestedDrops
controls
whether a drop can be made into this component.public void setAutoMaskChildren(java.lang.Boolean autoMaskChildren) throws java.lang.IllegalStateException
EditNode.useEditMask
true
if not explicitly set?autoMaskChildren
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the underlying component has been createdpublic java.lang.Boolean getAutoMaskChildren()
EditNode.useEditMask
true
if not explicitly set?public void setBringToFrontOnSelect(java.lang.Boolean bringToFrontOnSelect) throws java.lang.IllegalStateException
EditNode.useEditMask
:true.bringToFrontOnSelect
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the underlying component has been createdpublic java.lang.Boolean getBringToFrontOnSelect()
EditNode.useEditMask
:true.public void setCanSelect(java.lang.Boolean canSelect) throws java.lang.IllegalStateException
false
.canSelect
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the underlying component has been createdpublic java.lang.Boolean getCanSelect()
false
.public void setCanSelectChildren(java.lang.Boolean canSelectChildren)
EditNode
. The appearance and
behavior of selected components is controlled by SelectedAppearance
, or centrally
across an EditContext
via EditContext.selectedAppearance
. Individual children can
be marked non-selectable via setting canSelect
to
false
.
Use the EditContext
to access and manipulate the currently
selected set of EditNodes, via APIs such as EditContext.getSelectedEditNode()
, EditContext.selectSingleEditNode()
and EditContext.selectedEditNodesUpdated()
.
If this method is called after the component has been drawn/initialized:
Setter for canSelectChildren
.
canSelectChildren
- the new canSelectChildren. Default value is nullEditContext.setCanSelectEditNodes(java.lang.Boolean)
public java.lang.Boolean getCanSelectChildren()
EditNode
. The appearance and
behavior of selected components is controlled by SelectedAppearance
, or centrally
across an EditContext
via EditContext.selectedAppearance
. Individual children can
be marked non-selectable via setting canSelect
to
false
.
Use the EditContext
to access and manipulate the currently
selected set of EditNodes, via APIs such as EditContext.getSelectedEditNode()
, EditContext.selectSingleEditNode()
and EditContext.selectedEditNodesUpdated()
.
EditContext.getCanSelectEditNodes()
public void setChildrenSnapResizeToGrid(java.lang.Boolean childrenSnapResizeToGrid)
Canvas.childrenSnapResizeToGrid
on the component represented by this EditProxy is set to this value only while in edit mode. This allows
snapResizeToGrid functionality to be enforced during edit mode but not when live.childrenSnapResizeToGrid
- Default value is nullpublic java.lang.Boolean getChildrenSnapResizeToGrid()
Canvas.childrenSnapResizeToGrid
on the component represented by this EditProxy is set to this value only while in edit mode. This allows
snapResizeToGrid functionality to be enforced during edit mode but not when live.public void setChildrenSnapToGrid(java.lang.Boolean childrenSnapToGrid)
Canvas.childrenSnapToGrid
on the
component represented by this EditProxy is set to this value only while in edit mode. This allows snapToGrid
functionality to be enforced during edit mode but not when live.childrenSnapToGrid
- Default value is nullpublic java.lang.Boolean getChildrenSnapToGrid()
Canvas.childrenSnapToGrid
on the
component represented by this EditProxy is set to this value only while in edit mode. This allows snapToGrid
functionality to be enforced during edit mode but not when live.public Canvas getEditMask() throws java.lang.IllegalStateException
EditNode.useEditMask
:true. Common customization properties can be
provided by EditContext.editMaskProperties
.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if the underlying component has not yet been created.public Canvas getHoopSelector() throws java.lang.IllegalStateException
Common customization properties can be provided by
EditContext.hoopSelectorProperties
.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if the underlying component has not yet been created.public void setInlineEditEvent(InlineEditEvent inlineEditEvent) throws java.lang.IllegalStateException
inlineEditForm
, which consists of a single text input (single or multi-line according to inlineEditMultiline
) shown in the inlineEditForm
AutoChild. The initial value in the form comes
from getInlineEditText()
and is applied via setInlineEditText()
.
Many EditProxy
subclasses have built-in modes for inline editing.
inlineEditEvent
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the underlying component has been createdpublic InlineEditEvent getInlineEditEvent()
inlineEditForm
, which consists of a single text input (single or multi-line according to inlineEditMultiline
) shown in the inlineEditForm
AutoChild. The initial value in the form comes
from getInlineEditText()
and is applied via setInlineEditText()
.
Many EditProxy
subclasses have built-in modes for inline editing.
public DynamicForm getInlineEditForm()
Using AutoChildren
for details.
See inlineEditEvent
.
public Label getInlineEditInstructionLabel() throws java.lang.IllegalStateException
inlineEditInstructions
below the text entry area if provided. Defaults to the same styling as the system Hover
.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if the underlying component has not yet been created.public void setInlineEditInstructions(java.lang.String inlineEditInstructions) throws java.lang.IllegalStateException
inlineEditEvent
and inlineEditInstructionLabel
.inlineEditInstructions
- See HTMLString
. Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the underlying component has been createdpublic java.lang.String getInlineEditInstructions()
inlineEditEvent
and inlineEditInstructionLabel
.HTMLString
public void setInlineEditMultiline(java.lang.Boolean inlineEditMultiline) throws java.lang.IllegalStateException
Single-line input appears at the control's top-left corner, multiline covers the control.
inlineEditMultiline
- Default value is falsejava.lang.IllegalStateException
- this property cannot be changed after the underlying component has been createdpublic java.lang.Boolean getInlineEditMultiline()
Single-line input appears at the control's top-left corner, multiline covers the control.
public void setInlineEditOnDrop(java.lang.Boolean inlineEditOnDrop) throws java.lang.IllegalStateException
inlineEditOnDrop
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the underlying component has been createdpublic java.lang.Boolean getInlineEditOnDrop()
public void setPersistCoordinates(java.lang.Boolean persistCoordinates)
liveObject
's position and size can be
persisted to their EditNodes
based on this attribute setting and EditContext.persistCoordinates
. This applies to both
programmatic calls and user interaction (drag reposition or drag resize). The default value of null
allows EditContext.persistCoordinates
to control all
coordinate persistence. An explicit value of false
overrides the EditContext setting so that no children of
the component save coordinates.
All coordinate persisting can be disabled with EditContext.persistCoordinates
. Additionally, all control
of persistence can be deferred to each EditProxy by setting EditContext.persistCoordinates
to null
.
persistCoordinates
- Default value is nullpublic java.lang.Boolean getPersistCoordinates()
liveObject
's position and size can be
persisted to their EditNodes
based on this attribute setting and EditContext.persistCoordinates
. This applies to both
programmatic calls and user interaction (drag reposition or drag resize). The default value of null
allows EditContext.persistCoordinates
to control all
coordinate persistence. An explicit value of false
overrides the EditContext setting so that no children of
the component save coordinates.
All coordinate persisting can be disabled with EditContext.persistCoordinates
. Additionally, all control
of persistence can be deferred to each EditProxy by setting EditContext.persistCoordinates
to null
.
public void setSelectedAppearance(SelectedAppearance selectedAppearance) throws java.lang.IllegalStateException
EditContext.selectedAppearance
. When value is
null
the appearance is determined by:
selectedAppearance
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the underlying component has been createdsetSelectedBorder(java.lang.String)
,
setSelectedTintColor(java.lang.String)
,
setSelectedTintOpacity(java.lang.Integer)
public SelectedAppearance getSelectedAppearance()
EditContext.selectedAppearance
. When value is
null
the appearance is determined by:
getSelectedBorder()
,
getSelectedTintColor()
,
getSelectedTintOpacity()
public void setSelectedBorder(java.lang.String selectedBorder) throws java.lang.IllegalStateException
EditContext.selectedBorder
. This property is used when
selectedAppearance
is outlineMask
or
outlineEdges
.selectedBorder
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the underlying component has been createdpublic java.lang.String getSelectedBorder()
EditContext.selectedBorder
. This property is used when
selectedAppearance
is outlineMask
or
outlineEdges
.public void setSelectedLabelBackgroundColor(java.lang.String selectedLabelBackgroundColor) throws java.lang.IllegalStateException
SelectionOutline
or EditContext.selectedLabelBackgroundColor
.
NOTE: A selected component label is only supported when selectedAppearance
is "outlineEdges".
selectedLabelBackgroundColor
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the underlying component has been createdpublic java.lang.String getSelectedLabelBackgroundColor()
SelectionOutline
or EditContext.selectedLabelBackgroundColor
.
NOTE: A selected component label is only supported when selectedAppearance
is "outlineEdges".
public void setSelectedTintColor(java.lang.String selectedTintColor) throws java.lang.IllegalStateException
editMask
of selected component when selectedAppearance
is "tintMask". Default value is determined
from EditContext.selectedTintColor
.selectedTintColor
- See CSSColor
. Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the underlying component has been createdsetSelectedTintOpacity(java.lang.Integer)
public java.lang.String getSelectedTintColor()
editMask
of selected component when selectedAppearance
is "tintMask". Default value is determined
from EditContext.selectedTintColor
.CSSColor
getSelectedTintOpacity()
public void setSelectedTintOpacity(java.lang.Integer selectedTintOpacity) throws java.lang.IllegalStateException
editMask
of selected component when selectedAppearance
is "tintMask".selectedTintOpacity
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the underlying component has been createdsetSelectedTintColor(java.lang.String)
public java.lang.Integer getSelectedTintOpacity()
editMask
of selected component when selectedAppearance
is "tintMask".getSelectedTintColor()
public void setSupportsInlineEdit(java.lang.Boolean supportsInlineEdit) throws java.lang.IllegalStateException
For example, when inline edit is enabled, a SelectItem
allows editing its valueMap
as a comma-separated string, and a
ListGrid
's columns and data can be edited as several lines of comma-separated
headings and data values.
See inlineEditEvent
for
more details and configuration options.
supportsInlineEdit
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the underlying component has been createdpublic java.lang.Boolean getSupportsInlineEdit()
For example, when inline edit is enabled, a SelectItem
allows editing its valueMap
as a comma-separated string, and a
ListGrid
's columns and data can be edited as several lines of comma-separated
headings and data values.
See inlineEditEvent
for
more details and configuration options.
public void getInlineEditText()
inlineEditForm
to obtain the starting edit value. For a
canvas with isGroup
enabled, the groupTitle
is returned. Otherwise the contents
is returned.
public void setInlineEditText(java.lang.String newValue)
inlineEditForm
to commit the change. For a canvas with
isGroup
enabled, the groupTitle
is updated. Otherwise the contents
is updated.
newValue
- the new component statepublic void showSelectedAppearance(boolean show)
selectedAppearance
to the
selected component or resets it to the non-selected appearance. Override this method to create a custom appearance.show
- true to show component as selected, false otherwisepublic void startInlineEditing()
InlineEditEvent
.public void startInlineEditing(java.lang.String appendChar)
InlineEditEvent
.appendChar
- optional String to append to current value as editing starts