com.smartgwt.client.tools

Class EditProxy

java.lang.Object

com.smartgwt.client.core.BaseClass

com.smartgwt.client.tools.EditProxy

Direct Known Subclasses:

CanvasEditProxy, DrawItemEditProxy, FormItemEditProxy

public class EditProxy
extends BaseClass

An EditProxy is attached to an editable component when editMode is enabled. This proxy has methods and properties which affect the component during editing.

See Also:

DevTools overview and related methods

Field Summary

Fields inherited from class com.smartgwt.client.core.BaseClass

config, factoryCreated, factoryProperties, id, scClassName

Constructor Summary

Constructors

Constructor and Description
EditProxy()
EditProxy(com.google.gwt.core.client.JavaScriptObject jsObj)

Method Summary

Methods

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 allowNestedDrops property.
java.lang.Boolean	getAutoMaskChildren() When child nodes are added to an EditContext, should they be masked by setting useEditMask true if not explicitly set?
java.lang.Boolean	getBringToFrontOnSelect() Should component be brought to front when selected? Applies when 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 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 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 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 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 allowNestedDrops property.
void	setAutoMaskChildren(java.lang.Boolean autoMaskChildren) When child nodes are added to an EditContext, should they be masked by setting useEditMask true if not explicitly set?
void	setBringToFrontOnSelect(java.lang.Boolean bringToFrontOnSelect) Should component be brought to front when selected? Applies when 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 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 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 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.

Methods inherited from class com.smartgwt.client.core.BaseClass

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, 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, setFactoryCreated, setID, setProperty, setProperty, setProperty, setProperty, setScClassName

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EditProxy

public EditProxy()

EditProxy

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

Method Detail

getOrCreateRef

public static EditProxy getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)

setJavaScriptObject

public void setJavaScriptObject(com.google.gwt.core.client.JavaScriptObject jsObj)

Overrides:

setJavaScriptObject in class BaseClass

create

public com.google.gwt.core.client.JavaScriptObject create()

Specified by:

create in class BaseClass

isCreated

public boolean isCreated()

Overrides:

isCreated in class BaseClass

getJsObj

public com.google.gwt.core.client.JavaScriptObject getJsObj()

Overrides:

getJsObj in class BaseClass

getOrCreateJsObj

public com.google.gwt.core.client.JavaScriptObject getOrCreateJsObj()

Overrides:

getOrCreateJsObj in class BaseClass

setAllowNestedDrops

public void setAllowNestedDrops(java.lang.Boolean allowNestedDrops)
                         throws java.lang.IllegalStateException

This property acts as a component-specific override for the allowNestedDrops property. Unless explicitly set to false, the allowNestedDrops controls whether a drop can be made into this component.

Parameters:

allowNestedDrops - Default value is null

Throws:

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

getAllowNestedDrops

public java.lang.Boolean getAllowNestedDrops()

This property acts as a component-specific override for the allowNestedDrops property. Unless explicitly set to false, the allowNestedDrops controls whether a drop can be made into this component.

Returns:

Boolean

setAutoMaskChildren

public void setAutoMaskChildren(java.lang.Boolean autoMaskChildren)
                         throws java.lang.IllegalStateException

When child nodes are added to an EditContext, should they be masked by setting useEditMask true if not explicitly set?

Parameters:

autoMaskChildren - Default value is null

Throws:

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

getAutoMaskChildren

public java.lang.Boolean getAutoMaskChildren()

When child nodes are added to an EditContext, should they be masked by setting useEditMask true if not explicitly set?

Returns:

Boolean

setBringToFrontOnSelect

public void setBringToFrontOnSelect(java.lang.Boolean bringToFrontOnSelect)
                             throws java.lang.IllegalStateException

Should component be brought to front when selected? Applies when useEditMask:true.

Parameters:

bringToFrontOnSelect - Default value is null

Throws:

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

getBringToFrontOnSelect

public java.lang.Boolean getBringToFrontOnSelect()

Should component be brought to front when selected? Applies when useEditMask:true.

Returns:

Boolean

setCanSelect

public void setCanSelect(java.lang.Boolean canSelect)
                  throws java.lang.IllegalStateException

Can this component be selected? Selection is allowed unless this property is set to false.

Parameters:

canSelect - Default value is null

Throws:

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

getCanSelect

public java.lang.Boolean getCanSelect()

Can this component be selected? Selection is allowed unless this property is set to false.

Returns:

Boolean

setCanSelectChildren

public void setCanSelectChildren(java.lang.Boolean canSelectChildren)

Whether to allow selection of the children of this EditNode. The appearance and behavior of selected components is controlled by SelectedAppearance, or centrally across an EditContext via 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.

Parameters:

canSelectChildren - the new canSelectChildren. Default value is false

getCanSelectChildren

public java.lang.Boolean getCanSelectChildren()

Whether to allow selection of the children of this EditNode. The appearance and behavior of selected components is controlled by SelectedAppearance, or centrally across an EditContext via 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().

Returns:

Boolean

setChildrenSnapResizeToGrid

public void setChildrenSnapResizeToGrid(java.lang.Boolean childrenSnapResizeToGrid)

If not null the 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.

Parameters:

childrenSnapResizeToGrid - Default value is null

getChildrenSnapResizeToGrid

public java.lang.Boolean getChildrenSnapResizeToGrid()

If not null the 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.

Returns:

Boolean

setChildrenSnapToGrid

public void setChildrenSnapToGrid(java.lang.Boolean childrenSnapToGrid)

If not null the 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.

Parameters:

childrenSnapToGrid - Default value is null

getChildrenSnapToGrid

public java.lang.Boolean getChildrenSnapToGrid()

If not null the 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.

Returns:

Boolean

getEditMask

public Canvas getEditMask()
                   throws java.lang.IllegalStateException

An editMask is created for any component placed into editMode with useEditMask:true.

Common customization properties can be provided by editMaskProperties.

For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

Canvas

Throws:

java.lang.IllegalStateException - if the underlying component has not yet been created.

getHoopSelector

public Canvas getHoopSelector()
                       throws java.lang.IllegalStateException

Hoop selector canvas used for selecting multiple components.

Common customization properties can be provided by hoopSelectorProperties.

For an overview of how to use and configure AutoChildren, see Using AutoChildren.

Returns:

Canvas

Throws:

java.lang.IllegalStateException - if the underlying component has not yet been created.

setInlineEditEvent

public void setInlineEditEvent(InlineEditEvent inlineEditEvent)
                        throws java.lang.IllegalStateException

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.

The initial value in the form comes from EditProxy.getInlineEditText() and is applied via EditProxy.setInlineEditText().

Many EditProxy subclasses have built-in modes for inline editing.

Parameters:

inlineEditEvent - Default value is null

Throws:

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

getInlineEditEvent

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

The initial value in the form comes from EditProxy.getInlineEditText() and is applied via EditProxy.setInlineEditText().

Many EditProxy subclasses have built-in modes for inline editing.

Returns:

InlineEditEvent

getInlineEditForm

public DynamicForm getInlineEditForm()

Note : This API is non-functional (always returns null) and exists only to make you aware that this MultiAutoChild exists. See Using AutoChildren for details.

See inlineEditEvent.

Returns:

null

getInlineEditInstructionLabel

public Label getInlineEditInstructionLabel()
                                    throws java.lang.IllegalStateException

Label AutoChild used to display 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.

Returns:

Label

Throws:

java.lang.IllegalStateException - if the underlying component has not yet been created.

setInlineEditInstructions

public void setInlineEditInstructions(java.lang.String inlineEditInstructions)
                               throws java.lang.IllegalStateException

Instructions that appear below the text entry area if inline editing is enabled. See inlineEditEvent and inlineEditInstructionLabel.

Parameters:

inlineEditInstructions - See HTMLString . Default value is null

Throws:

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

getInlineEditInstructions

public java.lang.String getInlineEditInstructions()

Instructions that appear below the text entry area if inline editing is enabled. See inlineEditEvent and inlineEditInstructionLabel.

Returns:

See HTMLString

setInlineEditMultiline

public void setInlineEditMultiline(java.lang.Boolean inlineEditMultiline)
                            throws java.lang.IllegalStateException

Whether inline editing should be single or multi-line.

Single-line input appears at the control's top-left corner, multiline covers the control.

Parameters:

inlineEditMultiline - Default value is false

Throws:

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

getInlineEditMultiline

public java.lang.Boolean getInlineEditMultiline()

Whether inline editing should be single or multi-line.

Single-line input appears at the control's top-left corner, multiline covers the control.

Returns:

Boolean

setInlineEditOnDrop

public void setInlineEditOnDrop(java.lang.Boolean inlineEditOnDrop)
                         throws java.lang.IllegalStateException

Should the inline editor be shown when new component is first dropped?

Parameters:

inlineEditOnDrop - Default value is null

Throws:

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

getInlineEditOnDrop

public java.lang.Boolean getInlineEditOnDrop()

Should the inline editor be shown when new component is first dropped?

Returns:

Boolean

setPersistCoordinates

public 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 persistCoordinates. This applies to both programmatic calls and user interaction (drag reposition or drag resize).

The default value of null allows 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 persistCoordinates. Additionally, all control of persistence can be deferred to each EditProxy by setting persistCoordinates to null.

Parameters:

persistCoordinates - Default value is null

getPersistCoordinates

public 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 persistCoordinates. This applies to both programmatic calls and user interaction (drag reposition or drag resize).

The default value of null allows 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 persistCoordinates. Additionally, all control of persistence can be deferred to each EditProxy by setting persistCoordinates to null.

Returns:

Boolean

setSelectedAppearance

public void setSelectedAppearance(SelectedAppearance selectedAppearance)
                           throws java.lang.IllegalStateException

Appearance that is applied to selected component. Default value is determined from selectedAppearance.

When value is null the appearance is determined by:

• If multiple selection is enabled, "tintMask" is used
• Otherwise, "outlineMask" is used

Parameters:

selectedAppearance - Default value is null

Throws:

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

See Also:

setSelectedBorder(java.lang.String), setSelectedTintColor(java.lang.String), setSelectedTintOpacity(java.lang.Integer)

getSelectedAppearance

public SelectedAppearance getSelectedAppearance()

Appearance that is applied to selected component. Default value is determined from selectedAppearance.

When value is null the appearance is determined by:

• If multiple selection is enabled, "tintMask" is used
• Otherwise, "outlineMask" is used

Returns:

SelectedAppearance

See Also:

getSelectedBorder(), getSelectedTintColor(), getSelectedTintOpacity()

setSelectedBorder

public void setSelectedBorder(java.lang.String selectedBorder)
                       throws java.lang.IllegalStateException

Set the CSS border to be applied to the selection outline of the selected components. Default value is determined from selectedBorder. This property is used when selectedAppearance is outlineMask or outlineEdges.

Parameters:

selectedBorder - Default value is null

Throws:

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

getSelectedBorder

public java.lang.String getSelectedBorder()

Set the CSS border to be applied to the selection outline of the selected components. Default value is determined from selectedBorder. This property is used when selectedAppearance is outlineMask or outlineEdges.

Returns:

String

setSelectedLabelBackgroundColor

public void setSelectedLabelBackgroundColor(java.lang.String selectedLabelBackgroundColor)
                                     throws java.lang.IllegalStateException

The background color for the selection outline label. The default is defined on SelectionOutline or selectedLabelBackgroundColor.

NOTE: A selected component label is only supported when selectedAppearance is "outlineEdges".

Parameters:

selectedLabelBackgroundColor - Default value is null

Throws:

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

getSelectedLabelBackgroundColor

public java.lang.String getSelectedLabelBackgroundColor()

The background color for the selection outline label. The default is defined on SelectionOutline or selectedLabelBackgroundColor.

NOTE: A selected component label is only supported when selectedAppearance is "outlineEdges".

Returns:

String

setSelectedTintColor

public void setSelectedTintColor(java.lang.String selectedTintColor)
                          throws java.lang.IllegalStateException

Mask color applied to editMask of selected component when selectedAppearance is "tintMask". Default value is determined from selectedTintColor.

Parameters:

selectedTintColor - See CSSColor . Default value is null

Throws:

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

See Also:

setSelectedTintOpacity(java.lang.Integer)

getSelectedTintColor

public java.lang.String getSelectedTintColor()

Mask color applied to editMask of selected component when selectedAppearance is "tintMask". Default value is determined from selectedTintColor.

Returns:

See CSSColor

See Also:

getSelectedTintOpacity()

setSelectedTintOpacity

public void setSelectedTintOpacity(java.lang.Integer selectedTintOpacity)
                            throws java.lang.IllegalStateException

Opacity applied to editMask of selected component when selectedAppearance is "tintMask".

Parameters:

selectedTintOpacity - Default value is null

Throws:

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

See Also:

setSelectedTintColor(java.lang.String)

getSelectedTintOpacity

public java.lang.Integer getSelectedTintOpacity()

Opacity applied to editMask of selected component when selectedAppearance is "tintMask".

Returns:

Integer

See Also:

getSelectedTintColor()

setSupportsInlineEdit

public void setSupportsInlineEdit(java.lang.Boolean supportsInlineEdit)
                           throws java.lang.IllegalStateException

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.

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.

Parameters:

supportsInlineEdit - Default value is true

Throws:

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

getSupportsInlineEdit

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

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.

Returns:

Boolean

getInlineEditText

public void getInlineEditText()

Returns the text based on the current component state to be edited inline. Called by the inlineEditForm to obtain the starting edit value.

For a canvas with isGroup enabled, the groupTitle is returned. Otherwise the contents is returned.

setInlineEditText

public void setInlineEditText(java.lang.String newValue)

Save the new value into the component's state. Called by the inlineEditForm to commit the change.

For a canvas with isGroup enabled, the groupTitle is updated. Otherwise the contents is updated.

Parameters:

newValue - the new component state

showSelectedAppearance

public void showSelectedAppearance(boolean show)

This method applies the selectedAppearance to the selected component or resets it to the non-selected appearance. Override this method to create a custom appearance.

Parameters:

show - true to show component as selected, false otherwise

startInlineEditing

public void startInlineEditing()

Manual means of triggering inline editing. See InlineEditEvent.

startInlineEditing

public void startInlineEditing(java.lang.String appendChar)

Manual means of triggering inline editing. See InlineEditEvent.

Parameters:

appendChar - optional String to append to current value as editing starts